Save Annotated Source Dialogue Box

This dialogue box is displayed when the File | Save Annotated Source menu option is clicked. It is used to specify the required file name, type and formatting information for the routine snippet or category that is to be saved.

The saved code includes comments noting the units and any other snippets from the database that are required by the saved routine(s).

The output file contains the source code of the currently selected routine snippet or category. If a category is selected its contained routines are included in the output file, but any non-routine snippets are ignored.

The dialogue is a standard Windows save dialogue box with a few added options.

You specify the name and folder for the file in the usual way.

Use the Save as type drop down list to specify the type of file to be saved. Options are:

Snippet descriptions can be written as a Pascal comment to the output file. Use the Comment style drop down list to specify the style of commenting to be used. Comments can be inhibited using by selecting the No comments option from the list. If the Truncate comments to 1st paragraph check box is ticked then only the first paragraph of the snippet's description is used. Clearing this check box means that all of the description is used.

The output can be previewed by clicking the Preview button. This displays the source code in a dialogue box, formatted according to your selections. Text in the preview can be selected and copied to the clipboard if required.

Use the Save button to write the file to disk or press Cancel to abort.