Prev Next stdout

Standard Output Information

Purpose
OMhelp prints a trace of its activity on standard output to show that processing is proceeding and to help in debugging.

Version Identification
The first output line contains the date corresponding to the version of OMhelp that is being run.

Input File
A line of trace information is printed for each input file. The line begins with the name of the file that is being processed. The file being processed appeared in a contents, childtable, or children command of one of the previous files (see Specifying Children in Contents Tree). The level of indentation for each file is one space greater than the level of indentation for the file that contained the command causing it to be processed.

Cross Reference Tags
The cross reference tag for each of the sections that are defined in the file are printed following the file name and on the same line.

Error Messages
OMhelp error messages begin on a separate line with the text OMhelp Error:. These errors cause OMhelp to terminate with a non-zero exit status .

Warning Message
OMhelp warning messages begin on a separate line with the text OMhelp Warning:.

Redirect
It is often useful to redirect standard output to a file so that you can review the input tree, warnings, and the error messages.

Include
The include command does not cause the name of the corresponding file to be printed on standard output.

Example
The files RunOMhelp and RunOMhelp.bat, in the omhelp\omh directory, user OMhelp to process the OMhelp user documentation files to create the corresponding web site. Below is a listing of some of the text was printed to standard output when the OMhelp developer documentation was built with the command 
 
	RunOMhelp Dev
was executed in the omhelp\omh directory during the installation of this version: 
OMhelp: Version=13-01-02, ndebug=false, win32=false

omhelp.omh: OMhelp:
 ../../omh/license.omh: License:
 ../convert.h: convert:
  ../convert.c: ConvertNewline: ConvertOutput: ConvertAddColumn: ConvertSetTabSize: ConvertPreviousNewline: ConvertInternalString:
 cross.omh: cross:
  automatic.omh: automatic:
   ../automatic.c: AutomaticAppendSection: IsAutomaticSection: AutomaticTag:
   ../AutomaticLink.c: AutomaticLink:
   ../content.c: content:
  ../cross.h: CrossReference:
   ../cross.c: CreateCrossReference: FindCrossReference: DefineCrossReference: NextCrossReference: FreeCrossReference:
  ../href.h: href:
   ../href.c: HrefOutputPass1: HrefOutputPass2: HrefPrintablePass2: HrefEnd: HrefAddList: HrefOutputList: HrefFreeMemory:
  ../index.c: KeywordIndex:
  ../relative.c: relative:
   ../links.c: links:
  ../search.c: search:
  ../url.c: Url:
 ../execute.h: execute:
  ../execute.c: ExecuteNextFile: ExecuteSetFile: ExecuteWriteFile: ExecuteFree:
 ../input.h: input:
  ../input.c: InputGet: InputInit: InputPush: InputPop: InputName: InputLine: InputAddPath: InputSearch: InputSplitName: InputFree:
 output.omh: output:
  ../FrameSet.c: FrameSet:
  ../HtmlHead.c: HtmlHead:
  ../output.c: PushOutput: PopOutput: OutputName:
 ../section.h: SectionInfo:
  ../section.c: SectionInfoNew: SectionDefaultStyle: SectionFreeTree: SectionFind: SectionSetTag: SectionNumber: SectionTagNotDefined: SectionReadOrder: SectionNavigate:
 string.omh: string:
  ../StrLowCase.c: StrLowCase:
  ../SplitText.c: SplitText:
  ../StrCat.c: StrCat:
  ../StrLowAlloc.h: StrLowAlloc:
  ../str_alloc.h: str_alloc:
  ../strjoin.h: strjoin:
  ../StrRemove.c: StrRemove:
  ../ClipWhiteSpace.c: ClipWhiteSpace:
  ../UniformWhiteSpace.c: UniformWhiteSpace:
  ../int2str.c: int2str:
  ../FileEqual.c: FileEqual:
 misc.omh: misc:
  ../fatalerr.c: fatalerr:
  ../math.c: math:
  ../pending.c: pending:
  ../children.c: children:
  ../head.c: heading:
  ../funref.c: FunRef:
  ../copyfile.c: copyfile:
  ../spell.c: spell:
  ../style.c: style:
  ../Internal2Out.c: Internal2Out:
  ../latex.l: LatexLexPut: LatexLexHistory:
  ../LatexAtomic.c: LatexAtomic:
  ../BinarySearch.c: BinarySearch:
  ../Color.c: Color:
  ../LatexMacro.h: LatexMacro:
   ../LatexMacro.c: LatexMacroUserInput: LatexMacroFree: LatexMacroGetCh: LatexMacroInputLine: LatexMacroInputFile: LatexMacroExpandInput: LatexMacroExpandLine: LatexMacroExpandFile: LatexMacroExpandName: LatexMacroKeep: LatexMacroPopFullyExpandedInput:
  ../allocmem.c: AllocMem: c_alloc:
  ../lexomh.c: CommandKeyCharacter: TokenCode2String:
  ../trace_exit.c: trace_exit:
 glossary.omh: glossary:
Begin Second Pass

Input File: stdout.omh