1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
<!doctype html public "-//W30//DTD W3 HTML 2.0//EN">
<HTML>
<!-- This file was generated using SDF 2.001 by
Ian Clatworthy (ianc@mincom.com). SDF is freely
available from http://www.mincom.com/mtr/sdf. -->
<HEAD>
<TITLE>SDF 2.001: SDF Release Notes: 2.000beta7b</TITLE>
</HEAD>
<BODY BGCOLOR="ffffff">
<DIV CLASS="header">
<P><IMG SRC="../sdflogo.gif" ALIGN="Right"></P>
<DIV CLASS="navigate">
<P ALIGN="Center"><A HREF="rn_sdf.html">Contents</A> | <A HREF="rn_sdf.html">Parent Topic</A> | <A HREF="2000b7c.html">Previous Topic</A> | <A HREF="2000b7a.html">Next Topic</A> <BR><A HREF="../index.html">Home</A> | <A HREF="../catalog.html">Catalog</A></P>
</DIV>
<BR CLEAR="Right">
</DIV>
<DIV CLASS="main">
<H1>12. 2.000beta7b</H1>
<P ALIGN="Left"><A HREF="#2.000beta7b - Enhancements">Enhancements</A> | <A HREF="#2.000beta7b - Fixes">Fixes</A> | <A HREF="#2.000beta7b - Incompatibilities">Incompatibilities</A></P>
<HR>
<H2><A NAME="2.000beta7b - Enhancements">12.1. Enhancements</A></H2>
<P>The new features in this version are:</P>
<UL>
<A HREF="2000b7b.html#Object catalog formatting">Object catalog formatting</A>
<BR>
<A HREF="2000b7b.html#Subsections support">Subsections support</A>
<BR>
<A HREF="2000b7b.html#Appending text to phrases">Appending text to phrases</A>
<BR>
<A HREF="2000b7b.html#New figure attributes">New figure attributes</A>
<BR>
<A HREF="2000b7b.html#Other 2.000beta7b goodies">Other 2.000beta7b goodies</A></UL>
<P>Details are given below.</P>
<H3><A NAME="Object catalog formatting">12.1.1. Object catalog formatting</A></H3>
<P>The user can now control how a catalog of objects (e.g. a table of references) is presented by setting the <EM>columns</EM> and <EM>compact</EM> parameters. <EM>columns</EM> is a comma-separated list of:</P>
<PRE>
[tag":"]attribute
</PRE>
<P>where:</P>
<UL>
<LI><EM>tag</EM> is a phrase style (or expression format)
<LI><EM>attribute</EM> is the name of an attribute of the class.</UL>
<P><EM>compact</EM> is a boolean flag which reduces the spacing between the rows in the table.</P>
<P>This feature is extremely useful for building "project overview" Web pages. See the SDF document catalog for an example.</P>
<H3><A NAME="Subsections support">12.1.2. Subsections support</A></H3>
<P>The new <A HREF="../ref/msubsect.html">subsections</A> macro can now be used to specify the subsections in a topic. This has several advantages:</P>
<UL>
<LI>subsections can be given a hypertext <EM>id</EM> which contains the current topic name (making them unique)
<LI>for HTML, a "jump line" can be generated.</UL>
<P>For example:</P>
<PRE>
H1: MyApp
!subsections "Purpose,Usage,Description,Examples"
</PRE>
<P>In this case, the <A HREF="../ref/msubsect.html">subsections</A> macro changes the <EM>id</EM> generated for the headings listed to:</P>
<PRE>
MyApp - <EM>heading</EM>
</PRE>
<P>For HTML, it will also generate a line of jumps to the headings.</P>
<H3><A NAME="Appending text to phrases">12.1.3. Appending text to phrases</A></H3>
<P>Event processing on phrases has now been extended to support appending text to a phrase, i.e. prepending text to the rest of the paragraph. Text is appended by setting <EM>$append</EM>. For example:</P>
<PRE>
!on phrase 'PRD';; $append .= '(tm)'
</PRE>
<P><HR WIDTH="80%" ALIGN="Left">
<STRONG>Note: </STRONG>This feature is used to provide "qsd-style" (document name and code) expansion for REF phrases.
<HR WIDTH="80%" ALIGN="Left"></P>
<H3><A NAME="New figure attributes">12.1.4. New figure attributes</A></H3>
<P>The <EM>IMPORT</EM> phrase style and the <A HREF="../ref/mimport.html">import</A> macro now support new attributes:</P>
<UL>
<LI><EM>base</EM> - the prefix to prepend to the figure pathname to get the location needed for the HTML output
<LI><EM>jump</EM> - the URL to jump to
<LI><EM>border</EM> - the border width in pixels.</UL>
<P>These attributes are currently only supported for HTML output.</P>
<H3><A NAME="Other 2.000beta7b goodies">12.1.5. Other 2.000beta7b goodies</A></H3>
<P>The <A HREF="../ref/ftable.html">table</A> filter now supports new attributes:</P>
<UL>
<LI><EM>cellpadding</EM> - the pixels between the cell boundary and contents
<LI><EM>cellspacing</EM> - the pixels between cells.</UL>
<P>These attributes are currently only supported for HTML output.</P>
<P>In topics mode, the default header for the main topic now contains jumps to the next and previous topics.</P>
<P>The <EM>Values</EM> subroutine can now be used to lookup the value of an attribute for an object in a class.</P>
<P><EM>Calculation subroutines</EM> can now be defined for attributes in a class. See <TT>perllib/sdf/values.pl</TT> for examples.</P>
<HR>
<H2><A NAME="2.000beta7b - Fixes">12.2. Fixes</A></H2>
<P>Unzipping SDF 2.000beta7a on MS-DOS caused problems as symbolic links on Un*x were not being unzipped correctly. This should now be fixed - the new distribution does not contain symbolic links for files, just directories.</P>
<P>SECT phrases are now output again in <A HREF="http://www.adobe.com">PostScript</A> documents. (However, there is a still a bug in the cross reference support which caused this problem.)</P>
<P>A number of obscure errors in formatting list items for HTML are now fixed.</P>
<P>Warnings are now produced again for unknown parameters to filters. (This was broken by the performance enhancements added in 2.000beta5, I think.)</P>
<P>An error is now output for tables which have repeated headings. Previously, columns were silently "ignored".</P>
<P>A "noheadings" table with no data rows no longer produces unexpected output.</P>
<P>A number of problems are now fixed in the <EM>mincom/mims</EM> library. In particular, the screen dumps for MSM000A and MSM000B now look as they should.</P>
<HR>
<H2><A NAME="2.000beta7b - Incompatibilities">12.3. Incompatibilities</A></H2>
<P>The <EM>sdf2mimsus</EM> and <EM>sdf2qsdus</EM> aliases have been renamed to <EM>sdf2mimsl</EM> and <EM>sdf2qsdl</EM> respectively.</P>
</DIV>
<DIV CLASS="footer">
<DIV CLASS="navigate">
<P ALIGN="Center"><A HREF="rn_sdf.html">Contents</A> | <A HREF="rn_sdf.html">Parent Topic</A> | <A HREF="2000b7c.html">Previous Topic</A> | <A HREF="2000b7a.html">Next Topic</A> <BR><A HREF="../index.html">Home</A> | <A HREF="../catalog.html">Catalog</A></P>
</DIV>
</DIV>
</BODY>
</HTML>
|
