Changes in version 7.00

UDO 7 is a big upgrade since the last released version. Especially the full Unicode support and many HTML output enhancements make this version more powerful than ever.

UDO 7.00 was published on Mar 1, 2010.

Text style

• New commands:

  (!SUP)...(!sup)	output superscript text
  (!SUB)...(!sub)	output subscript text
  (!INS)...(!ins)	output insertion style
  (!DEL)...(!del)	output deleted text style

Languages

• New languages for UDO standard texts:

  !language [czech]	Czech
  !language [danish]	Danish
  !language [polish]	Polish
  !language [swedish]	Swedish

Colors

• The 16 default colors are now available as placeholders in UDO, for the output formats HTML, RTF, WinHelp, DRC, and PostScript. The colors are used like this: (!black), (!red), etc. Usage of color is switched off with (!coloff) accordingly.

Tables

• You can now add comments to table environments.
• Table environments now accept labels.
• UDO universal characters are now properly output in table environments.
• Table cells may now have a maximum of 700 lines height.

Encodings

• UDO now supports 18 1-byte codepages and Unicode (UTF-8). Most important difference to former UDO versions: UDO manages all codepages internally in Unicode format. Thus you will not get too many conversion losses any more.
• Encodings of UDO documents and target formats can now be clearly defined by two new commands, independent from the UDO binary:

  !code_source	defines the source format encoding of the UDO documents.
  !code_target	defines the output format encoding.

• The formerly used UDO command code is no longer available. Please adjust your UDO documents accordingly.
• Some new UDO universal characters have been added to the list, and output to target formats has been enhanced.

Structural

• !docinfo offers more arguments:

  [category]	describes a category the document belongs to.
  [company]	describes the company which has created or owns the document. When you use [company], the title page shows a for [company] line below the author line.
  [distributor]	describes the company which distributes the product or document. When you use [distributor], the title page shows a Distributor: [distributor] line below the author and company lines.
  [translator]	describes the translator's name who localized the product or document. When you use [translator], the title page shows a Translation: [translator] line below the author and company lines.

• The !docinfo options [program] and [programimage] no longer exclude each other, but can be used simultaneously. When you use both options, [program] will be output first.
• Index link in table of contents

  !use_udo_index

  When you use this switch, an Index link will be added to the !tableofcontents section or page.

• Concatenate text lines:

  !\

  If an UDO source document line ends with !\, the following line will be seen as sequel of the current line. You can even let UDO concatenate multiple real! lines to a longer logical line. These sequel lines can be used everywhere in an UDO source document, even in macros and definitions. If !\ is not found at the very end of a line, it will be simply ignored and output like normal text.

  
  Chances are that you want to divide the content of a table cell into multiple lines, in order to get a better readability of the UDO source document.

  Before:

  !begin_table
  This is cell #1 !! !\
  This is cell #2 !! !\
  This is cell #3
  !end_table
  

  ---

  Afterwards:
  

  This is cell #1

  This is cell #2

  This is cell #3

• New commandline parameter:

  --no-warningslines	No output of warnings
  -Wl	Abbreviated form of the above command line parameter.

• New switches:
  

  !use_short_descriptions	Outputs all description environments compressed (which means without additional empty lines between paragraphs).
  !use_short_enumerates	Outputs all enumerate environments compressed (which means without additional empty lines between paragraphs).
  !use_short_itemizes	Outputs all itemize environments compressed (which means without additional empty lines between paragraphs).
  !use_short_lists	Outputs all list environments compressed (which means without additional empty lines between paragraphs).

  
  These four new switches offer to make much more distinctions on environment formatting, compared to the general switch !use_short_envs. But if you use this general switch, the four switches mentioned above are without effect, being subsets of it.
• New command:
  

  (!label)

  Offers to manually create links in any places of the source document.

UDO

• The UDO Community has been added to the text which is output by !use_about_udo.
• The version names of versions have been changed. We no longer name them Release 6.x Patchlevel yy, but simply Version 7.xy.
• The OS/2 version of UDO now registers as UDO for OS/2.

General Bugfixes

• Bugfix #38: Character output should no longer have issues thanks to Unicode support (not only in Mac encodings).
• Bugfix #45/#77: Stack overflow in DOS version of UDO fixed.
• Bugfix #48: Error message unknown command: !html_use_hyphenation. Reason: The command wasn't added to the command list.
• Bugfix #55: Special characters which were used in the second parameter of (!img) or (!KKW [ilink!]), were not recoded properly.
• Bugfix #59: Macros can now use definitions.
• Bugfix #75: !raw output corrected.
• Bugfix #78: Sorting in index page (e.g. indexudo.htm) much enhanced.

HTML Apple Help

• New output format: HTML Apple Help
  Basically this is nothing but HTML, but there are tiny differences. Therefore, !docinfo comes with two new arguments for this format:
  

  [AppleTitle]	defines the (localizable) title of the help book.
  [AppleIcon]	defines the icon which will be shown for this help book in Apple Help Viewer's list of registered help books.

Hypertext Markup Language (HTML)

