home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume43 / c2man-2.0 / patch30 < prev    next >
Encoding:
Internet Message Format  |  1994-06-10  |  25.2 KB

  1. From: greyham@research.canon.oz.au (Graham Stoney)
  2. Newsgroups: comp.sources.misc
  3. Subject: v43i023:  c2man-2.0 - automatic C documentation generator, Patch30
  4. Date: 9 Jun 1994 11:50:41 -0500
  5. Organization: Canon Information Systems Research Australia
  6. Sender: kent@sparky.sterling.com
  7. Approved: kent@sparky.sterling.com
  8. Message-ID: <2t7h91$3e9@sparky.sterling.com>
  9. Summary: This is an official patch for c2man 2.0.  Please apply it.
  10. X-Md4-Signature: db62112288fd7c32be7d982624c9f676
  11.  
  12. Submitted-by: greyham@research.canon.oz.au (Graham Stoney)
  13. Posting-number: Volume 43, Issue 23
  14. Archive-name: c2man-2.0/patch30
  15. Environment: UNIX, DOS, OS/2, lex, yacc
  16. Patch-To: c2man-2.0: Volume 42, Issue 55-63
  17.  
  18. System: c2man version 2.0
  19. Patch #: 30
  20. Priority: LOW
  21. Subject: patch #28, continued
  22. Date: Fri May 20 11:39:17 EST 1994
  23. From: Graham Stoney <greyham@research.canon.oz.au>
  24.  
  25. Description:
  26.     See patch #28.
  27.  
  28.  
  29. Fix:    From rn, say "| patch -p -N -d DIR", where DIR is your c2man source
  30.     directory.  Outside of rn, say "cd DIR; patch -p -N <thisarticle".
  31.     If you don't have the patch program, apply the following by hand,
  32.     or get patch (version 2.0, latest patchlevel).
  33.  
  34.     After patching:
  35.         *** NOTE: YOU MUST AT LEAST RUN Configure AFTER APPLYING ***
  36.         *** THIS PATCH BEFORE APPLYING ANY SUBSEQUENT PATCHES.   ***
  37.  
  38.         Configure -ders
  39.         make depend
  40.         make
  41.         make test
  42.         make install
  43.  
  44.     If patch indicates that patchlevel is the wrong version, you may need
  45.     to apply one or more previous patches, or the patch may already
  46.     have been applied.  See the patchlevel.h file to find out what has or
  47.     has not been applied.  In any event, don't continue with the patch.
  48.  
  49.     If you are missing previous patches they can be obtained from me:
  50.  
  51.         Graham Stoney <greyham@research.canon.oz.au>
  52.  
  53.     If you send a mail message of the following form it will greatly speed
  54.     processing:
  55.  
  56.         Subject: Command
  57.         @SH mailpatch PATH c2man 2.0 LIST
  58.                ^ note the c
  59.  
  60.     where PATH is a return path FROM ME TO YOU either in Internet notation,
  61.     or in bang notation from some well-known host, and LIST is the number
  62.     of one or more patches you need, separated by spaces, commas, and/or
  63.     hyphens.  Saying 35- says everything from 35 to the end.
  64.  
  65.     To get some more detailed instructions, send me the following mail:
  66.  
  67.         Subject: Command
  68.         @SH mailhelp PATH
  69.  
  70.  
  71. Index: patchlevel.h
  72. Prereq: 29
  73. 2c2
  74. < #define PATCHLEVEL 29
  75. ---
  76. > #define PATCHLEVEL 30
  77.  
  78. Index: c2man.1
  79. Prereq: 2.0.1.36
  80. *** c2man.1.old    1994/01/13 05:20:40
  81. --- c2man.1    1994/05/12 02:21:13
  82. ***************
  83. *** 1,4 ****
  84. ! .\" $Id: c2man.1,v 2.0.1.36 1994/01/13 05:20:40 greyham Exp $
  85.   .de EX          \"Begin example
  86.   .br
  87.   .if \\$1 .ne \\$1
  88. --- 1,4 ----
  89. ! .\" $Id: c2man.1,v 2.0.1.37 1994/05/12 02:21:13 greyham Exp $
  90.   .de EX          \"Begin example
  91.   .br
  92.   .if \\$1 .ne \\$1
  93. ***************
  94. *** 52,58 ****
  95.   .if t .sp .5
  96.   .fi
  97.   ..
  98. ! .TH C2MAN 1 "January 12, 1994"
  99.   .BY "CISRA"
  100.   .SH NAME
  101.   c2man \- generate manual pages from C source code
  102. --- 52,58 ----
  103.   .if t .sp .5
  104.   .fi
  105.   ..
  106. ! .TH C2MAN 1 "May 12, 1994"
  107.   .BY "CISRA"
  108.   .SH NAME
  109.   c2man \- generate manual pages from C source code
  110. ***************
  111. *** 530,535 ****
  112. --- 530,540 ----
  113.   If using the second form, you may need to quote the quotation marks, lest they
  114.   get removed by the shell.
  115.   .TP
  116. + .BI \-x sectionname
  117. + Exclude
  118. + .I sectionname
  119. + from the generated manpages.  This option may be repeated.
  120. + .TP
  121.   .BI \-H header-path
  122.   Prepend
  123.   .B header-path
  124. ***************
  125. *** 548,563 ****
  126.   parameters with no comment are described as ``Not Documented.'', to encourage
  127.   the programmer to comment them.
  128.   .TP
  129. ! .B \-T n|l|t
  130. ! Set the output typesetting language.
  131.   .B Nroff
  132.   .RB ( n )
  133.   is the default, 
  134.   .B LaTeX
  135.   .RB ( l )
  136.   , or
  137. ! .B texinfo
  138.   .RB ( t ).
  139.   .TP
  140.   .BI \-e
  141.   Prepares the output so it can be embedded in texts of the output typesetting
  142. --- 553,607 ----
  143.   parameters with no comment are described as ``Not Documented.'', to encourage
  144.   the programmer to comment them.
  145.   .TP
  146. ! .BI \-Tn|l|t[, options ]
  147. ! Set the output typesetting language as well as language specific
  148. ! options.
  149. ! .I options
  150. ! is a comma delimited list of options.
  151.   .B Nroff
  152.   .RB ( n )
  153.   is the default, 
  154.   .B LaTeX
  155.   .RB ( l )
  156.   , or
  157. ! .B Texinfo
  158.   .RB ( t ).
  159. + .B Texinfo
  160. + specific options are 
  161. + .BR s ,
  162. + .BR t ,
  163. + and
  164. + .BR n.
  165. + In 
  166. + .B Texinfo
  167. + mode, each section is normally coded as a ``heading'' rather than a
  168. + ``section''.  This prevents the section name from appearing in the
  169. + table of contents.  If the option
  170. + .B t
  171. + is given, the name of the manpage is used for the title of the
  172. + .B NAME
  173. + section, and is encoded as a ``section'', placing it in
  174. + the table of contents.  Subsequent sections are encoded as ``headings''.  
  175. + .B Texinfo
  176. + supports multiple levels of headings; the desired level may be
  177. + specified via the 
  178. + .BI s n
  179. + option, where
  180. + .I n
  181. + starts at 0 for the ``chapter level'' and works down.  A
  182. + top level node is created for the manpage, except when in embedded
  183. + mode
  184. + (the 
  185. + .B c2man \-e
  186. + option).  If the 
  187. + .B n
  188. + option is specified, a node is created in embedded mode, but
  189. + without Up, Previous, or Next pointers;  these must be filled in
  190. + .BR ( Texinfo
  191. + mode in 
  192. + .B emacs
  193. + does a good job of it).
  194.   .TP
  195.   .BI \-e
  196.   Prepares the output so it can be embedded in texts of the output typesetting
  197. ***************
  198. *** 572,578 ****
  199.   defaults to ``3'' for
  200.   .BR nroff ,
  201.   ``texi'' for
  202. ! .B TeXinfo
  203.   and ``tex'' for
  204.   .B LaTeX
  205.   output, as specified via the
  206. --- 616,622 ----
  207.   defaults to ``3'' for
  208.   .BR nroff ,
  209.   ``texi'' for
  210. ! .B Texinfo
  211.   and ``tex'' for
  212.   .B LaTeX
  213.   output, as specified via the
  214.  
  215. Index: catalog
  216. *** catalog.old    1994/04/18 04:45:54
  217. --- catalog    1994/05/19 01:13:58
  218. ***************
  219. *** 1,14 ****
  220.   language:    C, nroff, texinfo, latex
  221.   package:    c2man
  222. ! version:    2.0 patchlevel 26
  223.   parts:        documentation generator (C -> nroff -man, -> texinfo, -> latex)
  224.   author:        Graham Stoney <greyham@research.canon.oz.au>
  225. ! how to get:    ftp /pub/Unix/Util/c2man-2.0.*.tar.gz from dnpap.et.tudelft.nl
  226. !     N.America:    ftp usenet/comp.sources.reviewed/volume03/c2man*
  227.           from ftp.wustl.edu
  228. !     Europe:    ftp /pub/archive/comp.sources/reviewed/c2man* 
  229. !         from ftp.informatik.uni-stuttgart.de
  230. !     Japan:    ftp /pub/NetNews/comp.sources.reviewed/volume3/c2man*
  231.           from ftp.iij.ad.jp
  232.       Patches:    ftp pub/netnews/sources.bugs/volume93/sep/c2man* from lth.se
  233.   description:    c2man is an automatic documentation tool that extracts comments
  234. --- 1,18 ----
  235.   language:    C, nroff, texinfo, latex
  236.   package:    c2man
  237. ! version:    2.0 patchlevel 28
  238.   parts:        documentation generator (C -> nroff -man, -> texinfo, -> latex)
  239.   author:        Graham Stoney <greyham@research.canon.oz.au>
  240. ! how to get:    ftp from any comp.sources.misc archive, in volume42
  241. !         (the version in the comp.sources.reviewed archive is obsolete)
  242. !         ftp /pub/Unix/Util/c2man-2.0.*.tar.gz from ftp.et.tudelft.nl
  243. !     Australia:    ftp /usenet/comp.sources.misc/volume42/c2man-2.0/*
  244. !         from archie.au
  245. !     N.America:    ftp /usenet/comp.sources.misc/volume42/c2man-2.0/*
  246.           from ftp.wustl.edu
  247. !     Europe:    ftp /News/comp.sources.misc/volume42/c2man-2.0/*
  248. !         from ftp.irisa.fr
  249. !     Japan:    ftp /pub/NetNews/comp.sources.misc/volume42/c2man-2.0/*
  250.           from ftp.iij.ad.jp
  251.       Patches:    ftp pub/netnews/sources.bugs/volume93/sep/c2man* from lth.se
  252.   description:    c2man is an automatic documentation tool that extracts comments
  253. ***************
  254. *** 27,37 ****
  255.           + handles C (/* */) and C++ (//) style comments
  256.           - doesn't handle C++ grammar (yet)
  257.   requires:    yacc/byacc/bison, lex/flex, and nroff/groff/texinfo/LaTeX.
  258. ! ports:        Unix, OS/2, MSDOS
  259.   portability:    very high for unix, via Configure
  260.   status:        actively developed; contributions by users are encouraged.
  261.   discussion:    send "subscribe c2man <Your Name>" (in the message body) to
  262.           listserv@research.canon.oz.au
  263. ! announcements:    patches appear first in comp.sources.bugs, later in
  264. !         comp.sources.reviewed after a review period.
  265. ! updated:    1994/02/22
  266. --- 31,41 ----
  267.           + handles C (/* */) and C++ (//) style comments
  268.           - doesn't handle C++ grammar (yet)
  269.   requires:    yacc/byacc/bison, lex/flex, and nroff/groff/texinfo/LaTeX.
  270. ! ports:        Unix, OS/2, MSDOS, VMS.
  271.   portability:    very high for unix, via Configure
  272.   status:        actively developed; contributions by users are encouraged.
  273.   discussion:    send "subscribe c2man <Your Name>" (in the message body) to
  274.           listserv@research.canon.oz.au
  275. ! announcements:    patches appear first in comp.sources.bugs, and then in
  276. !         comp.sources.misc.
  277. ! updated:    1994/05/12
  278.  
  279. Index: README
  280. *** README.old    1994/04/18 23:58:45
  281. --- README    1994/05/19 01:12:53
  282. ***************
  283. *** 7,13 ****
  284.   
  285.   This is c2man, a program for generating Unix style manual pages in nroff/troff
  286.   -man, TeXinfo or LaTeX format directly from ordinary comments embedded in C
  287. ! source code. It should run on virtually any Unix-like system, OS/2 or MSDOS.
  288.   
  289.   You will need lex or flex, plus yacc or bison, and a C compiler (traditional
  290.   K&R 1 or ISO/ANSI will do) to build the program. You'll also need a text
  291. --- 7,14 ----
  292.   
  293.   This is c2man, a program for generating Unix style manual pages in nroff/troff
  294.   -man, TeXinfo or LaTeX format directly from ordinary comments embedded in C
  295. ! source code. It should run on virtually any Unix-like system, OS/2, VMS or
  296. !  MSDOS.
  297.   
  298.   You will need lex or flex, plus yacc or bison, and a C compiler (traditional
  299.   K&R 1 or ISO/ANSI will do) to build the program. You'll also need a text
  300. ***************
  301. *** 58,64 ****
  302.   answering them again for other people.  I encourage you to go ahead and make
  303.   any changes you like and send me the diffs for inclusion in the next patch, but
  304.   it's a good idea to ask first in case someone already has the feature you want
  305. ! in the works.  Changes need to be reasonably "clean" for me to integrate them.
  306.   
  307.   Please try to remember to include the c2man version number in any bug reports.
  308.   You can find it by running: c2man -V /dev/null
  309. --- 59,66 ----
  310.   answering them again for other people.  I encourage you to go ahead and make
  311.   any changes you like and send me the diffs for inclusion in the next patch, but
  312.   it's a good idea to ask first in case someone already has the feature you want
  313. ! in the works.  In order for me to integrate your changes, they need to be
  314. ! reasonably "clean", and you'll need to update manual page as appropriate.
  315.   
  316.   Please try to remember to include the c2man version number in any bug reports.
  317.   You can find it by running: c2man -V /dev/null
  318. ***************
  319. *** 72,79 ****
  320. --- 74,83 ----
  321.       metaconfig, which generated the Configure script.
  322.   
  323.       Darrel Hankerson for the OS/2 and MSDOS ports.
  324. +     Rick Flower for the VMS port.
  325.   
  326.       Richard Kooijman for the LaTeX backend, and for fixing the TeXinfo backend.
  327. +     Diab Jerius too, for more work on the TeXinfo backend.
  328.   
  329.       Vern Paxson for his suggestions on how to handle comments lexing better.
  330.   
  331. ***************
  332. *** 88,93 ****
  333. --- 92,98 ----
  334.   
  335.   See the file INSTALL for Unix installation instructions.
  336.   OS/2 and MSDOS users should see the README.pc file in the pc directory.
  337. + VMS users should see the README.1st in the VMS directory.
  338.   
  339.   
  340.   Graham Stoney                       greyham@research.canon.oz.au
  341.  
  342. Index: config_h.SH
  343. Prereq: 2.0.1.14
  344. *** config_h.SH.old    1993/11/08 09:11:12
  345. --- config_h.SH    1994/05/20 01:18:45
  346. ***************
  347. *** 25,31 ****
  348.    * that running config.h.SH again will wipe out any changes you've made.
  349.    * For a more permanent change edit config.sh and rerun config.h.SH.
  350.    *
  351. !  * \$Id: config_h.SH,v 2.0.1.14 1993/11/08 09:11:12 greyham Exp $
  352.    */
  353.   
  354.   /* Configuration time: $cf_time
  355. --- 25,31 ----
  356.    * that running config.h.SH again will wipe out any changes you've made.
  357.    * For a more permanent change edit config.sh and rerun config.h.SH.
  358.    *
  359. !  * \$Id: config_h.SH,v 2.0.1.16 1994/05/20 01:18:45 greyham Exp $
  360.    */
  361.   
  362.   /* Configuration time: $cf_time
  363. ***************
  364. *** 36,45 ****
  365. --- 36,50 ----
  366.   #ifndef _config_h_
  367.   #define _config_h_
  368.   
  369. + /* VMS:
  370. +  *    This symbol, if defined, indicates that the program is running under
  371. +  *    VMS.  It is currently only set in conjunction with the EUNICE symbol.
  372. +  */
  373.   /* BSD:
  374.    *    This symbol, if defined, indicates that the program is running under
  375.    *    a BSD system.
  376.    */
  377. + #$d_eunice VMS        /**/
  378.   #$d_bsd BSD        /**/
  379.   
  380.   /* CPP_FILE_COM:
  381. ***************
  382. *** 158,169 ****
  383.    */
  384.   #$i_fcntl I_FCNTL    /**/
  385.   
  386. - /* I_STDARG:
  387. -  *    This symbol, if defined, indicates that <stdarg.h> exists and should
  388. -  *    be included.
  389. -  */
  390. - #$i_stdarg I_STDARG        /**/
  391.   /* I_STDDEF:
  392.    *    This symbol, if defined, indicates that <stddef.h> exists and should
  393.    *    be included.
  394. --- 163,168 ----
  395. ***************
  396. *** 211,221 ****
  397.    */
  398.   #$i_unistd I_UNISTD        /**/
  399.   
  400.   /* I_VARARGS:
  401.    *    This symbol, if defined, indicates to the C program that it should
  402.    *    include <varargs.h>.
  403.    */
  404. ! #$i_varargs I_VARARGS        /**/
  405.   
  406.   /* CAN_PROTOTYPE:
  407.    *    If defined, this macro indicates that the C compiler can handle
  408. --- 210,225 ----
  409.    */
  410.   #$i_unistd I_UNISTD        /**/
  411.   
  412. + /* I_STDARG:
  413. +  *    This symbol, if defined, indicates that <stdarg.h> exists and should
  414. +  *    be included.
  415. +  */
  416.   /* I_VARARGS:
  417.    *    This symbol, if defined, indicates to the C program that it should
  418.    *    include <varargs.h>.
  419.    */
  420. ! #$i_stdarg I_STDARG        /**/
  421. ! #$i_varargs I_VARARGS    /**/
  422.   
  423.   /* CAN_PROTOTYPE:
  424.    *    If defined, this macro indicates that the C compiler can handle
  425.  
  426. Index: vms/make.com
  427. *** vms/make.com.old    1994/05/19 01:11:00
  428. --- vms/make.com    1994/05/19 01:11:02
  429. ***************
  430. *** 0 ****
  431. --- 1,56 ----
  432. + $!-----------------------------
  433. + $! Generate the C2MAN.EXE
  434. + $!-----------------------------
  435. + $!CC     = "CC"                    ! Uncomment if using VAX-C
  436. + $ CC     = "GCC"                ! Uncomment if using GCC
  437. + $!-----------------------------
  438. + $ CFLAGS = "/Include=([.VMS],[.LIBC])/NOOPT"
  439. + $!CFLAGS = "/Include=([.VMS],[.LIBC])/NOOPT/DEBUG"
  440. + $!-----------------------------
  441. + $!OPTFILE= "[.VMS]C2MAN.OPT-VAXC"        ! Uncomment if using VAX-C
  442. + $ OPTFILE= "[.VMS]C2MAN.OPT-GCC"        ! Uncomment if using GCC
  443. + $!-----------------------------
  444. + $ LFLAGS = "/NOMAP"
  445. + $!LFLAGS = "/DEBUG/NOMAP"            ! Uncomment if you want /DEBUG
  446. + $!-----------------------------
  447. + $ BFLAGS = "/NOLINES"                ! Don't uncomment.. otherwise linker errors!
  448. + $ ECHO     := "WRITE SYS$OUTPUT"
  449. + $!
  450. + $ ECHO "Compiling GETOPT.C..."
  451. + $ 'CC' 'CFLAGS' [.LIBC]GETOPT.C
  452. + $ ECHO "Compiling ALLOCA.C..."
  453. + $ 'CC' 'CFLAGS' [.LIBC]ALLOCA.C
  454. + $ ECHO "Compiling POPEN.C..."
  455. + $ 'CC' 'CFLAGS' [.VMS]POPEN.C
  456. + $ ECHO "Compiling C2MAN.C..."
  457. + $ 'CC' 'CFLAGS' C2MAN
  458. + $ ECHO "Compiling ENUM.C..."
  459. + $ 'CC' 'CFLAGS' ENUM
  460. + $ ECHO "Compiling LATEX.C..."
  461. + $ 'CC' 'CFLAGS' LATEX
  462. + $ ECHO "Compiling MANPAGE.C..."
  463. + $ 'CC' 'CFLAGS' MANPAGE
  464. + $ ECHO "Compiling NROFF.C..."
  465. + $ 'CC' 'CFLAGS' NROFF
  466. + $ ECHO "Compiling SEMANTIC.C..."
  467. + $ 'CC' 'CFLAGS' SEMANTIC
  468. + $ ECHO "Compiling STRAPPEND.C..."
  469. + $ 'CC' 'CFLAGS' STRAPPEND
  470. + $ ECHO "Compiling STRCONCAT.C..."
  471. + $ 'CC' 'CFLAGS' STRCONCAT
  472. + $ ECHO "Compiling STRING.C..."
  473. + $ 'CC' 'CFLAGS' STRING
  474. + $ ECHO "Compiling SYMBOL.C..."
  475. + $ 'CC' 'CFLAGS' SYMBOL
  476. + $ ECHO "Compiling TEXINFO.C..."
  477. + $ 'CC' 'CFLAGS' TEXINFO
  478. + $ ECHO "Invoking Bison.. Expect 54 Shift/reduce conflicts..."
  479. + $ BISON 'BFLAGS' GRAMMAR.Y
  480. + $ ECHO "Invoking Flex..."
  481. + $ FLEX -n LEX.L
  482. + $ ECHO "Compiling GRAMMAR_TAB.C (results of Bison & Flex)..."
  483. + $ 'CC' 'CFLAGS' GRAMMAR_TAB
  484. + $ ECHO "Linking C2MAN..."
  485. + $ LINK 'OPTFILE'/OPT'LFLAGS'
  486. + $ ECHO "Done.."
  487. + $ EXIT
  488.  
  489. Index: MANIFEST
  490. *** MANIFEST.old    1994/04/20 08:11:48
  491. --- MANIFEST    1994/05/20 01:21:39
  492. ***************
  493. *** 35,52 ****
  494.   nroff.c        Backend for nroff output.
  495.   texinfo.c    Backend for texinfo output.
  496.   latex.c        Backend for LaTeX output.
  497. ! pc/COPYING    GPL to cover the PC port library routines.
  498. ! pc/Makefile.pc    Makefile for OS/2 and MSDOS.
  499.   pc/README.pc    README file for OS/2 and MSDOS.
  500.   pc/c2man-32.def    Definitions for EMX/gcc.
  501.   pc/c2man.def    Definitions for Microsoft C.
  502.   pc/config.h    Configuration header for OS/2 & MSDOS.
  503. - pc/getopt.c    getopt support for OS/2 & MSDOS.
  504. - pc/getopt.h    ...
  505. - pc/getopt1.c    ...
  506.   pc/popen.c    popen support for OS/2 & MSDOS.
  507.   pc/popen.h    ...
  508. ! eg/boxcomment.c Example input files...
  509.   eg/ccomment.h
  510.   eg/commentaft.c
  511.   eg/cppcomment.h
  512. --- 35,61 ----
  513.   nroff.c        Backend for nroff output.
  514.   texinfo.c    Backend for texinfo output.
  515.   latex.c        Backend for LaTeX output.
  516. ! libc/README.libc Info about library routines which may help.
  517. ! libc/COPYING    GPL to cover the GNU-derived library routines.
  518. ! libc/getopt.c    getopt support for OS/2, MSDOS & VMS.
  519. ! libc/getopt.h    ...
  520. ! libc/getopt1.c    ...
  521. ! libc/alloca.c    Portable alloca() routine.
  522.   pc/README.pc    README file for OS/2 and MSDOS.
  523. + pc/Makefile.pc    Makefile for OS/2 and MSDOS.
  524. + pc/updmake    perl script used to regenerate pc/Makefile.pc.
  525.   pc/c2man-32.def    Definitions for EMX/gcc.
  526.   pc/c2man.def    Definitions for Microsoft C.
  527.   pc/config.h    Configuration header for OS/2 & MSDOS.
  528.   pc/popen.c    popen support for OS/2 & MSDOS.
  529.   pc/popen.h    ...
  530. ! vms/readme.1st    README for VMS port.
  531. ! vms/make.com    Build program for VMS.
  532. ! vms/c2man.opt-gcc LINK options file for GCC on VMS.
  533. ! vms/c2man.opt-vaxc LINK options file for VAX-C on VMS.
  534. ! vms/config.h    Config file for VMS compilation.
  535. ! vms/popen.c    popen/pclose routines for VMS.
  536. ! eg/boxcomment.c    Example input files...
  537.   eg/ccomment.h
  538.   eg/commentaft.c
  539.   eg/cppcomment.h
  540.  
  541. Index: latex.c
  542. Prereq: 2.0.1.3
  543. *** latex.c.old    1994/02/22 00:26:17
  544. --- latex.c    1994/05/12 02:25:13
  545. ***************
  546. *** 1,4 ****
  547. ! /* $Id: latex.c,v 2.0.1.3 1994/02/22 00:26:17 greyham Exp $
  548.    * functions for LaTeX style output.
  549.    */
  550.   #include "c2man.h"
  551. --- 1,4 ----
  552. ! /* $Id: latex.c,v 2.0.1.4 1994/05/12 02:25:13 greyham Exp $
  553.    * functions for LaTeX style output.
  554.    */
  555.   #include "c2man.h"
  556. ***************
  557. *** 49,54 ****
  558. --- 49,56 ----
  559.   const char *name;
  560.   const char *section;
  561.   {
  562. +     if (make_embeddable) return;
  563.       put_string("\\documentstyle{article}\n");
  564.       output_warning();
  565.       put_string("\\begin{document}\n");
  566. ***************
  567. *** 134,139 ****
  568. --- 136,155 ----
  569.   
  570.   void latex_file_end() { put_string("\\end{document}\n"); }
  571.   
  572. + void latex_name(name)
  573. + const char *name;
  574. + {
  575. +     if (name) latex_text(name);
  576. +     else      latex_section("NAME");
  577. + }
  578. + void latex_terse_sep()
  579. + {
  580. +     latex_char(' ');
  581. +     latex_dash();
  582. +     latex_char(' ');
  583. + }
  584.   
  585.   struct Output latex_output =
  586.   {
  587. ***************
  588. *** 164,168 ****
  589.       latex_include,
  590.       latex_file_end,
  591.       latex_text,
  592. !     latex_char
  593.   };
  594. --- 180,188 ----
  595.       latex_include,
  596.       latex_file_end,
  597.       latex_text,
  598. !     latex_char,
  599. !     NULL,        /* latex_parse_option */
  600. !     dummy,        /* latex_print_option */
  601. !     latex_name,
  602. !     latex_terse_sep
  603.   };
  604.  
  605. Index: nroff.c
  606. Prereq: 2.0.1.8
  607. *** nroff.c.old    1994/02/23 04:38:09
  608. --- nroff.c    1994/05/12 02:25:07
  609. ***************
  610. *** 1,4 ****
  611. ! /* $Id: nroff.c,v 2.0.1.8 1994/02/23 04:38:09 greyham Exp $
  612.    * functions for nroff style output.
  613.    */
  614.   #include "c2man.h"
  615. --- 1,4 ----
  616. ! /* $Id: nroff.c,v 2.0.1.9 1994/05/12 02:25:07 greyham Exp $
  617.    * functions for nroff style output.
  618.    */
  619.   #include "c2man.h"
  620. ***************
  621. *** 38,43 ****
  622. --- 38,45 ----
  623.       Time_t raw_time;
  624.       struct tm *filetime;
  625.       
  626. +     if (make_embeddable) return;
  627.       output_warning();
  628.       put_string(".TH \"");
  629.   
  630. ***************
  631. *** 168,173 ****
  632. --- 170,189 ----
  633.       printf(".so %s\n", filename);
  634.   }
  635.   
  636. + void nroff_name(name)
  637. + const char *name;
  638. + {
  639. +     if (name) nroff_text(name);
  640. +     else      nroff_section("NAME");
  641. + }
  642. + void nroff_terse_sep()
  643. + {
  644. +     nroff_char(' ');
  645. +     nroff_dash();
  646. +     nroff_char(' ');
  647. + }
  648.   struct Output nroff_output =
  649.   {
  650.       nroff_comment,
  651. ***************
  652. *** 197,201 ****
  653.       nroff_include,
  654.       dummy,       /* nroff_file_end */
  655.       nroff_text,
  656. !     nroff_char
  657.   };
  658. --- 213,221 ----
  659.       nroff_include,
  660.       dummy,       /* nroff_file_end */
  661.       nroff_text,
  662. !     nroff_char,
  663. !     NULL,    /* nroff_parse_option */
  664. !     dummy,    /* nroff_print_options */
  665. !     nroff_name,
  666. !     nroff_terse_sep
  667.   };
  668.  
  669. Index: c2man.h
  670. Prereq: 2.0.1.15
  671. *** c2man.h.old    1994/01/07 07:04:30
  672. --- c2man.h    1994/05/12 02:23:21
  673. ***************
  674. *** 1,4 ****
  675. ! /* $Id: c2man.h,v 2.0.1.15 1994/01/07 07:04:30 greyham Exp $
  676.    *
  677.    * Definitions for C language manual page generator
  678.    */
  679. --- 1,4 ----
  680. ! /* $Id: c2man.h,v 2.0.1.16 1994/05/12 02:23:21 greyham Exp $
  681.    *
  682.    * Definitions for C language manual page generator
  683.    */
  684. ***************
  685. *** 204,209 ****
  686. --- 204,216 ----
  687.       char *subdir;    /* subdirectory */
  688.   };
  689.   
  690. + /* list of sections to exclude */
  691. + typedef struct ExcludeSection
  692. + {
  693. +   char *name;
  694. +   struct ExcludeSection *next;
  695. + } ExcludeSection;
  696.   #define YYSTYPE yystype
  697.   
  698.   /* Program options */
  699. ***************
  700. *** 218,223 ****
  701. --- 225,231 ----
  702.   extern const char *progname;
  703.   extern char *header_prefix;
  704.   extern IncludeFile *first_include;
  705. + extern ExcludeSection *first_excluded_section;
  706.   
  707.   extern char *group_terse;
  708.   extern boolean group_together;
  709. ***************
  710. *** 240,245 ****
  711. --- 248,255 ----
  712.   extern boolean use_input_name;
  713.   extern boolean make_embeddable;
  714.   extern struct Output_Object_Info output_object[_OBJECT_NUM];
  715.   
  716.   /* Output a string to standard output. */
  717.   #define put_string(s)    fputs(s, stdout)
  718.  
  719. Index: pc/README.pc
  720. *** pc/README.pc.old    1993/08/25 09:21:54
  721. --- pc/README.pc    1994/05/16 04:58:02
  722. ***************
  723. *** 2,13 ****
  724.   DOS, using EMX/gcc or Microsoft C. The popen.c routines are adapted
  725.   from the versions supplied with GNU awk, and are needed for
  726.   executables which run under DOS. The getopt routines (needed for MSC)
  727. ! are adapted from the GNU versions.
  728.   
  729. ! To install, copy these files to the directory containing the 
  730. ! sources for c2man, and use
  731. !    make -f Makefile.pc
  732. ! to see a list of targets.
  733.   
  734.   This version is still in beta-test.
  735.   
  736. --- 2,16 ----
  737.   DOS, using EMX/gcc or Microsoft C. The popen.c routines are adapted
  738.   from the versions supplied with GNU awk, and are needed for
  739.   executables which run under DOS. The getopt routines (needed for MSC)
  740. ! are in the libc directory.
  741.   
  742. ! To install:
  743. ! 1. copy these files to the directory containing the sources for c2man
  744. ! 2. copy getopt*.* from the libc directory to the c2man directory too
  745. ! 3. use
  746. !     make -f Makefile.pc
  747. !    to see a list of targets.
  748.   
  749.   This version is still in beta-test.
  750.   
  751.  
  752. Index: output.h
  753. Prereq: 2.0.1.5
  754. *** output.h.old    1994/01/07 07:05:51
  755. --- output.h    1994/05/12 02:25:03
  756. ***************
  757. *** 1,4 ****
  758. ! /* $Id: output.h,v 2.0.1.5 1994/01/07 07:05:51 greyham Exp $
  759.    * format-independant output interface.
  760.    */
  761.   #ifndef OUTPUT_H
  762. --- 1,4 ----
  763. ! /* $Id: output.h,v 2.0.1.6 1994/05/12 02:25:03 greyham Exp $
  764.    * format-independant output interface.
  765.    */
  766.   #ifndef OUTPUT_H
  767. ***************
  768. *** 111,116 ****
  769. --- 111,128 ----
  770.   
  771.       /* output char, quoted to protect against formatter controls */
  772.       void (*character) _((const int c));
  773. +     /* parse formatter specific option. set to NULL if not available */
  774. +     int     (*parse_option) _((const char *option));
  775. +     /* print formatter specific options to stderr. */
  776. +     void (*print_options) _((void));
  777. +     /* output NAME section header and section names */
  778. +     void (*name) _((const char *name));
  779. +     /* output separators between section name and terse description */
  780. +     void (*terse_sep) _((void));
  781.   };
  782.   
  783.   /* pointer to the relevant output structure */
  784.  
  785. Index: grammar.y
  786. Prereq: 2.0.1.14
  787. *** grammar.y.old    1993/12/16 03:38:53
  788. --- grammar.y    1994/05/19 01:15:15
  789. ***************
  790. *** 1,4 ****
  791. ! /* $Id: grammar.y,v 2.0.1.14 1993/12/16 03:38:53 greyham Exp $
  792.    *
  793.    * yacc grammar for C manual page generator
  794.    * This was derived from the grammar given in Appendix A of
  795. --- 1,4 ----
  796. ! /* $Id: grammar.y,v 2.0.1.15 1994/05/19 01:15:15 greyham Exp $
  797.    *
  798.    * yacc grammar for C manual page generator
  799.    * This was derived from the grammar given in Appendix A of
  800. ***************
  801. *** 771,778 ****
  802.   #ifdef MSDOS
  803.   #include "lex_yy.c"
  804.   #else
  805.   #include "lex.yy.c"
  806. ! #endif
  807.   
  808.   #ifdef I_STDARG
  809.   void yyerror(const char *format, ...)
  810. --- 771,782 ----
  811.   #ifdef MSDOS
  812.   #include "lex_yy.c"
  813.   #else
  814. + #ifdef VMS
  815. + #include "lexyy.c"
  816. + #else
  817.   #include "lex.yy.c"
  818. ! #endif /* !VMS   */
  819. ! #endif /* !MSDOS */
  820.   
  821.   #ifdef I_STDARG
  822.   void yyerror(const char *format, ...)
  823.  
  824. Index: libc/README.libc
  825. *** libc/README.libc.old    1994/05/16 04:16:37
  826. --- libc/README.libc    1994/05/16 04:54:32
  827. ***************
  828. *** 0 ****
  829. --- 1,10 ----
  830. + This directory contains sources for library routines which some users have
  831. + found to be missing on their machines.
  832. + Since some of this code is covered by the GNU General Public License, a copy
  833. + is included in the file COPYING.  Note that only those files in the c2man
  834. + distribution which explicitly state that they fall under the terms of this
  835. + license actually do so.
  836. + The getopt routines (needed for MSC on the PC, and for VMS) are adapted from
  837. + the GNU versions.
  838.  
  839. Index: vms/c2man.opt-gcc
  840. *** vms/c2man.opt-gcc.old    1994/05/19 01:09:28
  841. --- vms/c2man.opt-gcc    1994/05/19 01:09:52
  842. ***************
  843. *** 0 ****
  844. --- 1,17 ----
  845. + c2man
  846. + enum
  847. + latex
  848. + manpage
  849. + nroff
  850. + semantic
  851. + strappend
  852. + strconcat
  853. + string
  854. + symbol
  855. + texinfo
  856. + grammar_tab
  857. + getopt
  858. + popen
  859. + alloca
  860. + gnu_cc:[000000]gcclib.olb/lib
  861. + sys$library:vaxcrtl.olb/lib
  862.  
  863. Index: vms/c2man.opt-vaxc
  864. *** vms/c2man.opt-vaxc.old    1994/05/19 01:10:15
  865. --- vms/c2man.opt-vaxc    1994/05/19 01:10:24
  866. ***************
  867. *** 0 ****
  868. --- 1,16 ----
  869. + c2man
  870. + enum
  871. + latex
  872. + manpage
  873. + nroff
  874. + semantic
  875. + strappend
  876. + strconcat
  877. + string
  878. + symbol
  879. + texinfo
  880. + grammar_tab
  881. + getopt
  882. + popen
  883. + alloca
  884. + sys$library:vaxcrtl.olb/lib
  885.  
  886. *** End of Patch 30 ***
  887. -- 
  888. Graham Stoney, Hardware/Software Engineer
  889. Canon Information Systems Research Australia
  890. Ph: + 61 2 805 2909    Fax: + 61 2 805 2929
  891.  
  892. exit 0 # Just in case...
  893.