Administration > Formatting
Formatting using Startup Commands
Arbortext Editor formats files by applying the specifications defined in the FOSI to the markup in a document file to produce output stored in a .dvi file in your .aptcache directory.
You can start Arbortext Editor with –c "format"filename option using any of these formatting options:
allpasses — do as many formatting passes as necessary to resolve all page numbering and other formatting issues that may require more than one traversal of the document. In general, documents with involved page numbering schemes or that contain indexes with multiple page numbers may require more than one formatting pass to resolve all issues.
allpasses autoArbortext Editor will run as many formatting passes as it needs to reformat the document to accommodate any text or markup changes that may have been made, using the content of the existing .dvi file. If there have been no changes since the document was last formatted, no reformatting is done.
allpasses force — that the entire document will be completely reformatted, even if a .dvi file already exists in your aptcache directory.
onepass — do at most one formatting pass.
onepass auto — one formatting pass will be run if the document has been modified since the last time the document was formatted. Otherwise, no formatting pass will be run.
onepass force — one formatting pass will be run under all circumstances.
When a onepass option is selected and one pass is not sufficient to complete all document formatting, Arbortext Editor will display status re-fmt needed on the status bar. An additional pass will usually complete the formatting.
The wait argument controls whether Arbortext Editor should wait for the format to complete before continuing to execute commands. In the examples below, the command waits until the testfile.sgm document is completely formatted.
The following example produces new, completely-reformatted .dvi files of testfile.sgm in your aptcache directory.
editor -c "format allpasses force wait" testfile.sgm