Doc-O-Matic
 

View screen shots This is an overview of all the major features, also take a look at the feature matrix which compares the 4 editions available. The fact sheet explains general ideas and gives you the big picture.

Trial versions are available for download here. Screen shots are available here. Doc-O-Matic input and output examples are here and here.

 
New in Version 6  
   
  • Project Management: Master projects, ability to store TOC information in external files, more control over command line output and improved command line handling, just to name a few.
  • Editor and Authoring: Snippets, labels with formatting and conditional text features, text variables with automated formatting, CTRL-<SPACE> quick access for inserting labels, variables and snippets and more.
  • Unicode: Doc-O-Matic now works with Unicode internally and supports Unicode source and documentation files, Unicode identifiers as well as on-the-fly conversion of external HTML documentation using any installed code page. Doc-O-Matic is now independent of the current system default locale and can create output in any language without change of locale setup.
  • Source Code: Added PHP support, improved syntax printing with colorized syntax highlighting and much improved multi-language output. Doc-O-Matic now comes with a new Code Translation tool that helps maintaining the syntax translation matrix.
  • Tools: Doc-O-Matic now comes with tools to manage the Code Translation matrix, HxBrowse for browsing the Help 2 namespace registry and tfhxreg for registering Help 2 files, namespaces and plug-ins.
  • Localization: Localizing Doc-O-Matic projects can now be handled from one central place, the localization dictionary. All strings in the project that possibly contain translatable content are run throught the dictionary upon output generation. Also, Doc-O-Matic comes with new localized button artwork for HTML and there is a new tool that helps switching the current language easily.
  • UI: New UI elements like the Ribbon bar help managing the project more quickly.
General Features  
   
  • Native support for C/C++, C#, Delphi, VB.NET, IDL, Java, ASPX, JSP, JavaScript, Matlab and PHP
  • Integrated support for macro expansion, conditional defines, code skipping and more
  • Usage of namespace usage information for symbol resolving and automatic linking
  • Complete language support, no configuration necessary
  • Modules and separate hierarchies for modules
  • Member folders for namespaces and modules
  • Extended method folders, visibility folder
  • Member overview pages
  • Supports Unicode files and Unicode identifiers
Managing Code and Documentation  
   
  • Visual Content Manager and TOC designer
  • Project Manager for source files, image and include paths, modules and output files
  • Project-wide search
  • Project statistics including word count
  • Class hierarchy visualization and design tool
  • Report generation tool
  • QA Manager to visualize the documentation status of your project
  • Quality assurance features to assure that up to-date and accurate documentation is created
Extracting Comments  
   
  • Extracts existing untagged plain text descriptions, formatting without using tags for sections, lists, headings and tables
  • Supports simple HTML formatting in comments
  • Extracts comments from any source files that support comments (for example Assembler, VB6, SQL, Perl, LISP, Ada, Fortran, COBOL)
  • Optional exclusive usage of triple-slash comments (C/C++, C#, Delphi) and triple-quote (VB.NET)
Authoring and Editing  
   
  • Single source authoring Help tool
  • Author conditional text on character, section and topic level
  • Visual table of contents designer
  • Text reuse features such as snippets and text variables
  • Labels to markup and automated formatting on certain text parts (useable for menu paths, inline sections and much more)
  • Integrated topic editor with familiar user interface
  • Complete separation of authoring and output design
Describing Code  
   
  • Fully featured editor
  • QuickDoc work flow management
  • Live spelling
  • Insert tables, images, links, (native and external links to URLs and files) flags, keywords, colors, titles, character and paragraph formatting
  • Inserts plain text format comments in source code or external documentation files
  • Use project databases to easily link to other projects and IDE Help systems (MFC, VCL and .NET)
  • Predefined but customizable documentation sections that enable you to easily create summaries, 'See Also' links, examples, parameter descriptions, return values and example code
  • Describe code in multiple locations
  • Filter to reduce displayed symbols
  • Source code view that optionally displays the whole source file
  • Imports HTML files, plain text files and Word documents
Tools  
   
  • Command line compiler
  • Tools to support team development and project merging (edit templates, import projects and project templates)
  • Tool to move all source comments in an external file
  • Code Translation Tool for managing the syntax translation matrix
  • HxBrowse for examining the Help 2 namespace registry
  • tfhxreg for registering Help 2 files into namespaces, fully supporting Unicode
Common output Format features  
   
  • Add several configurations for each output format
  • Use pre-formatted templates or apply your own formatting to the output
  • Produces linked graphical class hierarchies and diagrams (including derived classes)
  • Adds fully customizable symbol overviews and navigation pages. Optionally include base class members
  • Generates content for folder and member overview pages
  • Creates multi-language syntax
  • Provides full automatic hyper linking in your project, between projects and between projects and MFC, VCL and .NET framework Help
  • Add automatically created cross linked reports from your documentation (all Todo sections, all bugs sections, all deprecated symbols and a glossary)
  • Add additional grouping levels for symbols that are integrated in overview pages automatically
  • Customize all output formats including table of contents, index, headers and footers for each output format
  • Provides translations for all predefined words in the output
  • Author conditional text
PDF  
   
  • Produces PDF files and manuals, without additional tools
  • Table of contents, index, title page and copyright page
  • Page number references to relevant pages for print manuals
  • Link to other PDF documents and URLs
  • Customize page and headline numbering in PDF
  • Double side printing support
  • Chapter tabs
HTML Help Systems  
   
  • Use templates for Visual Studio .NET and Borland Help styles.
  • Context sensitive Help support for C++ and Delphi
  • Provides link database for linking into .NET framework Help, Borland VCL, and MSDN
  • Visual Studio.NET Dynamic Help support
  • Optionally show all sub-topics (for example all class members or all variables) on one HTML page
  • Full customization of the default topic (Welcome Page), add additional files to customize your HTML output
  • Borders
  • Insert additional CSS code for all elements
  • Expandable sections in HTML
  • Automatic anchor generation for all sections and "top" links in HTML
  • Popup support in HTML
  • Include fully formatted HTML files in your Help
  • Fixed header in HTML implemented using DHTML
  • Linked images, big images and hoover images
  • Frame support for browser-based Help and Help 2
  • Dynamic contents page with automatic synchronization with selected topics
Windows Help  
   
  • Borland documentation look and feel
  • Context sensitive Help support for C++ and Delphi.
  • Popups for see also links and class hierarchies
XML Output  
   
  • Customizable section tags
  • Symbol structure