DECdocument V3.3 Release Notes Order Number: Version 3.3 February 1999 This document contains release notes for DECdocument Version 3.3. Operating System and Version: OpenVMS Version 5.4 or higher. Alpha OpenVMS Version 6.1 or higher. Future maintenance releases may require higher versions. Software Version: DECdocument Version 3.3 NOTICE The information in this document is subject to change without notice and should not be construed as a commitment by Touch Technologies, Inc. Touch Technologies, Inc. assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. The following are trademarks of Touch Technologies, Inc., and may be used only to describe products of Touch Technologies, Inc.: DYNAMIC TAPE ACCELERATOR INTOUCH 4GL REMOTE DEVICE FACILITY DYNAMIC LOAD BALANCER PLUS INTOUCH REMOTE INTERACTIVE SUPERVISOR The following are trademarks of Digital Equipment Corporation, and may be used only to describe products of Digital Equipment Corporation: DEC DECUS VAXcluster DEC/CMS DECwriter OpenVMS/VMS DEC/MMS DIBOL VT DECnet EduSystem RSX DECsystem-10 IAS UNIBUS DECSYSTEM-20 MASSBUS VAX PostScript is a registered trademark of Adobe Systems Incorporated. ________________________ Revised: February 1999 __________ Copyright ©1995, 1999 Touch Technologies, Inc. __________________________________________________________________ Contents __________________________________________________________________ CHAPTER 1 INTRODUCTION 1-1 __________________________________________________________________ CHAPTER 2 CHANGES AND ENHANCEMENTS 2-1 ____________________________________________________________ 2.1 GRAPHICS EDITOR 2-1 ____________________________________________________________ 2.2 SORTING 2-1 ____________________________________________________________ 2.3 HTML CHANGES AND ENHANCEMENTS 2-1 2.3.1 Additional HTML Options ________________ 2-1 2.3.1.1 CALLOUT NO o 2-2 2.3.1.2 EXTENSION xxx o 2-2 2.3.1.3 CASE IMAGE UPPER/LOWER/MIXED o 2-2 2.3.2 CD-ROM Word ____________________________ 2-2 2.3.3 Preface ________________________________ 2-3 2.3.4 Output Files ___________________________ 2-3 2.3.5 Math Symbols, Tags _____________________ 2-3 2.3.6 Tag Support ____________________________ 2-3 2.3.7 NEWTERM Text ___________________________ 2-3 2.3.8 Converter ______________________________ 2-3 __________________________________________________________________ CHAPTER 3 CORRECTED SOFTWARE PROBLEMS 3-1 ____________________________________________________________ 3.1 TABLE FOOTNOTES 3-1 ____________________________________________________________ 3.2 BOOKWRITER 3-1 ____________________________________________________________ 3.3 INDEX ENTRIES 3-1 ____________________________________________________________ 3.4 POSTSCRIPT OUTPUT 3-1 ____________________________________________________________ 3.5 HTML CORRECTIONS 3-1 iii Contents 3.5.1 Tables _________________________________ 3-2 3.5.2 Part Titles ____________________________ 3-2 3.5.3 Ghostscript ____________________________ 3-2 3.5.4 Format Block ___________________________ 3-2 3.5.5 Copyright ______________________________ 3-2 3.5.6 HOTSPOT ________________________________ 3-3 3.5.7 Figures ________________________________ 3-3 3.5.8 Lists __________________________________ 3-3 3.5.9 Dates __________________________________ 3-3 3.5.10Title Page _____________________________ 3-3 3.5.11Order Number ___________________________ 3-3 3.5.12Book Names _____________________________ 3-4 3.5.13Routine Section ________________________ 3-4 3.5.14References _____________________________ 3-4 3.5.15Math Symbols ___________________________ 3-4 3.5.16Argument Headings ______________________ 3-4 3.5.17EXAMPLE_SEQUENCE _______________________ 3-4 3.5.18SET_TEMPLATE_ROUTINE ___________________ 3-5 3.5.19CALLOUTS _______________________________ 3-5 3.5.20Subhead Commands _______________________ 3-5 3.5.21Lines and Spaces _______________________ 3-5 3.5.22Output Files ___________________________ 3-5 3.5.23MARK/ENDMARK ___________________________ 3-5 3.5.24KEYWORDFONT Tag ________________________ 3-6 __________________________________________________________________ CHAPTER 4 KNOWN PROBLEMS, RESTRICTIONS AND OTHER NOTES 4-1 ____________________________________________________________ 4.1 GLOBAL TAG 4-1 ____________________________________________________________ 4.2 BOOKABORT WHEN BUILDING BOOKREADER OUTPUT 4-1 ____________________________________________________________ 4.3 TAG IN BOOKREADER OUTPUT 4-2 ____________________________________________________________ 4.4 HTML RESTRICTIONS 4-2 ____________________________________________________________ 4.5 GRAPHICS EDITOR 4-3 iv __________________________________________________________________ 1 Introduction These are the release notes for DECdocument Version 3.3. As well as new features, this document describes updates made since the release of DECdocument Version 3.2 which include: o changes and enhancements o software corrections o known problems and workarounds 1-1 __________________________________________________________________ 2 Changes and Enhancements This chapter describes changes and enhancements that have been made to DECdocument Version 3.3. __________________________________________________________________ 2.1 Graphics Editor Added scroll bars to the control panel window for the graphics editor. The scroll bars only appear if the window is shrunk from its normal size. __________________________________________________________________ 2.2 Sorting Changed the index sorting so that 8-bit characters are sorted under the most similar 7-bit character. For example, an umlaut will sort as an "A". __________________________________________________________________ 2.3 HTML Changes and Enhancements ___________________________ 2.3.1 Additional HTML Options Several new HTML options have been added for DECdocument V3.3. The new options are: o CALLOUT NO o EXTENSION xxx o CASE IMAGE UPPER/LOWER/MIXED 2-1 Changes and Enhancements _____________________ 2.3.1.1 CALLOUT NO The new "CALLOUT NO" option in the DOC$HTML_OPTIONS list, allows the user to disable the HTML converter's attempts to build hyper-links from callouts. _____________________ 2.3.1.2 EXTENSION xxx The new "EXTENSION xxx" option in the DOC$HTML_OPTIONS list, allows the user to change the extension of the output HTML file. For example, the following will produce file_name.xyz as the HTML output: DEFINE DOC$HTML_OPTIONS "EXTENSION XYZ" _____________________ 2.3.1.3 CASE IMAGE UPPER/LOWER/MIXED The new "CASE IMAGE UPPER/LOWER/MIXED" option in the DOC$HTML_ OPTIONS list, allows the user to control how image source arguments will be cased in HTML output. The options are UPPER, LOWER, or MIXED. For example: DEFINE DOC$HTML_OPTIONS "CASE IMAGE UPPER" will force the image source file name to be in uppercase. "CASE IMAGE LOWER" forces the image source file name to be lowercase. "CASE IMAGE MIXED" (the default) does not alter the casing. ___________________________ 2.3.2 CD-ROM Word Users have often put two hyphens in the word "CD-ROM" in an SDML file, to get good results in PostScript output. Now, DECdocument also gives good results in the HTML output. 2-2 Changes and Enhancements ___________________________ 2.3.3 Preface Added "Preface" to the table of contents. ___________________________ 2.3.4 Output Files Changed the HTML converter to avoid file splitting within numbered lists, to preserve number sequences. ___________________________ 2.3.5 Math Symbols, Tags Added support for the math symbols and (pi). Added support for the math tag . Since there is no such single character in HTML, DECdocument now produces three small dots aligned at the left margin. ___________________________ 2.3.6 Tag Support Added support for the tag. ___________________________ 2.3.7 NEWTERM Text Changed the text to appear in bold. ___________________________ 2.3.8 Converter Changed the HTML converter to change 8-bit characters to the appropriate HTML symbol for the character. 2-3 __________________________________________________________________ 3 Corrected Software Problems This chapter describes problems that have been corrected in this release of DECdocument. __________________________________________________________________ 3.1 Table Footnotes Corrected a problem with table footnotes where hotspots were not always being resolved. __________________________________________________________________ 3.2 Bookwriter Corrected a "bookwriter" problem where a reference symbol of exactly thirty-two (32) characters would cause the Alpha version to loop forever. __________________________________________________________________ 3.3 Index Entries Corrected a problem where index entries would be dropped if the tag included the master qualifier. __________________________________________________________________ 3.4 PostScript Output Corrected a problem where PostScript output would have bad color comment lines at the end. Symptom: error when printing or converting Offending command COOL __________________________________________________________________ 3.5 HTML Corrections 3-1 Corrected Software Problems ___________________________ 3.5.1 Tables In tables, where the cell is blank, DECdocument now stores " " (a hard space) so that the cell occupies space. Corrected a problem in HTML output when using the command. The TEX written for a table created using is different than if you write the commands. This would cause table data to be off by one cell. Corrected a problem with nested tables. ___________________________ 3.5.2 Part Titles Corrected a problem with "Part" titles where they would begin with a comma. Previous, it would have "Part 2
, title", now it has "Part 2
title". ___________________________ 3.5.3 Ghostscript Changed the *FIGURES.COM file to do a DEFINE/USER GS_LIB DOC$ROOT:[GHOSTSCRIPT] before each conversion attempt. This corrects a problem where multiple copies of Ghostscript would interfere with the conversion. ___________________________ 3.5.4 Format Block Corrected a problem with the unknown command "FORMATPAR" getting created by paragraphs within format blocks. This problem would cause text to be dropped from the HTML output file. ___________________________ 3.5.5 Copyright Corrected a problem where the "owner" in the copyright statement would be dropped from the HTML output file. 3-2 Corrected Software Problems ___________________________ 3.5.6 HOTSPOT Corrected a problem that prevented HOTSPOT from creating an HTML anchor. ___________________________ 3.5.7 Figures Corrected a problem where a
tag would put , , and
tags into the HTML output even though it had not started a table. Corrected a problem resolving logicals in figure file names which occurred when the logical definition included a node name. ___________________________ 3.5.8 Lists Corrected a problem where nested lists would be terminated by the terminator for the last list. Now the proper terminator is used. ___________________________ 3.5.9 Dates Corrected a problem where a in December would display "Decembere". ___________________________ 3.5.10 Title Page CENTER now aligns the order number and the abstract on the title page. ___________________________ 3.5.11 Order Number Corrected a problem where the number "1" was added to the right of the order number. 3-3 Corrected Software Problems ___________________________ 3.5.12 Book Names Corrected a problem with symbolized book lists with references to other books, which caused the book names to be displayed twice in an HTML file. ___________________________ 3.5.13 Routine Section Changed the "Format", "Returns", "Arguments", and "Description" headings in the routine section, to all be

