You are here: Creating Documentation > Topics > Creating Symbol Topics
Creating Symbol Topics
Close
Doc-O-Matic 10
Creating Symbol Topics

There are three ways to describe code in the Editor. You can:

  • Edit existing comments.
  • Create documentation for undocumented symbols.
  • Add comments in another location.
  • You can store your comment in the declaration location, the implementation location or in a DTX file. DTX files are a special kind text file, which Doc-O-Matic uses to save off-source comments to.
  1. In the Content Manager, select the symbol you want to document.
  2. On the Manage tab, in the Topic group, click the QuickDoc button , and then click QuickDoc .
  3. On the Editor tab in the Create Content group, click the Undo button and then click Undo All , to delete your documentation again.
  1. Click Save .
  2. In the Select Topic Location dialog box, select where you want to store your topic (the declaration, the implementation location (only if it is a function or method for which Doc-O-Matic knows the implementation location) or a DTX file).
  1. Select Select Other.
  2. In the Select DTX file dialog box, browse through your directories to the destination where you want to store your DTX file.
  3. Enter a filename.
  1. Select the corresponding symbol.
  2. In the Editor right-click, and then select New Topic Location.
  3. Save your comments either in a DTX file or in another source location (implementation or declaration).
  1. In the Content Manager, select the documented symbol the comment of which you want to edit.
  2. Click Save .
  3. Doc-O-Matic stores comments in the file and the location where it has extracted the comments from.

Click Update All , parse your files, and then edit them. Doc-O-Matic can not write to a file that has been changed (for example using your source editor) and has not been parsed afterwards.

Applies to: Doc-O-Matic Professional

Copyright © 2000-2020 toolsfactory software inc. All rights reserved.