• Neue Kommandos:

  !html_bgsound	defines the background music for an HTML page.
  !html_robots	Use it to define robots commands for search engines. !html_robots is prior to !docinfo [robots].
  !docinfo [robots]	Use it to define robots commands for search engines. Outputs only when single pages don't use !html_robots.
  !html_frames_toc_title	Defines the TOC frame title in frame layout.
  !html_frames_con_title	Defines the CON frame title in frame layout.
  !html_navigation [line]	This command offers a new way to format the navigation bar. The supported HTML output formats now optionally show a one line navigation bar (starting with or without a folder symbol).
  !html_navigation [image]	Use this additional option with the option mentioned above and define which symbol should be used as folder in front of the navigation bar. We recommend to use e.g. the program icon when you write a program manual.

• New switches:

  !html_header_links	#53: New switch which creates <link> elements in the HTML header — or not.
  !html_header_date <text>	#54: Former versions inserted a comment with the file creation date at the very beginning of each HTML file, e.g. <!- last modified on 29.01.2004 –>. Now a META tag for file creatione date/time will be added to the HTML header, when you use this switch.
  !html_quotes [classic | tags]	#82: Use this new switch to control whether quotation marks should be output like before as " ([classic]), or as HTML quotation tags + ([tags], default).

• New: Index page for HTML, which also offers a quick jump bar (A–Z) to find entries faster in long index lists.
• New: The navigation bar now always has a link to the Index page.
  The link will be output in a span named UDO_nav_index and can e.g. be easily placed right-justified on the page, using CSS commands.
• Feature request #70: The command (!img) has been enhanced.
• <link> elements for navigation are no longer written automatically to the HTML header, but only on request (see above).
• File creation date/time are no longer automatically written as a comment in the HTML file, but only optionally as a META tag in the HTML header (see above).
• !html_ignore_8bit can now handle an optional parameter <text> which sets the charset (codepage) in the HTML header.
• !html_counter_command can now be used in the preamble too. It will then create the relevant output for all files.
• The commands (!B), (!I), (!U), (!T), and (!V) will be output as , , , and , when the HTML doctype >= XHTML_STRICT. If not, the old elements are output.
• The title page area is now enclosed by the following DIV environment:
  
• !use_raw_header and !use_raw_footer define that macros and defines should be used.
• Better HTML formatting and compliance:
  • Attributes (nowrap, noresize) enhanced.
  • #11: (
    ,

    ---

    , , , )
  • #11: XML namespace for XHTML files added.
  • Description environments are properly formatted, even with included links.
  • Lists and tables are output much better and syntactically correct.
  • Anchor names can no longer use unallowed characters in URLs.
• The table which shows the menu in the left column of Modern Layout, now has an ID named UDO_menu. You might e.g. want to hide it via CSS for print output, etc.
• The !docinfo entries [keywords, description] are now also written in HTML output, but only if !html_keywords or !html_description are not used in single files. The latter commands have priority.
• The command !begin_quote can use an argument now.
• The command !html_style_name can use any number of stylesheets.
• Until now the anchor UDOTOC"> was output in front of the table of contents which could be linked to inside of raw environments.
  Now the UDOTOC label will be created whenever a TOC has to be created for HTML. So you can link to UDOTOC from everywhere inside the UDO source document without errors.
• Bugfix #12: No unnecessary spaces behind tags any more.
• Bugfix #44: When !no_numbers is used, no chapter numbers are output in front of the chapter names inside the <link> element of the HTML header.
• Bugfix #58: Wrong UDO version information in HTML meta tags fixed.
• Bugfix #65: Wrong character output in IMG tags fixed.
• Bugfix #83: Anchor URL now only use valid characters for URLs.
• Bugfix #84: Labels in description environments are correctly enclosed in DT tags.
• Bugfix #85: TOC lists are properly formatted.

Rich Text Format (RTF)

• New: New command !rtf_add_colour which write additional colors (other than the 16 default colors) to the color table in the RTF file header.
• New: The !docinfo entries subject, keywords, company, and category are also output as info entries into the RTF file.
• New: All nodes, subnodes, etc. are marked as label/bookmark for RTF output.
• New: The command (!plink) is supported. Output points to the page number.
• New: \*\revtbl {Unknown}{UDO Version x.x.x}} is set.
• New: !use_raw_header can also be used for RTF output.
• Bugfix #56: Wrong image size calculation in RTF output fixed. By mistake the height parameter got the width before.
• Bugfix #17: Error message: couldn't read BMP header of . No such file or directory.
  New state: When the first RTF output didn't find the UDO link image udo_mw.bmp, UDO informs you to output to RTF once more to create all missing files.
  The UDO image will now also be found on TOS compatible platforms.
• Bugfix #60: RTF output should no longer crash.

HTML-Help

• New: Use the command line parameter –map to let UDO create an alias and a MAP file, too.
• New: !html_name is now used in HTML-Help output.

ST-Guide

• Bugfix: Horizontal lines can be longer than 126 characters.

---

Copyright © www.udo-open-source.org (Contact)
Last updated on May 19, 2014

---