Doc-O-Matic [5]

• Doc-O-Matic [5 for Java, Single User Desktop Licence Win32]
  
  
• Doc-O-Matic [5 for Java, Single User Desktop Licence, Upgrade from v4 Win32]
  
  
• Doc-O-Matic [5 for Java, 2-User Desktop Licence Win32]
  
  
• Doc-O-Matic [5 for Java, 2-User Desktop Licence, Upgrade from v4 Win32]
  
  
• Doc-O-Matic [5 for Java, 3-8 User Desktop Licence, price per user Win32]
  
  
• Doc-O-Matic [5 for Java, 3-8 User Desktop Licence, Upgrade from v4, price per user Win32]
  
  
• Doc-O-Matic [5 for Java, 9+ User Desktop Licence, price per user Win32]
  
  
• Doc-O-Matic [5 for Java, 9+ User Desktop Licence, Upgrade from v4, price per user Win32]
  
  

• New QuickDoc(tm) feature which tremendously speeds up the creation of content by automatically applying intelligent rules when creating new documentation and saving topics.
• When creating new topics using QuickDoc, you can use predefined, customizable templates.
• When saving new topics using QuickDoc, you can apply rules for saving location, file and directory naming.
• All QuickDoc settings are customizable on a symbol/topic-type basis, so you can have different settings for classes, fields, methods, namespaces and of course generic topics.
• Template Adjustment: When applying a template to a symbol, Doc-O-Matic now adjusts the template used so that it matches the topic/symbol. For example this will cause the parameter table of a template used to create function documentation to contain the correct number of parameters and parameter names. This logic also applies to return value lists and return sections.

AutoDoc
Doc-O-Matic AutoDoc(tm) combines all features that support documentation creation by automating tasks. Doc-O-Matic AutoDoc(tm) tasks run fully automated and do not require any user interaction while still being fully customizable. Doc-O-Matic AutoDoc(tm) features include:

• TOC folder grouping
• Member overview page generation
• Index generation
• Navigation table generation
• Multi-Language syntax generation
• Graphical and textual class hierarchy generation
• Autolinking
• Automatic inter-project linking
• Export criteria based on documentation status
• Automated reports
• Automated index generation for Dynamic Help and context sensitive help features in Visual Studio 2005, Visual Studio 2003, Visual Studio, Borland Developer Studio, Visual C, Delphi 2005 and many more IDEs.

Module Management Improvements

• Modules now can contain directories and file extension definitions as well as individual files. This simplifies the file assignment for modules as you can add all files of a certain type contained in a certain directory recursively.

Instant Folder Configuration

• Namespace-, Module- and Class member level folders are now managed directly in the Content Manager.
• Changes are applied instantly and a don't require a reparse of the project.
• Now supports the user with features that allow to manually sort parts of the hierarchy of a certain topic by topic title, filename or code position (available from the context menu).
• Operators will now always be categorized as operators both for member folders and for navigation tables, regardless of whether or not extended member types are activated.
• Option to show constructors and destructors on the main level below the class topic.

Performance Improvements

• The Editor now instantly updates the project structure avoiding time-costly file parsing and project updates. This makes the saving process a click of a button, no more long waits in big projects.

New Filter

• Filtering in the Content Manager and the QA View now uses a much more powerful filtering mechanism very similar to the report criteria. The filter in the Pick-Topic dialog now uses simple, straight-forward text filtering. Filters are persistent across sessions and automatically synchronized between Content Manager and the QA View.
• Filters can now be applied with an option to preserve the hierarchy displayed. Preserve Hierarchy is turned on, all parent topics of matching topics will be displayed even if they don't match the criteria. This results in a much clearer filter output as the symbols and topics are not taken out of their natural context.

New Filter criteria:

• Topic Name: matches if a topic ID or Title contains a given text.
• Hierarchy: matches if a topic is a direct or indirect sub-topic of the topic with a given ID. This can be used to view or hide a certain part of the topic hierarchy, such as a certain module.
• Filename: matches if a symbol's or topic's filename matches the filename given.

Create Hierarchy Filter: The Filter tool now has a new command that creates a hierarchical filter based on the current selection in the view (Content Manager/QA).

Topic Templates

