🚀 go-pugleaf

Hi there,

I'd just like to point you to a set of tools (cf man page below) that
have been submitted to comp.sources.misc on USENET (vol44, i10-17).

Enjoy!

	-joke

    J�rg Heitk�tter                                       joke@Germany.EU.net
c/o EUnet Deutschland GmbH         __o             vox humana: +49 231 972 00
    Techno Park                    \<,          fax machina: +49 231 972 1111
    D-44227 Dortmund     ________()/ ()___               *Market Square Hero*


--- $Id: README,v 3.0 1994/01/15 17:06:16 joke Rel $

NAME
     C++2LaTeX - a set of LaTeX converters for the whole C family

SYNOPSIS
     c++2latex [options] file(s) ...
     krc2latex [options] file(s) ...
     ansic2latex [options] file(s) ...
     objc2latex [options] file(s) ...

     each of these tools take note of the following options:

             [-b,  --brace-tab <distance-in-blanks>]
             [-c,  --complete-file]
             [-d,  --dots-in-figure <position>]
             [-f,  --figure]
             [-h,  --header [=<text>]]
             [-i,  --indentation <TeX-dimension>]
             [-n,  --no-alignment]
             [-o,  --output <file>]
             [-s,  --font-size <size-in-points>]
             [-t,  --tabwidth <width-in-blanks>]
             [-C,  --comment-font <TeX-font>]
             [-H,  --header-font <TeX-font>]
             [-K,  --keyword-font <TeX-font>]
             [-P,  --pre-processor-font <TeX-font>]
             [-S,  --string-font <TeX-font>]
             [-V,  --version]
             [-W,  --warranty]

DESCRIPTION
     The C++2LaTeX package features a set of tools for generating
     LaTeX  code  from  K&R C, ANSI C, C++ or Objective-C program
     sources.  All keywords, strings, and comments are recognized
     and  can  be  typeset  in different fonts.  All tools of the
     C++2LaTeX package generate either complete LaTeX files which
     can  pass  directly  through  latex(1), parts of LaTeX files
     which can be included in other files (either  direct  or  by
     the  \input or \include commands), and so-called codefigures
     that can be used within LaTeX files, much the  same  way  as
     ENCAPSULATED  POSTSCRIPT  figures  are included, when using,
     for  example  Trevor  J.  Darrell's  psfig.sty,   or   Tomas
     Rokicki's  epsf.sty  macro  package(s).  (See  the companion
     fancycodes.doc file for more documentation on this issue.)

