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