home *** CD-ROM | disk | FTP | other *** search
- From: greyham@research.canon.oz.au (Graham Stoney)
- Newsgroups: comp.sources.misc
- Subject: v43i023: c2man-2.0 - automatic C documentation generator, Patch30
- Date: 9 Jun 1994 11:50:41 -0500
- Organization: Canon Information Systems Research Australia
- Sender: kent@sparky.sterling.com
- Approved: kent@sparky.sterling.com
- Message-ID: <2t7h91$3e9@sparky.sterling.com>
- Summary: This is an official patch for c2man 2.0. Please apply it.
- X-Md4-Signature: db62112288fd7c32be7d982624c9f676
-
- Submitted-by: greyham@research.canon.oz.au (Graham Stoney)
- Posting-number: Volume 43, Issue 23
- Archive-name: c2man-2.0/patch30
- Environment: UNIX, DOS, OS/2, lex, yacc
- Patch-To: c2man-2.0: Volume 42, Issue 55-63
-
- System: c2man version 2.0
- Patch #: 30
- Priority: LOW
- Subject: patch #28, continued
- Date: Fri May 20 11:39:17 EST 1994
- From: Graham Stoney <greyham@research.canon.oz.au>
-
- Description:
- See patch #28.
-
-
- Fix: From rn, say "| patch -p -N -d DIR", where DIR is your c2man source
- directory. Outside of rn, say "cd DIR; patch -p -N <thisarticle".
- If you don't have the patch program, apply the following by hand,
- or get patch (version 2.0, latest patchlevel).
-
- After patching:
- *** NOTE: YOU MUST AT LEAST RUN Configure AFTER APPLYING ***
- *** THIS PATCH BEFORE APPLYING ANY SUBSEQUENT PATCHES. ***
-
- Configure -ders
- make depend
- make
- make test
- make install
-
- If patch indicates that patchlevel is the wrong version, you may need
- to apply one or more previous patches, or the patch may already
- have been applied. See the patchlevel.h file to find out what has or
- has not been applied. In any event, don't continue with the patch.
-
- If you are missing previous patches they can be obtained from me:
-
- Graham Stoney <greyham@research.canon.oz.au>
-
- If you send a mail message of the following form it will greatly speed
- processing:
-
- Subject: Command
- @SH mailpatch PATH c2man 2.0 LIST
- ^ note the c
-
- where PATH is a return path FROM ME TO YOU either in Internet notation,
- or in bang notation from some well-known host, and LIST is the number
- of one or more patches you need, separated by spaces, commas, and/or
- hyphens. Saying 35- says everything from 35 to the end.
-
- To get some more detailed instructions, send me the following mail:
-
- Subject: Command
- @SH mailhelp PATH
-
-
- Index: patchlevel.h
- Prereq: 29
- 2c2
- < #define PATCHLEVEL 29
- ---
- > #define PATCHLEVEL 30
-
- Index: c2man.1
- Prereq: 2.0.1.36
- *** c2man.1.old 1994/01/13 05:20:40
- --- c2man.1 1994/05/12 02:21:13
- ***************
- *** 1,4 ****
- ! .\" $Id: c2man.1,v 2.0.1.36 1994/01/13 05:20:40 greyham Exp $
- .de EX \"Begin example
- .br
- .if \\$1 .ne \\$1
- --- 1,4 ----
- ! .\" $Id: c2man.1,v 2.0.1.37 1994/05/12 02:21:13 greyham Exp $
- .de EX \"Begin example
- .br
- .if \\$1 .ne \\$1
- ***************
- *** 52,58 ****
- .if t .sp .5
- .fi
- ..
- ! .TH C2MAN 1 "January 12, 1994"
- .BY "CISRA"
- .SH NAME
- c2man \- generate manual pages from C source code
- --- 52,58 ----
- .if t .sp .5
- .fi
- ..
- ! .TH C2MAN 1 "May 12, 1994"
- .BY "CISRA"
- .SH NAME
- c2man \- generate manual pages from C source code
- ***************
- *** 530,535 ****
- --- 530,540 ----
- If using the second form, you may need to quote the quotation marks, lest they
- get removed by the shell.
- .TP
- + .BI \-x sectionname
- + Exclude
- + .I sectionname
- + from the generated manpages. This option may be repeated.
- + .TP
- .BI \-H header-path
- Prepend
- .B header-path
- ***************
- *** 548,563 ****
- parameters with no comment are described as ``Not Documented.'', to encourage
- the programmer to comment them.
- .TP
- ! .B \-T n|l|t
- ! Set the output typesetting language.
- .B Nroff
- .RB ( n )
- is the default,
- .B LaTeX
- .RB ( l )
- , or
- ! .B texinfo
- .RB ( t ).
- .TP
- .BI \-e
- Prepares the output so it can be embedded in texts of the output typesetting
- --- 553,607 ----
- parameters with no comment are described as ``Not Documented.'', to encourage
- the programmer to comment them.
- .TP
- ! .BI \-Tn|l|t[, options ]
- ! Set the output typesetting language as well as language specific
- ! options.
- ! .I options
- ! is a comma delimited list of options.
- .B Nroff
- .RB ( n )
- is the default,
- .B LaTeX
- .RB ( l )
- , or
- ! .B Texinfo
- .RB ( t ).
- + .B Texinfo
- + specific options are
- + .BR s ,
- + .BR t ,
- + and
- + .BR n.
- +
- + In
- + .B Texinfo
- + mode, each section is normally coded as a ``heading'' rather than a
- + ``section''. This prevents the section name from appearing in the
- + table of contents. If the option
- + .B t
- + is given, the name of the manpage is used for the title of the
- + .B NAME
- + section, and is encoded as a ``section'', placing it in
- + the table of contents. Subsequent sections are encoded as ``headings''.
- + .B Texinfo
- + supports multiple levels of headings; the desired level may be
- + specified via the
- + .BI s n
- + option, where
- + .I n
- + starts at 0 for the ``chapter level'' and works down. A
- + top level node is created for the manpage, except when in embedded
- + mode
- + (the
- + .B c2man \-e
- + option). If the
- + .B n
- + option is specified, a node is created in embedded mode, but
- + without Up, Previous, or Next pointers; these must be filled in
- + .BR ( Texinfo
- + mode in
- + .B emacs
- + does a good job of it).
- .TP
- .BI \-e
- Prepares the output so it can be embedded in texts of the output typesetting
- ***************
- *** 572,578 ****
- defaults to ``3'' for
- .BR nroff ,
- ``texi'' for
- ! .B TeXinfo
- and ``tex'' for
- .B LaTeX
- output, as specified via the
- --- 616,622 ----
- defaults to ``3'' for
- .BR nroff ,
- ``texi'' for
- ! .B Texinfo
- and ``tex'' for
- .B LaTeX
- output, as specified via the
-
- Index: catalog
- *** catalog.old 1994/04/18 04:45:54
- --- catalog 1994/05/19 01:13:58
- ***************
- *** 1,14 ****
- language: C, nroff, texinfo, latex
- package: c2man
- ! version: 2.0 patchlevel 26
- parts: documentation generator (C -> nroff -man, -> texinfo, -> latex)
- author: Graham Stoney <greyham@research.canon.oz.au>
- ! how to get: ftp /pub/Unix/Util/c2man-2.0.*.tar.gz from dnpap.et.tudelft.nl
- ! N.America: ftp usenet/comp.sources.reviewed/volume03/c2man*
- from ftp.wustl.edu
- ! Europe: ftp /pub/archive/comp.sources/reviewed/c2man*
- ! from ftp.informatik.uni-stuttgart.de
- ! Japan: ftp /pub/NetNews/comp.sources.reviewed/volume3/c2man*
- from ftp.iij.ad.jp
- Patches: ftp pub/netnews/sources.bugs/volume93/sep/c2man* from lth.se
- description: c2man is an automatic documentation tool that extracts comments
- --- 1,18 ----
- language: C, nroff, texinfo, latex
- package: c2man
- ! version: 2.0 patchlevel 28
- parts: documentation generator (C -> nroff -man, -> texinfo, -> latex)
- author: Graham Stoney <greyham@research.canon.oz.au>
- ! how to get: ftp from any comp.sources.misc archive, in volume42
- ! (the version in the comp.sources.reviewed archive is obsolete)
- ! ftp /pub/Unix/Util/c2man-2.0.*.tar.gz from ftp.et.tudelft.nl
- ! Australia: ftp /usenet/comp.sources.misc/volume42/c2man-2.0/*
- ! from archie.au
- ! N.America: ftp /usenet/comp.sources.misc/volume42/c2man-2.0/*
- from ftp.wustl.edu
- ! Europe: ftp /News/comp.sources.misc/volume42/c2man-2.0/*
- ! from ftp.irisa.fr
- ! Japan: ftp /pub/NetNews/comp.sources.misc/volume42/c2man-2.0/*
- from ftp.iij.ad.jp
- Patches: ftp pub/netnews/sources.bugs/volume93/sep/c2man* from lth.se
- description: c2man is an automatic documentation tool that extracts comments
- ***************
- *** 27,37 ****
- + handles C (/* */) and C++ (//) style comments
- - doesn't handle C++ grammar (yet)
- requires: yacc/byacc/bison, lex/flex, and nroff/groff/texinfo/LaTeX.
- ! ports: Unix, OS/2, MSDOS
- portability: very high for unix, via Configure
- status: actively developed; contributions by users are encouraged.
- discussion: send "subscribe c2man <Your Name>" (in the message body) to
- listserv@research.canon.oz.au
- ! announcements: patches appear first in comp.sources.bugs, later in
- ! comp.sources.reviewed after a review period.
- ! updated: 1994/02/22
- --- 31,41 ----
- + handles C (/* */) and C++ (//) style comments
- - doesn't handle C++ grammar (yet)
- requires: yacc/byacc/bison, lex/flex, and nroff/groff/texinfo/LaTeX.
- ! ports: Unix, OS/2, MSDOS, VMS.
- portability: very high for unix, via Configure
- status: actively developed; contributions by users are encouraged.
- discussion: send "subscribe c2man <Your Name>" (in the message body) to
- listserv@research.canon.oz.au
- ! announcements: patches appear first in comp.sources.bugs, and then in
- ! comp.sources.misc.
- ! updated: 1994/05/12
-
- Index: README
- *** README.old 1994/04/18 23:58:45
- --- README 1994/05/19 01:12:53
- ***************
- *** 7,13 ****
-
- This is c2man, a program for generating Unix style manual pages in nroff/troff
- -man, TeXinfo or LaTeX format directly from ordinary comments embedded in C
- ! source code. It should run on virtually any Unix-like system, OS/2 or MSDOS.
-
- You will need lex or flex, plus yacc or bison, and a C compiler (traditional
- K&R 1 or ISO/ANSI will do) to build the program. You'll also need a text
- --- 7,14 ----
-
- This is c2man, a program for generating Unix style manual pages in nroff/troff
- -man, TeXinfo or LaTeX format directly from ordinary comments embedded in C
- ! source code. It should run on virtually any Unix-like system, OS/2, VMS or
- ! MSDOS.
-
- You will need lex or flex, plus yacc or bison, and a C compiler (traditional
- K&R 1 or ISO/ANSI will do) to build the program. You'll also need a text
- ***************
- *** 58,64 ****
- answering them again for other people. I encourage you to go ahead and make
- any changes you like and send me the diffs for inclusion in the next patch, but
- it's a good idea to ask first in case someone already has the feature you want
- ! in the works. Changes need to be reasonably "clean" for me to integrate them.
-
- Please try to remember to include the c2man version number in any bug reports.
- You can find it by running: c2man -V /dev/null
- --- 59,66 ----
- answering them again for other people. I encourage you to go ahead and make
- any changes you like and send me the diffs for inclusion in the next patch, but
- it's a good idea to ask first in case someone already has the feature you want
- ! in the works. In order for me to integrate your changes, they need to be
- ! reasonably "clean", and you'll need to update manual page as appropriate.
-
- Please try to remember to include the c2man version number in any bug reports.
- You can find it by running: c2man -V /dev/null
- ***************
- *** 72,79 ****
- --- 74,83 ----
- metaconfig, which generated the Configure script.
-
- Darrel Hankerson for the OS/2 and MSDOS ports.
- + Rick Flower for the VMS port.
-
- Richard Kooijman for the LaTeX backend, and for fixing the TeXinfo backend.
- + Diab Jerius too, for more work on the TeXinfo backend.
-
- Vern Paxson for his suggestions on how to handle comments lexing better.
-
- ***************
- *** 88,93 ****
- --- 92,98 ----
-
- See the file INSTALL for Unix installation instructions.
- OS/2 and MSDOS users should see the README.pc file in the pc directory.
- + VMS users should see the README.1st in the VMS directory.
-
-
- Graham Stoney greyham@research.canon.oz.au
-
- Index: config_h.SH
- Prereq: 2.0.1.14
- *** config_h.SH.old 1993/11/08 09:11:12
- --- config_h.SH 1994/05/20 01:18:45
- ***************
- *** 25,31 ****
- * that running config.h.SH again will wipe out any changes you've made.
- * For a more permanent change edit config.sh and rerun config.h.SH.
- *
- ! * \$Id: config_h.SH,v 2.0.1.14 1993/11/08 09:11:12 greyham Exp $
- */
-
- /* Configuration time: $cf_time
- --- 25,31 ----
- * that running config.h.SH again will wipe out any changes you've made.
- * For a more permanent change edit config.sh and rerun config.h.SH.
- *
- ! * \$Id: config_h.SH,v 2.0.1.16 1994/05/20 01:18:45 greyham Exp $
- */
-
- /* Configuration time: $cf_time
- ***************
- *** 36,45 ****
- --- 36,50 ----
- #ifndef _config_h_
- #define _config_h_
-
- + /* VMS:
- + * This symbol, if defined, indicates that the program is running under
- + * VMS. It is currently only set in conjunction with the EUNICE symbol.
- + */
- /* BSD:
- * This symbol, if defined, indicates that the program is running under
- * a BSD system.
- */
- + #$d_eunice VMS /**/
- #$d_bsd BSD /**/
-
- /* CPP_FILE_COM:
- ***************
- *** 158,169 ****
- */
- #$i_fcntl I_FCNTL /**/
-
- - /* I_STDARG:
- - * This symbol, if defined, indicates that <stdarg.h> exists and should
- - * be included.
- - */
- - #$i_stdarg I_STDARG /**/
- -
- /* I_STDDEF:
- * This symbol, if defined, indicates that <stddef.h> exists and should
- * be included.
- --- 163,168 ----
- ***************
- *** 211,221 ****
- */
- #$i_unistd I_UNISTD /**/
-
- /* I_VARARGS:
- * This symbol, if defined, indicates to the C program that it should
- * include <varargs.h>.
- */
- ! #$i_varargs I_VARARGS /**/
-
- /* CAN_PROTOTYPE:
- * If defined, this macro indicates that the C compiler can handle
- --- 210,225 ----
- */
- #$i_unistd I_UNISTD /**/
-
- + /* I_STDARG:
- + * This symbol, if defined, indicates that <stdarg.h> exists and should
- + * be included.
- + */
- /* I_VARARGS:
- * This symbol, if defined, indicates to the C program that it should
- * include <varargs.h>.
- */
- ! #$i_stdarg I_STDARG /**/
- ! #$i_varargs I_VARARGS /**/
-
- /* CAN_PROTOTYPE:
- * If defined, this macro indicates that the C compiler can handle
-
- Index: vms/make.com
- *** vms/make.com.old 1994/05/19 01:11:00
- --- vms/make.com 1994/05/19 01:11:02
- ***************
- *** 0 ****
- --- 1,56 ----
- + $!-----------------------------
- + $! Generate the C2MAN.EXE
- + $!-----------------------------
- + $!CC = "CC" ! Uncomment if using VAX-C
- + $ CC = "GCC" ! Uncomment if using GCC
- + $!-----------------------------
- + $ CFLAGS = "/Include=([.VMS],[.LIBC])/NOOPT"
- + $!CFLAGS = "/Include=([.VMS],[.LIBC])/NOOPT/DEBUG"
- + $!-----------------------------
- + $!OPTFILE= "[.VMS]C2MAN.OPT-VAXC" ! Uncomment if using VAX-C
- + $ OPTFILE= "[.VMS]C2MAN.OPT-GCC" ! Uncomment if using GCC
- + $!-----------------------------
- + $ LFLAGS = "/NOMAP"
- + $!LFLAGS = "/DEBUG/NOMAP" ! Uncomment if you want /DEBUG
- + $!-----------------------------
- + $ BFLAGS = "/NOLINES" ! Don't uncomment.. otherwise linker errors!
- + $ ECHO := "WRITE SYS$OUTPUT"
- + $!
- + $ ECHO "Compiling GETOPT.C..."
- + $ 'CC' 'CFLAGS' [.LIBC]GETOPT.C
- + $ ECHO "Compiling ALLOCA.C..."
- + $ 'CC' 'CFLAGS' [.LIBC]ALLOCA.C
- + $ ECHO "Compiling POPEN.C..."
- + $ 'CC' 'CFLAGS' [.VMS]POPEN.C
- + $ ECHO "Compiling C2MAN.C..."
- + $ 'CC' 'CFLAGS' C2MAN
- + $ ECHO "Compiling ENUM.C..."
- + $ 'CC' 'CFLAGS' ENUM
- + $ ECHO "Compiling LATEX.C..."
- + $ 'CC' 'CFLAGS' LATEX
- + $ ECHO "Compiling MANPAGE.C..."
- + $ 'CC' 'CFLAGS' MANPAGE
- + $ ECHO "Compiling NROFF.C..."
- + $ 'CC' 'CFLAGS' NROFF
- + $ ECHO "Compiling SEMANTIC.C..."
- + $ 'CC' 'CFLAGS' SEMANTIC
- + $ ECHO "Compiling STRAPPEND.C..."
- + $ 'CC' 'CFLAGS' STRAPPEND
- + $ ECHO "Compiling STRCONCAT.C..."
- + $ 'CC' 'CFLAGS' STRCONCAT
- + $ ECHO "Compiling STRING.C..."
- + $ 'CC' 'CFLAGS' STRING
- + $ ECHO "Compiling SYMBOL.C..."
- + $ 'CC' 'CFLAGS' SYMBOL
- + $ ECHO "Compiling TEXINFO.C..."
- + $ 'CC' 'CFLAGS' TEXINFO
- + $ ECHO "Invoking Bison.. Expect 54 Shift/reduce conflicts..."
- + $ BISON 'BFLAGS' GRAMMAR.Y
- + $ ECHO "Invoking Flex..."
- + $ FLEX -n LEX.L
- + $ ECHO "Compiling GRAMMAR_TAB.C (results of Bison & Flex)..."
- + $ 'CC' 'CFLAGS' GRAMMAR_TAB
- + $ ECHO "Linking C2MAN..."
- + $ LINK 'OPTFILE'/OPT'LFLAGS'
- + $ ECHO "Done.."
- + $ EXIT
-
- Index: MANIFEST
- *** MANIFEST.old 1994/04/20 08:11:48
- --- MANIFEST 1994/05/20 01:21:39
- ***************
- *** 35,52 ****
- nroff.c Backend for nroff output.
- texinfo.c Backend for texinfo output.
- latex.c Backend for LaTeX output.
- ! pc/COPYING GPL to cover the PC port library routines.
- ! pc/Makefile.pc Makefile for OS/2 and MSDOS.
- pc/README.pc README file for OS/2 and MSDOS.
- pc/c2man-32.def Definitions for EMX/gcc.
- pc/c2man.def Definitions for Microsoft C.
- pc/config.h Configuration header for OS/2 & MSDOS.
- - pc/getopt.c getopt support for OS/2 & MSDOS.
- - pc/getopt.h ...
- - pc/getopt1.c ...
- pc/popen.c popen support for OS/2 & MSDOS.
- pc/popen.h ...
- ! eg/boxcomment.c Example input files...
- eg/ccomment.h
- eg/commentaft.c
- eg/cppcomment.h
- --- 35,61 ----
- nroff.c Backend for nroff output.
- texinfo.c Backend for texinfo output.
- latex.c Backend for LaTeX output.
- ! libc/README.libc Info about library routines which may help.
- ! libc/COPYING GPL to cover the GNU-derived library routines.
- ! libc/getopt.c getopt support for OS/2, MSDOS & VMS.
- ! libc/getopt.h ...
- ! libc/getopt1.c ...
- ! libc/alloca.c Portable alloca() routine.
- pc/README.pc README file for OS/2 and MSDOS.
- + pc/Makefile.pc Makefile for OS/2 and MSDOS.
- + pc/updmake perl script used to regenerate pc/Makefile.pc.
- pc/c2man-32.def Definitions for EMX/gcc.
- pc/c2man.def Definitions for Microsoft C.
- pc/config.h Configuration header for OS/2 & MSDOS.
- pc/popen.c popen support for OS/2 & MSDOS.
- pc/popen.h ...
- ! vms/readme.1st README for VMS port.
- ! vms/make.com Build program for VMS.
- ! vms/c2man.opt-gcc LINK options file for GCC on VMS.
- ! vms/c2man.opt-vaxc LINK options file for VAX-C on VMS.
- ! vms/config.h Config file for VMS compilation.
- ! vms/popen.c popen/pclose routines for VMS.
- ! eg/boxcomment.c Example input files...
- eg/ccomment.h
- eg/commentaft.c
- eg/cppcomment.h
-
- Index: latex.c
- Prereq: 2.0.1.3
- *** latex.c.old 1994/02/22 00:26:17
- --- latex.c 1994/05/12 02:25:13
- ***************
- *** 1,4 ****
- ! /* $Id: latex.c,v 2.0.1.3 1994/02/22 00:26:17 greyham Exp $
- * functions for LaTeX style output.
- */
- #include "c2man.h"
- --- 1,4 ----
- ! /* $Id: latex.c,v 2.0.1.4 1994/05/12 02:25:13 greyham Exp $
- * functions for LaTeX style output.
- */
- #include "c2man.h"
- ***************
- *** 49,54 ****
- --- 49,56 ----
- const char *name;
- const char *section;
- {
- + if (make_embeddable) return;
- +
- put_string("\\documentstyle{article}\n");
- output_warning();
- put_string("\\begin{document}\n");
- ***************
- *** 134,139 ****
- --- 136,155 ----
-
- void latex_file_end() { put_string("\\end{document}\n"); }
-
- + void latex_name(name)
- + const char *name;
- + {
- + if (name) latex_text(name);
- + else latex_section("NAME");
- + }
- +
- + void latex_terse_sep()
- + {
- + latex_char(' ');
- + latex_dash();
- + latex_char(' ');
- + }
- +
-
- struct Output latex_output =
- {
- ***************
- *** 164,168 ****
- latex_include,
- latex_file_end,
- latex_text,
- ! latex_char
- };
- --- 180,188 ----
- latex_include,
- latex_file_end,
- latex_text,
- ! latex_char,
- ! NULL, /* latex_parse_option */
- ! dummy, /* latex_print_option */
- ! latex_name,
- ! latex_terse_sep
- };
-
- Index: nroff.c
- Prereq: 2.0.1.8
- *** nroff.c.old 1994/02/23 04:38:09
- --- nroff.c 1994/05/12 02:25:07
- ***************
- *** 1,4 ****
- ! /* $Id: nroff.c,v 2.0.1.8 1994/02/23 04:38:09 greyham Exp $
- * functions for nroff style output.
- */
- #include "c2man.h"
- --- 1,4 ----
- ! /* $Id: nroff.c,v 2.0.1.9 1994/05/12 02:25:07 greyham Exp $
- * functions for nroff style output.
- */
- #include "c2man.h"
- ***************
- *** 38,43 ****
- --- 38,45 ----
- Time_t raw_time;
- struct tm *filetime;
-
- + if (make_embeddable) return;
- +
- output_warning();
- put_string(".TH \"");
-
- ***************
- *** 168,173 ****
- --- 170,189 ----
- printf(".so %s\n", filename);
- }
-
- + void nroff_name(name)
- + const char *name;
- + {
- + if (name) nroff_text(name);
- + else nroff_section("NAME");
- + }
- +
- + void nroff_terse_sep()
- + {
- + nroff_char(' ');
- + nroff_dash();
- + nroff_char(' ');
- + }
- +
- struct Output nroff_output =
- {
- nroff_comment,
- ***************
- *** 197,201 ****
- nroff_include,
- dummy, /* nroff_file_end */
- nroff_text,
- ! nroff_char
- };
- --- 213,221 ----
- nroff_include,
- dummy, /* nroff_file_end */
- nroff_text,
- ! nroff_char,
- ! NULL, /* nroff_parse_option */
- ! dummy, /* nroff_print_options */
- ! nroff_name,
- ! nroff_terse_sep
- };
-
- Index: c2man.h
- Prereq: 2.0.1.15
- *** c2man.h.old 1994/01/07 07:04:30
- --- c2man.h 1994/05/12 02:23:21
- ***************
- *** 1,4 ****
- ! /* $Id: c2man.h,v 2.0.1.15 1994/01/07 07:04:30 greyham Exp $
- *
- * Definitions for C language manual page generator
- */
- --- 1,4 ----
- ! /* $Id: c2man.h,v 2.0.1.16 1994/05/12 02:23:21 greyham Exp $
- *
- * Definitions for C language manual page generator
- */
- ***************
- *** 204,209 ****
- --- 204,216 ----
- char *subdir; /* subdirectory */
- };
-
- + /* list of sections to exclude */
- + typedef struct ExcludeSection
- + {
- + char *name;
- + struct ExcludeSection *next;
- + } ExcludeSection;
- +
- #define YYSTYPE yystype
-
- /* Program options */
- ***************
- *** 218,223 ****
- --- 225,231 ----
- extern const char *progname;
- extern char *header_prefix;
- extern IncludeFile *first_include;
- + extern ExcludeSection *first_excluded_section;
-
- extern char *group_terse;
- extern boolean group_together;
- ***************
- *** 240,245 ****
- --- 248,255 ----
- extern boolean use_input_name;
- extern boolean make_embeddable;
- extern struct Output_Object_Info output_object[_OBJECT_NUM];
- +
- +
-
- /* Output a string to standard output. */
- #define put_string(s) fputs(s, stdout)
-
- Index: pc/README.pc
- *** pc/README.pc.old 1993/08/25 09:21:54
- --- pc/README.pc 1994/05/16 04:58:02
- ***************
- *** 2,13 ****
- DOS, using EMX/gcc or Microsoft C. The popen.c routines are adapted
- from the versions supplied with GNU awk, and are needed for
- executables which run under DOS. The getopt routines (needed for MSC)
- ! are adapted from the GNU versions.
-
- ! To install, copy these files to the directory containing the
- ! sources for c2man, and use
- ! make -f Makefile.pc
- ! to see a list of targets.
-
- This version is still in beta-test.
-
- --- 2,16 ----
- DOS, using EMX/gcc or Microsoft C. The popen.c routines are adapted
- from the versions supplied with GNU awk, and are needed for
- executables which run under DOS. The getopt routines (needed for MSC)
- ! are in the libc directory.
-
- ! To install:
- !
- ! 1. copy these files to the directory containing the sources for c2man
- ! 2. copy getopt*.* from the libc directory to the c2man directory too
- ! 3. use
- ! make -f Makefile.pc
- ! to see a list of targets.
-
- This version is still in beta-test.
-
-
- Index: output.h
- Prereq: 2.0.1.5
- *** output.h.old 1994/01/07 07:05:51
- --- output.h 1994/05/12 02:25:03
- ***************
- *** 1,4 ****
- ! /* $Id: output.h,v 2.0.1.5 1994/01/07 07:05:51 greyham Exp $
- * format-independant output interface.
- */
- #ifndef OUTPUT_H
- --- 1,4 ----
- ! /* $Id: output.h,v 2.0.1.6 1994/05/12 02:25:03 greyham Exp $
- * format-independant output interface.
- */
- #ifndef OUTPUT_H
- ***************
- *** 111,116 ****
- --- 111,128 ----
-
- /* output char, quoted to protect against formatter controls */
- void (*character) _((const int c));
- +
- + /* parse formatter specific option. set to NULL if not available */
- + int (*parse_option) _((const char *option));
- +
- + /* print formatter specific options to stderr. */
- + void (*print_options) _((void));
- +
- + /* output NAME section header and section names */
- + void (*name) _((const char *name));
- +
- + /* output separators between section name and terse description */
- + void (*terse_sep) _((void));
- };
-
- /* pointer to the relevant output structure */
-
- Index: grammar.y
- Prereq: 2.0.1.14
- *** grammar.y.old 1993/12/16 03:38:53
- --- grammar.y 1994/05/19 01:15:15
- ***************
- *** 1,4 ****
- ! /* $Id: grammar.y,v 2.0.1.14 1993/12/16 03:38:53 greyham Exp $
- *
- * yacc grammar for C manual page generator
- * This was derived from the grammar given in Appendix A of
- --- 1,4 ----
- ! /* $Id: grammar.y,v 2.0.1.15 1994/05/19 01:15:15 greyham Exp $
- *
- * yacc grammar for C manual page generator
- * This was derived from the grammar given in Appendix A of
- ***************
- *** 771,778 ****
- #ifdef MSDOS
- #include "lex_yy.c"
- #else
- #include "lex.yy.c"
- ! #endif
-
- #ifdef I_STDARG
- void yyerror(const char *format, ...)
- --- 771,782 ----
- #ifdef MSDOS
- #include "lex_yy.c"
- #else
- + #ifdef VMS
- + #include "lexyy.c"
- + #else
- #include "lex.yy.c"
- ! #endif /* !VMS */
- ! #endif /* !MSDOS */
-
- #ifdef I_STDARG
- void yyerror(const char *format, ...)
-
- Index: libc/README.libc
- *** libc/README.libc.old 1994/05/16 04:16:37
- --- libc/README.libc 1994/05/16 04:54:32
- ***************
- *** 0 ****
- --- 1,10 ----
- + This directory contains sources for library routines which some users have
- + found to be missing on their machines.
- +
- + Since some of this code is covered by the GNU General Public License, a copy
- + is included in the file COPYING. Note that only those files in the c2man
- + distribution which explicitly state that they fall under the terms of this
- + license actually do so.
- +
- + The getopt routines (needed for MSC on the PC, and for VMS) are adapted from
- + the GNU versions.
-
- Index: vms/c2man.opt-gcc
- *** vms/c2man.opt-gcc.old 1994/05/19 01:09:28
- --- vms/c2man.opt-gcc 1994/05/19 01:09:52
- ***************
- *** 0 ****
- --- 1,17 ----
- + c2man
- + enum
- + latex
- + manpage
- + nroff
- + semantic
- + strappend
- + strconcat
- + string
- + symbol
- + texinfo
- + grammar_tab
- + getopt
- + popen
- + alloca
- + gnu_cc:[000000]gcclib.olb/lib
- + sys$library:vaxcrtl.olb/lib
-
- Index: vms/c2man.opt-vaxc
- *** vms/c2man.opt-vaxc.old 1994/05/19 01:10:15
- --- vms/c2man.opt-vaxc 1994/05/19 01:10:24
- ***************
- *** 0 ****
- --- 1,16 ----
- + c2man
- + enum
- + latex
- + manpage
- + nroff
- + semantic
- + strappend
- + strconcat
- + string
- + symbol
- + texinfo
- + grammar_tab
- + getopt
- + popen
- + alloca
- + sys$library:vaxcrtl.olb/lib
-
- *** End of Patch 30 ***
- --
- Graham Stoney, Hardware/Software Engineer
- Canon Information Systems Research Australia
- Ph: + 61 2 805 2909 Fax: + 61 2 805 2929
-
- exit 0 # Just in case...
-