CHANGES FROM PREVIOUS RELEASES
     Version 3.0:

     *  Like other good, ie. well-behaved unixoid  programs,  all
        C++2LaTeX  tools now act like filters, that is, they read
        their input from stdin, when no input  files  are  given,
        and write their output to stdout; There is thus no longer
        an extra flag (`-p, --pipe')  for  output  generation  on
        stdout present, unlike in previous releases.

     *  The `-f, --figure'  and  `-d,  --dots-in-figure'  options
        have  been  added  to generate codefigures, for inclusion
        with the fancycodes.sty LaTeX macros.

     *  The package also uses the new GNU getopt `--'  convention
        for  long option flags, instead of the formerly used NON-
        POSIX 2 compliant `+' character.

     *  The package now features the  latest  version  (v1.1)  of
        fancyheadings.sty.

     *  ``Italic correction'' after keywords has  been  added  on
        user feedback.

     *  The ANSI C compliant # and ## pre-processor commands  are
        now recognized.

     *  Due to flex(1) version  2.4,  a  bug  in  the  rules  was
        detected  and  fixed.  Octal constants outside of strings
        are now parsed correctly.

OPTIONS
     Each tool recognizes the following options:

     -b, --brace-tab
          This changes the tabulator size of a comment  belonging
          to a closing brace.  Default is 4*indentation (see `-i,
          --indentation' option, below).

     -c, --complete-file
          The output is wrapped into  commands  which  produce  a
          complete LaTeX document.

     -d, --dots-in-figures <postition>
          All codefigures will have vertical dots, ie. the  LaTeX
          \vdots-command,  placed at the position given, which is
          quite similar to \tabular-environment's:

          t  put vertical dots on top of figure(s),

          b  put vertical dots at the bottom of figure(s), and

          c  center the vertical dots, that are flushed  left  by
             default.

          Thus all possibilities for positions are: t, b, tc, bc,
          tb,  and  tbc.   This option implies the `-f, --figure'
          option.

     -f, --figure
          Output   code   ready   for   inclusion    using    the
          codefigure.sty  macros.   This  option implies the `-n,
          --no-alignment' option.

     -h, --header [=<text>]
          Each page of output has a header giving the input  file
          name(s)  by  default.  The optional text overrides this
          behaviour by placing the given text  into  the  header.
          Note that the `=' is required.  Text may conmtain valid
          LaTeX  commands.  This  option  implies  the  `-c,   --
          complete-file' option.

     -i, --indentation <TeX-dimension>
          Gives the amount of indentation in a TeX dimension  for
          each  leading  blank  (tabs  are  converted to blanks).
          Default is 0.5em.

     -n, --no-alignment
          Comments belonging to statements  are  aligned  to  the
          right  paper  side  by  default.  You can turn off this
          behaviour by using this switch.

     -o, --output <file>
          The output is written to file.

     -s, --font-size <size-in-points>
          The LaTeX source is set to sizept. Possible values are:
          10, 11 and 12.  Default is 10.

     -t, --tabwidth <width-in-blanks>
          The width of tabstops is width. Default is 8.

     -C, --comment-font <TeX-font>
          The comments are set in the given font. Default is it.

     -H, --header-font <TeX-font>
          The headers are set in the given font. Default is sl.

     -K, --keyword-font <TeX-font>
          The keywords are set in the given font. Default is bf.

     -P, --pre-processor-font <TeX-font>
          The preprocessor directives are set in the given  font.
          Default is tt.

     -S, --string-font <TeX-font>
          The string and character constants are set in the given
          font. Default is tt.

     -V, --version
          Print the version number on stderr.

     -W, --warranty
          Print the warranty information on stderr.

OPTION SUMMARY
     To give no option at all is the same as  to  give  the  following
     options:

          --indentation 0.5em
          --fontsize 10
          --comment-font it
          --header-font sl
          --keyword-font bf
          --pre-processor-font tt
          --string-font tt
          --tabwidth 8

SEE ALSO
     latex(1), m2latex(1), lgrind(1), lagrind(1), tgrind(1), dvips(1).

REFERENCES
     Brian W. Kernighan and Denis M. Ritchie: The  C  Programming
     Language, Prentice-Hall, Englewood Cliffs NJ, 1978.

     Brian W. Kernighan and Denis M. Ritchie: The  C  Programming
     Language  (2nd Edition), Prentice-Hall, Englewood Cliffs NJ,
     1988.

     Samuel P. Harbison and Guy L. Steele  jr.:  C,  A  Reference
     Manual  (3rd  Edition),  Prentice-Hall, Englewood Cliffs NJ,
     1991.

     Bjarne Stroustrup: The C++  Programming  Language,  Addison-
     Wesley, Reading MA, 1987.

     M. A. Ellis and  B. Stroustrup: The Annotated C++  Reference
     Manual,  ANSI  Base  Document,  Addison-Wesley,  Reading MA,
     1990.

     Brad J. Cox: Object Oriented  Programming:  An  Evolutionary
     Approach, Addison-Wesley, Reading MA, 1987.


AUTHOR
     Copyright (C) 1991-1994 Joerg Heitkoetter <joke@Germany.EU.net>

 c/o EUnet Deutschland GmbH
     Techno Park, Emil-Figge-Str. 80
     D-44227 Dortmund, Germany

     vox humana:  +49 231 972 00     
     fax machina: +49 231 972 1111

CREDITS
     Thanks to Norbert Kiesel for writing the  first  version  of
     C++2LaTeX  (v1.1,  pl4,  1990).  Bernd Raichle for providing
     LaTeXpertise, when LaTeXpertise was badly needed.  Piet  van
     Oostrum for fancy headings (v1.1).  George V. Reilly for the
     card from Ireland, and more LaTeXpertise.  Vern Paxson for a
     mostly  flexible tool.  Ajay Shah for mocking about the `-p'
     option, and other helpful comments.  Roger Fearick  for  the
     bug  fix.   Bill Shirley for providing infos on Objective-C.
     Gene Ressler for the  `--figure'  idea  and  the  `minipage'
     hack.  Eric Van Gestel for the beautiful C++ logo.  Johannes
     Sixt for the idea to use italic correction  after  keywords.
     Gijsbert  Wiesenekker  for  reminding  me of the unary # and
     binary ## preprocessor  directives,  that  come  along  with
     ANSI,  and had been omitted in And Patrick Dockhorn for com-
     plaining about problems with flex(1) version 2.4.6.

AVAILABILITY
     C++2LaTeX has been posted to USENET's comp.sources.misc  and
     thus  is  available  from your local comp.sources.misc news-
     group archive. E.g. by anonymous ftp from ftp.Germany.EU.Net
     in directory /pub/newsarchive/comp.sources.misc.

COPYRIGHT
     This work is protected by the terms of the GNU General  Pub-
     lic  License.  Please refer to the LICENSE file accompanying
     the sources of this software package for a lengthy,  boring,
     but absolute complete description of what copyleft means for
     you.

WARRANTY
     This program is  free  software;  you  can  redistribute  it
     and/or  modify  it under the terms of the GNU General Public
     License as published by the Free Software Foundation; either
     version 2 of the License, or (at your option) any later ver-
     sion.

     This program is distributed in the hope that it will be use-
     ful, but WITHOUT ANY WARRANTY; without even the implied war-
     ranty of MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR-
     POSE. See the GNU General Public License for more details.

     You should have received a copy of the  GNU  General  Public
     License  along  with this program; if not, write to the Free
     Software Foundation,  Inc.,  675  Mass  Ave,  Cambridge,  MA
     02139, USA.
-- 
Enjoy!

	-joke

    J�rg Heitk�tter                                       joke@Germany.EU.net
c/o EUnet Deutschland GmbH         __o             vox humana: +49 231 972 00
    Techno Park                    \<,          fax machina: +49 231 972 1111
    D-44227 Dortmund     ________()/ ()___       *Is everything, everything?*