The Cascade Historian manual is a bit unusual in that most of the commands found in the reference are wrapped as API C functions, and are documented in the Cogent API manual. The syntax of the commands is different from that of the functions, but their descriptions are in most cases identical. So, we put most of the descriptions into files in doc/i/historian/descriptions/*, and included them as entities in both the Cascade Historian manual and the Cogent API manual reference pages.

However, there is a slight irregularity here, because we wanted to start each command with the words "This command...", whereas each function description should start "This function ...". To allow for this, the entity starts in the middle of a paragraph. This means that the opening <para> tag is in the reference page file, but the closing </para> tag is in the description file.

So, you'll have to be more careful editing, because Emacs PSGML won't parse the description correctly. If you plan to do a fair amount of editing, I suggest putting a <para> tag at the beginning, and then removing it when you're done.