FreeBSD Manual Pages
yodlverbinsert(1) Your Own Document Language yodlverbinsert(1) NAME yodlverbinsert - Generate verb-sections from parts of a file SYNOPSIS yodlverbinsert [OPTIONS] [marker] file DESCRIPTION Verbinsert is a simple C++ support program that can be used to generate verb()-sections in Yodl files from sections of existing files. The files from which sections are included are usually C or Cpp source files, accepting either // or /*-style comment. See the EXAMPLES sec- tion for illustrations. Verbinsert offers the possibility to indent both the initial verb-statement and the inserted file contents. Furthermore, an addi- tional empty line may be inserted before the first line that is actu- ally inserted. Blank lines at the beginning and end of files are ignored. o marker The argument marker must start in file's 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 char- acters and their locations, and the last two characters of a C-style marker, no special restrictions are imposed upon the la- bel-names. A labeled section ends at the next //= (for labels starting with //) or at the next /**/ (for labels starting with /*). Like the markers, the end-markers must also start in the first columns of lines. Alternatively, pairs of //+label, or /*+label*/ can be used. For such markers, copying starts at the first line following the first occurrence of the label, and ends when the label is en- countered again. When these markers are used any additionally encountered marker-line is simply ignored, and not written to the output stream. This allowes labeled sections to be nested. o file The argument file must be an existing file. Verbinsert writes its selected section to its standard output stream. NOTE: Starting with Yodl version 3.00.0 Yodl's 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, chang- ing to the directory in which a yodl-file is located. This has the ad- vantage that Yodl's file inclusion behavior now matches the way C's #include directive operates; it has the disadvantage that it may break some current documents. Conversion, however is simple but can be avoided altogether if Yodl's -L (--legacy-include) option is used. OPTIONS The default values of options are listed with each of the options be- tween 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. o -a Process all lines of file (except initial and trailing blank lines). The argument marker must not be specified. o -A Same as the -a option, but ignoring all lines that can be con- sidered yodlverbinsert (end) marker-lines. o -n Immediately following the indentation: lines are prefixed by numbers, occupying 2 columns, followed by a colon and a blank. o -N Do not write a newline immediately following verb-statement's open-parenthesis. By default it is written, causing an addi- tional line to be inserted before the first line that's actually inserted from a file. o -s nSpaces [0] start each line that is written into the verb-section with nSpaces additional blanks. o -S nSpaces [8] prefix the verb of the verb-section by nSpaces additional blanks. o -t nTabs [0] 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 [0] prefix the verb of the verb-section by nTabs additional tab characters. If both -S and -T are specified, the tabs are in- serted first. EXAMPLE Assume the file demo contains the following text: preceding text //+nest //one one 1 //= /*two*/ two /**/ //+nest trailing text Then the following commands write the shown output to the program's 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 ) o yodlverbinsert -n //+nest' demo verb( 1: one 1 2: 3: 4: 5: two ) SEE ALSO yodlstriproff(1), yodl(1), yodlbuiltins(7), yodlconverters(1), yodllet- ter(7), yodlmacros(7), yodlmanpage(7), yodlpost(1) BUGS - AUTHOR Frank B. Brokken (f.b.brokken@rug.nl), yodl_4.01.00.tar.gz 1996-2017 yodlverbinsert(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | SEE ALSO | BUGS | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=yodlverbinsert&sektion=1&manpath=FreeBSD+Ports+15.0>