yodlverbinsert(1)

Your Own Document Language
(yodl_4.03.02)

1996-2021

NAME

yodlverbinsert - Generate verb-sections from parts of a file

SYNOPSIS

yodlverbinsert [OPTIONS] [marker] file

DESCRIPTION

Verbinsert is a simple C++ support program that is used for generating verb()-sections in Yodl files using 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 section for illustrations.

Verbinsert offers the possibility to indent both the initial verb-statement and the inserted file contents. Furthermore, an additional empty line may be inserted before the first line that is actually inserted.

Blank lines at the beginning and end of files are ignored.

Verbinsert writes its selected section to its standard output stream.

When files contain identical marker sections then the contents of each of these marker sections is included in the generated verb-section. This allows the inclusion of non-consecutive lines of source files in a verb section.

OPTIONS

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.

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:

SEE ALSO

yodl(1), yodlbuiltins(7), yodlconverters(1), yodlletter(7), yodlmacros(7), yodlmanpage(7), yodlpost(1), yodlstriproff(1), yodltables(7).

BUGS

-

AUTHOR

Frank B. Brokken (f.b.brokken@rug.nl),