Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog
Enhancements | Fixes | Incompatibilities
The enhancements are:
Further details are provided below.
Following readability feedback:
The table filter now supports the wrap attribute which puts multiple physical records into a single row. The wrap attribute is also supported by class filters.
This feature is useful for producing online HTML indexes.
If a filter matches the name of a programming language, the text is formatted as an example in that language, e.g.
!block C int i; !endblock
is now implicitly:
!block example; lang='C' int i; !endblock
If a filter is not found, SDF now looks for a file called filter_name.sdp and dynamically loads the filter from that file if it can. See the stdlib/module.sdp file for an example.
Variables can now be accessed in the where attribute of the table filter and class filters. For example:
!define MODULE_CODE "XYZ" ... !include "../document.reg"; references; compact; \ where='$o{"Reference"} =~ /$var{"MODULE_CODE"}/'; \ columns="PS,REF:Reference,DOC:Document,CONCISE:Date"
If a reference attribute is all uppercase (e.g. TXT), a clickable image for a file with that (lowercase) extension (e.g. mydoc.txt) is generated, using an image matching the extension name (e.g. txt.gif). Likewise, an all uppercase attribute with a leading underscore (e.g. _DIR) generates an image for a HTML file with that suffix (e.g. mydoc_dir.html) using an image matching the extension name (e.g. dir.gif).
This feature has been added so that SDF doesn't need to be extended every time a new file type needs to be included in a document catalog.
The following images have been added to the images library:
File | Comments |
dir.gif | for _dir.html files (see below) |
htx.gif | for MIMS .htx files |
mf6.gif | for MIMS F6 help files |
Calculation functions can now be defined for a class. (Previously, calculation functions were only supported for an attribute-class combination.)
This feature is used to support arbitary file extensions for the references class (see above).
As large documents often contain lots of topics, SDF now provides an option for generating a HTML file which displays the topic directory tree for a document.
The command is:
sdf -2_dir mydoc
This creates a file called mydoc_dir.html. A web browser can then be used to view the topic hierarchy and view the SDF files used to build a document.
The new catalog macro can be used to build a catalog of loaded objects. Filtering is provided on the name making it easy to produce online HTML indexes.
The following output formats are now supported:
SDF now supports a generalised mechanism for producing a report on an SDF file. See the stdlib/sdf_dir.sdr report file for an example.
This feature is used to support the -2_dir option (see above).
The word wrapping algorithm used by txt format has been fixed so that really long words (e.g. URLs) that don't fit on any line no longer wrap onto the next line unless doing so is better that leaving the word on the current line.
Formatting of title blocks for txt format is better.
The label attribute now works for headings in txt format.
The objects attribute for the table filter has been added back in as an alias for the coltags attribute.
The changes to list formatting mean that documents with lists will be formatted differently, e.g. a given document might have page breaks in different places.
The SDF logo images are now named sdflogo.gif and sdflogo.bmp, rather than sdf.gif and sdf.bmp.
Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog