% -*-LaTeX-*-
% Converted automatically from troff to LaTeX by tr2tex on Tue Mar 24 19:25:34 1992
% tr2tex was written by Kamal Al-Yahya at Stanford University
% (Kamal%Hanauma@SU-SCORE.ARPA)


\documentstyle[troffman]{article}
\begin{document}
%
% input file: c++2latex.1
%
\phead{C++2LATEX}{1}{2\ April\ 1990}
 "Version 1.0"
\shead{NAME}
c++2latex - C/C++ to LaTeX converter
\shead{SYNOPSIS}
{\bf c++2latex}
{\bf [-a]} [-c] [-h] [-i length] [-o path] [-s size] [-t] [-C font]
{\bf [-H} font] [-K font] [-P font] [-S font] [-T wide] [-V]
{\bf [+ansi-c]} [+complete-file] [+header] [+indentation length]
{\bf [+output} path] [+font-size size] [+pipe] [+comment-font font]
{\bf [+keyword-font} font] [+cpp-font font] [+header-font font]
{\bf [+string-font} font] [+tabstop wide] [+version] [path]
\shead{DESCRIPTION}
{\it c++2latex}
is a tool for generating
{\it LateX}
source from ANSI-C or C++ programs.
It recogizes all keywords, strings, and comments. These recognized parts
can be set in different fonts.
{\it c++2latex}
can generate complete %
\it LaTeX %
\rm  files which can directly passed
through latex(1) or parts of
{\it LaTeX}
files which can be included in other files (either direct or by the
{\bf \bs \bs input}
or
{\bf \bs \bs include}
commands).
\par\noindent
The output filename is searched in various steps. First, if the
\{-o,+output\} flag is given, the output is written to the file pointed
to by the value of this flag. If the \{-t,+pipe\} option is given, the
output is written to stdout. (It is an error to specify both options
together.) If none of this options but an input pathname is given, the
output is written to a file who's name is the last component of the
input pathname with the substituted or else added suffix '.tex'. If
the input is read from stdin and none of the above options is given,
the output is written to '$<$program-name$>$.tex' with $<$program-name$>$ being
the name of this program.
\shead{OPTIONS}
{\it c++2latex}
has the following options:
\begin{TPlist}{{\bf -a,+ansi-c}}
\item[{{\bf -a,+ansi-c}}]
The input is an ANSI-C program. Default is C++, so %
\bf don't %
\rm  give this option
for C++ programs and %
\bf always %
\rm  give this option for ANSI-C programs.
\item[{{\bf -c,+complete-file}}]
The output is enveloped in
commands which produce a complete
{\it LaTeX}
source.
\item[{{\bf -h,+header}}]
Each page of output has a header giving the input file name and the
date the file was produced. This option implies the
\{-c,+complete-file\} option.
\item[{{\bf -i,+indentation} length}]
Gives the amount of indentation for each leading blank (tabs are
converted to blanks). Default is `0.5em'.
\item[{{\bf -o,+output} %
\it path%
\rm }]
The output is written in the file pointed to by %
\it path%
\rm .
\item[{{\bf -s,+font-size} %
\it size%
\rm }]
The LaTeX source is set in %
\it size%
\rm pt. Default is `11'.
\item[{{\bf -t,+pipe}}]
The output is written to stdout.
\item[{{\bf -C,+comment-font} %
\it font%
\rm }]
The comments are set in the given font. Default is `it'.
\item[{{\bf -H,+header-font} %
\it font%
\rm }]
The headers are set in the given font. Default is `sl'.
\item[{{\bf -K,+keyword-font} %
\it font%
\rm }]
The keywords are set in the given font. Default is `bf'.
\item[{{\bf -P,+cpp-font} %
\it font%
\rm }]
The preprocessor directives are set in the given font. Default is `tt'.
\item[{{\bf -S,+string-font} %
\it font%
\rm }]
The string and character constants are set in the given font. Default is `tt'.
\item[{{\bf -T,+tabstop} %
\it wide%
\rm }]
The wide of tabs is %
\it wide%
\rm . Default is `8'.
\item[{{\bf -V,+version}}]
Prints the version number on stderr.
\end{TPlist}
\shead{OPTION SUMMARY}
\begin{TPlist}{To give no oprion at all is the same as to give the options}
\item[{To give no oprion at all is the same as to give the options}]
-i 0.5em -s 11 -C it -H sl -K bf -P tt -S tt -T 8
\end{TPlist}
\shead{SEE ALSO}
\par\noindent
latex(1).
\shead{DIAGNOSTICS}
\begin{TPlist}{{\it Can't} use \{-t,+pipe\} and \{-o,+output\} together.}
\item[{{\it Can't} use \{-t,+pipe\} and \{-o,+output\} together.}]
At most one of this options may be given.
\end{TPlist}
\begin{TPlist}{{\it Can't} open `$<$path$>$' for reading}
\item[{{\it Can't} open `$<$path$>$' for reading}]
The program failed to open $<$path$>$ for reading.
\end{TPlist}
\begin{TPlist}{{\it Can't} open `\%s' for writing}
\item[{{\it Can't} open `\%s' for writing}]
The program failed to open $<$path$>$ for writing. All output is written
in the current directory if not explicitly changed by \{-o,+output\}.
\end{TPlist}
\begin{TPlist}{{\it Virtual} memory exhausted}
\item[{{\it Virtual} memory exhausted}]
The program failed to allocate storage. As this is only done for the
construction of pathnames, this error will normally indicate a
program error.
\end{TPlist}
\shead{AUTHOR}
Norbert Kiesel.
\par\noindent
\shead{DEFICIENCIES / BUGS}
\par\noindent
\par\noindent
The program should be completly rewitten to understand language
descriptions ala tgrind.
\end{document}