The argument marker must start in files first column en must either start as a standard C or C++ comment: // or /* must be used. Following that, the remainder of the argument is used as a label, e.g., //label, /*LABEL*/. Except for the first two characters and their locations no special restrictions are imposed upon the markers. A labeled section ends at the next //= (when the label started with //) or at the next /**/ (when the label started with /*). Like the markers, the end-markers must also start in the files first column.
The argument file must be an existing file.
NOTE: Starting with Yodl version 3.00.0 Yodls default file inclusion behavior has changed. The current working directory no longer remains fixed at the directory in which Yodl is called, but is volatile, changing to the directory in which a yodl-file is located. This has the advantage that Yodls file inclusion behavior now matches the way Cs #include directive operates; it has the disadvantage that it may break some current documents. Conversion, however is simple but can be avoided altogether if Yodls -L (--legacy-include) option is used.
The default values of options are listed with each of the options between square brackets. The defaults were chosen so that yodlverbinsert performs the behavior of an earlier version of this program, which was not distributed with Yodl.
Process all lines of file (except initial and trailing blank lines). The argument marker must not be specified.
Immediately following the indentation: lines are prefixed by numbers, occupying 2 columns, followed by a colon and a blank.
Do not write a newline immediately following verb-statements open-parenthesis. By default it is written, causing an additional line to be inserted before the first line thats actually inserted from a file.
o -s nSpaces 
start each line that is written into the verb-section with nSpaces additional blanks.
o -S nSpaces 
prefix the verb of the verb-section by nSpaces additional blanks.
o -t nTabs 
start each line that is written into the verb-section with nTabs additional tab characters. If both -s and -t are specified, the tabs are inserted first.
o -T nTabs 
prefix the verb of the verb-section by nTabs additional tab characters. If both -S and -T are specified, the tabs are inserted first.
Assume the file demo contains the following text:
//one one 1
Then the following commands write the shown output to the programs standard output:
o yodlverbinsert //one demo
verb( one 1 )
o yodlverbinsert -N //one demo
verb(one 1 )
o yodlverbinsert -n -s4 /*two*/ demo
verb( 1: two )
yodlstriproff(1), yodl(1), yodlbuiltins(7), yodlconverters(1), yodlletter(7), yodlmacros(7), yodlmanpage(7), yodlpost(1)
Frank B. Brokken (email@example.com),