Man Linux: Main Page and Category List

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
       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.

       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
              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 file’s first column.

       o      file
              The argument file must be an existing file.

       Verbinsert writes its selected section to its standard output stream.

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.

       o      -N
              Do  not  write  a newline immediately following verb-statement’s
              open-parenthesis.  By  default  it  is   written,   causing   an
              additional  line  to  be  inserted  before the first line that’s
              actually inserted from a file.

       o      -s spaces [0]
              start each line that  is  written  into  the  verb-section  with
              spaces additional blanks.

       o      -S spaces [8]
              prefix the verb of the verb-section by spaces additional blanks.

       o      -t tabs [0]
              start each line that is written into the verb-section with  tabs
              additional  tab characters. If both -s and -t are specified, the
              tabs are inserted first.

       o      -T tabs [0]
              prefix the verb of  the  verb-section  by  tabs  additional  tab
              characters.  If  both  -S  and  -T  are  specified, the tabs are
              inserted first.

EXAMPLE

       Assume the file demo contains the following text:

       preceding text

       //one
       one 1

       //=

       /*two*/

           two

       /**/

       trailing text

       Then the following commands write the shown  output  to  the  program’s
       standard output:

       o      verbinclude //one demo
                      verb(
              one 1

              )

       o      verbinclude -N //one demo
                      verb(one 1

              )

       o      verbinclude -s4 /*two*/ demo
                      verb(

                      two

              )

SEE ALSO

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

BUGS

       -

AUTHOR

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