• When creating new topics, any topic in the project can now act as template for the new topic. This makes topic cloning very easy and is used by the QuickDoc setup to create new topics as well.
• Template Adjustment: When applying a template to a symbol, Doc-O-Matic now adjusts the template used so that it matches the topic/symbol. For example this will cause the parameter table of a template used to create function documentation to contain the correct number of parameters and parameter names. This logic also applies to return value lists and return sections. This feature is available through QuickDoc too.

New Editor Features

• Doc-O-Matic now shrinks oversized images to when displayed in the Editor so that the entire image is visible plus some surrounding text. This behaviour can be switched off in the Editor options.
• Images can now be pasted directly from the clipboard. Doc-O-Matic saves pasted images to the image path in the project.
• New editor command "Edit->Open Image in Editor" which opens an image with an external image editor (whichever is registered in the system).
• "Trimmed Lines": similar to "Ignored Lines" with the only difference that they are not preserved by the editor. New editor option that allows you to insert a trim line as a separate before section headings. If enabled Doc-O-Matic will use the first trimmed line in the setup.
• Doc-O-Matic now support triple-quote comments for Visual Basic .NET as comment characters when writing comments to source.
• Doc-O-Matic now stores the topic title in project database links and shows the titles in the Pick Topic ID dialog which makes it easier to locate project database topics and makes it possible to search for them by title.

Member Overview Pages
Doc-O-Matic now optionally generates class-level member overview pages.
Contents such as navigation tables, links and default text is automatically created for member overview pages

Automatic Content for Symbol Folders

• Doc-O-Matic now automatically creates content for AutoDoc member folders.
• Overloaded folders now have content and a page even if there is no documentation for them available.
• New overloaded list style. Added option for to have Doc-O-Matic generate the old list style.

New Reports View Features

• New option for printing a report header. This can be switched for each report individually.
• New option for using value description names as automatic aliases. This feature can be used to create a completely glossary section.
• New print options to print parameter list, return value list and generic value description list sections. This feature can be used to create a list of all exceptions fired by all functions in the project or a certain part of it.

General Output Features

• All configurations can now overwrite the project information properties (title, summary, author, author email, copyright and keywords). If a property is left empty, the corresponding project settings property is used which is the default behaviour.
• New navigation table option "Visual Studio 2005 style": Uses "Name" in header and puts indicator images into and extra leftmost table column.
• Code blocks in generic topics can now be syntax highlighted. The highlighter used to syntax highlight the block is determined by a new option in the AutoDoc syntax highlight settings.
• Flags can now be used as indicator images. A new property has been added to the flags options which allows you to turn this feature for each flag separately. A flag will only be used as indicator if is has an image associated.
• New overloaded list style. Added option for to have Doc-O-Matic generate the old list style.
• The class hierarchy output path is now the first look in for image files. This ensures Doc-O-Matic uses the latest version of the class hierarchy files even if duplicate older images exist in other folders.
• New option for creating class-level navigation tables. This is off by default since the member overview page serves this purpose (Navigation Section Options).
• New navigation page options for creation of links to member overview pages and member type folders from class pages as well as links from member pages to their class, class member overview and namespace pages.
• "Struct" as category name has been replaced by "Structure".
• The declaration source code for enums in Pascal will now be in hanging style like for all other languages.
• A new option has been added for project databases which adds additional entries for enum values.
• The derived class hierarchy in the local class hierarchy diagram (both graphic and text versions) now includes classes even if they were declared in namespaces other than the class they are derived from.
• Navigation Text Limit: The text copied to navigation tables can now be limited to a certain number of words. This helps keeping tables clear. Additional options allow the settings of the ellipsis used to cut-off text and the text used to create a link to the topic (by default "... more").
• Added option for namespace export default (like for all other symbol types).
• The section option "Replace link text with target title" now works with automatic links to database targets.
• Inherited property type recognition now works with the class information in the used project databases. The main purpose for this is that inherited properties that are really events can now be classified correctly.
• New indicators and indicator arts for class types and method types, symbol types, visibilities and modifiers.
• Doc-O-Matic now autolinks the left columns of value lists and return value lists, such as Exception section tables.
• It's now possible to independently configure title link list and the links printed inline, with respect to both order and visibility (Navigation Links configuration page).
• When Doc-O-Matic now resets the attributes for copied image files which removes the read-only attribute. More precisely, Doc-O-Matic sets the archive attribute.
• AutoDoc topics (member overview, overloaded folders, member folders) can now have different index and TOC titles as available for symbols.
• The text class hierarchy now prints the entire known class path including classes in project databases.
• The derived class hierarchy in the local class hierarchy diagram (both graphic and text versions) now includes classes even if they were declared in namespaces other than the class they are derived from.
• The new special topic "!!COPYRIGHT_FOOTER" is now used as provider for custom footer text. The first section in that topic will be used.