with initial caps. Some had been full caps and some

. ___________________________ 3.5.14 References Changed HTML references to work with some older Browsers which had previously been a problem. ___________________________ 3.5.15 Math Symbols Corrected a problem with the conversion of the math symbols and . ___________________________ 3.5.16 Argument Headings Corrected a problem when the tag was used to set up an argument list. The HTML output would contain two extraneous headings (Access: and Mechanism:). These two headings were removed. ___________________________ 3.5.17 EXAMPLE_SEQUENCE Corrected a problem with producing an extra set of , , and HTML commands. 3-4 Corrected Software Problems ___________________________ 3.5.18 SET_TEMPLATE_ROUTINE Corrected a problem where the tag caused a mismatched set of
HTML tags to be generated. This would cause the HTML output to creep right in the Browser window. ___________________________ 3.5.19 CALLOUTS Corrected a CALLOUT problem which had caused callouts at the end of a file to refer to callouts at the start of the next file with the wrong file name. ___________________________ 3.5.20 Subhead Commands Corrected a problem where subhead commands would not properly store the tag as the anchor name. ___________________________ 3.5.21 Lines and Spaces Corrected a problem where lines that had no spaces, but were longer than 72 characters would wrap and break up HTML tags. ___________________________ 3.5.22 Output Files Corrected a problem with the /OUTPUT qualifier, so that the HTML output file name will take the extension provided by the /OUTPUT qualifier. Previously, it would ignore the extension and force it to ".HTML". ___________________________ 3.5.23 MARK/ENDMARK Corrected a problem in HTML output where / within a table would not change the font color for all cells marked. Now, all cells marked have their font color changed (if using colors). 3-5 Corrected Software Problems ___________________________ 3.5.24 KEYWORDFONT Tag Corrected a problem in the tag handling. It was grabbing the next token as the keyword, and not evaluating it as another possible command. 3-6 __________________________________________________________________ 4 Known Problems, Restrictions and Other Notes This chapter describes problems and restrictions relating to DECdocument V3.3, and includes workarounds where appropriate. It also contains other information, such as documentation errors and omissions and restrictions retained from prior versions, that are not discussed in the preceding chapters. __________________________________________________________________ 4.1 Global Tag The tag does not work properly when using the MILSPEC document type. If the tag is used, you will received the following error: Tag invalid unless preceded by an example tag This problem with the tag will be corrected in a later release of DECdocument. __________________________________________________________________ 4.2 BOOKABORT When Building BOOKREADER Output DECdocument will fail during the creation of BOOKREADER output if the .DECW$BOOK file must be purged. The error messages you will see are: %RMS-S-FILEPURGED, oldest file version purged %DVC-E-BOOKABORT, aborting run-book XXX.DECW$BOOK not created -DVC-I-INPUTFILE, input file is: XXX.DVI_BOOKREADER To avoid this problem, purge the output files prior to documenting your bookreader files. This problem will be corrected in a later release of DECdocument. 4-1 Known Problems, Restrictions and Other Notes __________________________________________________________________ 4.3 Tag in BOOKREADER Output If you are creating BOOKREADER output and you use a (...) tag followed by a

tag, the

tag is ignored and has no effect. This problem only occurs for BOOKREADER output. The following is a workaround: (...)

. . __________________________________________________________________ 4.4 HTML Restrictions The following HTML restrictions apply at this time: o The only supported design type is SOFTWARE.REFERENCE or designs based on SOFTWARE.REFERENCE (e.g. GENERAL). Other designs might work, but there could be tags that have not been implemented. o Most MATH tags have not been implemented because HTML does not have the concept of MATH at this time. o In this version, HTML output in languages other than English is supported. However, there are some HTML specific terms that are not yet being translated. These terms are: - first page - next page - previous page - contents - master alphabetic index 4-2 Known Problems, Restrictions and Other Notes __________________________________________________________________ 4.5 Graphics Editor The DECdocument Graphics Editor scales images to the DPI of the graphics display device that is used to render the image. If the image is to be displayed upon another device, it is recommended that the image be rendered on a 95 - 100 DPI graphics display device. Using a device with a lower DPI can cause display problems on higher DPI devices. Note regarding Graphics Editor Starting with DECdocument V3.1, the DECdocument Graphics Editor requires DECwindows/Motif V1.1 or higher. 4-3