HTML Output Features
HTML: New section output option for adding anchor links to the header links. If turned on, a link will be added which points to the anchor of the corresponding section on that page.
Sections now have an image output option that allows to print an image in the section headline or floating as first item in the section's text. Using this feature you can:

• Add an image to all section headings for a specific section
• Replace the heading by an image
• Add a floating image to the section text

• Doc-O-Matic now correctly locates the Help 2 viewer installed by Visual Studio 2005.
• New Context Index options for Help 2 output which now makes it possible separate the index you can search in from the index used by Microsoft Visual Studio and Borland Developer Studio to locate context sensitive help entries. As a side-effect this greatly reduces the number of index entries necessary in print output and changes the default index option for new projects by de-selecting a number of items.
• Added a new mode for the HTML contents page, Table Mode. This is a less technical mode that display the first 2 levels of the TOC in a table style with headlines and lists of links. This mode is more suitable for authoring projects than the tree mode.
• New HTML Help option whether or not to save a window position (applies to HTML Help generated with specific window positions).
• New option to create a "Top" link after each section that has an anchor in the topic header. Includes configurable text and a new formatting element ("Top Link") to change its appearance.
• The "Show All" feature for expandable sections is replaced by a "Collapse All"/"Expand All" mechanism and now shows a corresponding image.
• Added option for multi-column index printing, by default set to 2 columns. This option is deactivated for frames-based output.
• New "Home" global link for that adds a link to the welcome page.
• Automatic hovering images. If an image comes with a hover version - by default with a "_hover" filename suffix - the image will switch to the hover version when the mouse enters the image and back when the mouse leaves.
• HTML generation now is over 30% faster.
• HTML: Completely new default formatting which matches the VS2005 formatting.

Enhanced Web Help

• New rendering of the contents page's TOC tree with new formatting elements for hover and link effects.
• The TOC now auto-synchronizes with the topic being displayed when creating the framed output.
• Added optional dynamic index search for Web Help.

PDF Output Features

• Sections now have an image output option that allows to print an image in the section headline or floating as first item in the section's text.
• The copyright page now prints all sections in the !!COPYRIGHT topic, including headings and using the formatting elements used for all other topics.
• The root bookmark entry is now linked to the title page of the document.
• PDF now supports "Chapter Tabs" which are visual markers along the right margin
• Greatly improved performance. The PDF generation now takes (depending on project size) about 1/2 to 1/10th of the time of previous versions. The bigger the project the bigger the improvement.
• Greatly reduced the memory usage during output generation especially when using high resolution images.
• For clarity the PDF output now uses only the project's title and summary or the configuration's title and summary for its welcome page. The welcome page is no longer used.

XML Output Features

• XML: XML now supports an additional symbol structure generation. The symbol structure is a separate tree in the XML document which contains a hierarchical symbol tree of namespaces, classes, members and so on. Much formal information about those symbols, like for example class ancestors is available. This information can be used more conveniently parse able than the topic structure as it does not contain topic content and is strictly based on the source symbols, not the TOC.
• XML: Topic structure generation and symbol structure generation can be switched off optionally and individually.

New QA Features

• The QA view now displays the full topic hierarchy including non symbol topics. This makes the QA view a very fast tool to navigate through the project, both for source code documentation and authoring. The new filter mechanism is an intelligent and easy-to-use navigation aid in that it enables you to only view things of interest.
• New UNFINISHED topic property and tag. The is used to set the documentation status of a documented topic to "unfinished", indicating that there is work to be done on the topic. Also, a new export option is available that allows for exclusion of unfinished topics automatically.

Namespace Using

• Doc-O-Matic now uses namespace usage directives such as C++ "using namespace", C# "using", Delphi "uses", Java and VB.NET "Imports". This information is used for class hierarchy generation, symbol resolving and autolinking. No more tricks are necessary to get Doc-O-Matic on the right path with respect to class inheritance, no more fully-qualified identifiers are necessary in order to make this work correctly.
• New option for "inherited documentation" that allows to extend the search for inherited description to all used namespaces. This can result in a significant increase in processing time.

Functions without Prototypes

• New C/C++ parser option for pick up of function without prototype.

Project Statistics

• New Tool "Project Statistics" which counts words in the entire project and shows simple stats.

XML Compatible Property and Formatting Tags

• Doc-O-Matic now optionally generates tags that are XML compatible.

Other New Features

• Doc-O-Matic now support triple-quote comments for Visual Basic .NET as comment characters when writing comments to source.
• New option to control whether or not source code located comments are used. If that option is de-selected the Editor will not save to source code based locations either.
• New option to ignore all but triple-slash comments (applies to C/C++ and C# source only).
• Doc-O-Matic now supports numeric character references and constant character references (for example "²" or "&"). Due to the changes necessary to support this kind of escape characters, there is a very small chance of compatibility issue: If a DTX file or comment contains a literal character sequence that "looks" like a character reference, it will be treated as character reference, even though it's likely that is not what was intended. To avoid such problems ampersand character in any part of the text or within tags should be escaped using "&".
• Doc-O-Matic now disables heading and list processing in code and preformatted blocks when parsing the text automatically.
• Code tags can now optionally set the code language using the: language attribute <code lang="LANGNAME">. This will make Doc-O-Matic use the highlighter for the specified language. If a language attribute is used, automatic syntax highlighting will take place regardless of whether or not the auto option is switched on. You can also explicitly specify "text" as language which disables the highlighter for that code block. See documentation for possible other language names.
• New "Find Topic..." feature that helps locating topics.
• All configurations are now accessible in the Settings View via tabs, the current configuration does no longer have to be changed in order to change other configurations' settings.
• A new UI helper has been added that makes Doc-O-Matic synchronize the current configuration with the configuration being edited settings view.
• Message View messages can now be filtered individually
• Message View now shows tabs on global searches, messages can now be selected individually and copied to the clipboard. Shortcuts can be assigned in application options.
• A new startup dialog replaces the Info View which has been removed to support the streamlined UI of v5.
• When importing a project via "Tools->Import Project" individual configurations can be selected for import, instead of always importing all configurations in the project.
• New Project Upgrade wizard that helps upgrading projects in a simple, step-by-step manner. As an option the output formatting elements of all configurations can now be reset when loading older projects.
• The New Project Wizard now creates project-specific output folders for output files and images. There is also a new option to create a copy of the template file and add it to the project.
• Doc-O-Matic will now show a warning dialog if files have been modified outside the IDE. This can be turned off via the application options.
• The global text find tool now has an option to search text in links. This is handy if you change topic IDs and want to locate all links that are affected.
• Doc-O-Matic now optionally shows a warning dialog if a topics is defined more than once. The warning includes topic id and file names of all files a topic is defined in, it can be enabled in the application options dialog on the Miscellaneous page.
• Excluded files can now be defined via folders and file masks which allows you to recursively exclude certain files in a folder hierarchy.
• The output directory and output filename for PDF and XML output is now set up independently. This allows for using automatic project-based filename assignment while using different output directories. This is especially useful when creating a project template.
• All configurations can now overwrite the project information properties (title, summary, author, author email, copyright and keywords). If a property is left empty, the corresponding project settings property is used which is the default behaviour.
• New tool for resetting configuration settings for both AutoDoc and Files & Format parts. Doc-O-Matic will load the template setup if the project was created from a template project and the configuration name didn't change.
• HTML: Split the formatting elements used for contents and index page into two separate elements.
• HTML: Neighbor topics (previous/next links) now operate hierarchically, not just on the current level. Next will take you to the next topic down the hierarchy, so it can be used to browse the entire content.
• HTML: Doc-O-Matic now saves only those navigation page files that are actually used. Up until now all navigation pages where saved regardless of whether a link to it has been created. The new behaviour can reduce the number of files created considerably if not all available navigation links are used.
• HTML Import: Improved import for html tables that have header rows. Also improved importing of tables that do not have ending row tags.
• HTML: Added disabled image support for up, next and previous links when using images for neighbor links.
• HTML: Global and neighbor links can now be reordered conveniently.
• DMCC now supports a new command line option for building a named configuration: dmcc -config "" project.dox.

Miscellaneous Enhancements and Minor Changes

• Doc-O-Matic now correctly handles parameter list item text that starts with a bullet or numbered list only.
• Pressing Enter when the cursor is on the beginning of a section headline or headline will now insert a new line before the section headline or headline.
• Moved most Editor options into the application options dialog.
• The Editor can now be used in Contents Design mode as long as only one topic is selected.
• The Insert Variable dialog now shows dynamic symbol variables, such as SYMBOLNAME, CLASSNAME or PARx if available for the current topic. Also the Insert Variable dialog now is assigned Shift+Ctrl+V as default shortcut.
• The check for new files when selecting a topic file to store a new topic to now correctly handles files that have been included via directories and wildcards.
• Doc-O-Matic now applies dynamic outenting to code and pre blocks.
• New editor option that inserts comments using walls only if the comment is longer than a certain number of lines.
• The editor now more closely follows the maximum line length when writing tables, parameter-, return value- and value description lists.
• New editor option that allows to turn on or off insertion of the space between parameter or value name and the delimiter in parameter lists, return value lists and value description lists.
• The Image pick dialog now has a feature to open the selected path in the editor.
• The Symbol/Topics view is now named Content Manager and comes with a number of improvements that ease documentation management.
• The Content Manager is now in TOC Design mode initially. The TOC Design mode is now persistent across Doc-O-Matic sessions and topics can now be edited in TOC mode as well.
• New "Select Full Row" option for the Content Manager available in the application options dialog which makes the select appear across the entire width of the view.
• New "Colorize odd Rows" option to colorize every other row in the tree for easier readability.
• New: The QA View colors can now be changed in the application options dialog.
• The QA view now supports the "Copy Topic ID to Clipboard" command.
• The QA view's current section can now be changed using the ESC key which will select the current item's parent item (if available).
• New Topic Command: New topics can now be created in the QA View using the "New Topic" command. Also, QuickDoc settings are now available from the context menu.
• Moved Symbols/Topics View options into the application options dialog.
• The directory selection dialog used in various different places throughout the application now uses a explorer-like user interface.
• The application shortcut setup has been moved from the application options into its own dialog accessible via the main menu at "Tools->Keyboard Shortcuts".
• The progress information popup window has been replaced by a progress bar in the application's status bar.
• Progress when loading and saving projects.
• Doc-O-Matic now shows a warning dialog if the HTML or Help 2 Help compiler could not be executed or there was no help compiler available. The error message appears in addition to log message.
• Doc-O-Matic now correctly locates the Help 2 viewer installed by Visual Studio 2005.
• The class hierarchy output path is now the first look in for image files. This ensures Doc-O-Matic uses the latest version of the class hierarchy files even if duplicate older images exist in other folders.
• The AutoDoc options tree has been restructured for a clearer grouping of options in that area.
• The section output configuration has been streamlined, all options are now available from the section output options dialog, including heading and image options.
• New supporting additional art: New flag indicators for "new" "depreciated", "beta version", "preliminary" and "CFW" as well as stars in 9 different colors. New link image for PDF output.

• Windows XP
• Windows 2000
• Windows ME
• Windows NT 4.0
• Windows 98

Direct support for the following IDE's

• Microsoft Visual Studio C++ 2002/2003/2005 .NET
• Microsoft Visual Studio C# 2002/2003/2005 .NET
• Microsoft Visual Studio .NET
• Microsoft Visual Studio 4.0 - 6.0
• Microsoft Visual Studio 97
• Microsoft Visual Basic .NET
• Borland C++ 5.0
• Borland C++
• Borland C++Builder 3 - 6
• Borland Delphi 1.0 - 8.0, Delphi 2005
• Borland JBuilder