From guylhem Mon Nov 26 17:08:53 2001 Return-Path: Received: from luna.metalab.unc.edu [152.2.210.4] by localhost with POP3 (fetchmail-5.9.0) for guylhem@localhost (single-drop); Mon, 26 Nov 2001 17:08:53 +0100 (CET) Received: from localhost (megalith.rattlesnake.com [140.186.114.245]) by trance.metalab.unc.edu (8.11.6/8.11.0) with ESMTP id fAJIZ1B23240 for ; Mon, 19 Nov 2001 13:35:01 -0500 Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.114) for guylhem@metalab.unc.edu; Mon, 19 Nov 2001 12:54:01 -0500 (EST) Message-Id: Date: Mon, 19 Nov 2001 12:54:01 -0500 (EST) From: "Robert J. Chassell" To: guylhem@metalab.unc.edu CC: bob@rattlesnake.com Subject: Re: New GNU doc project Reply-to: bob@rattlesnake.com Status: RO Content-Length: 46160 Lines: 1548 RMS tells me you are organizing a documentation project for FSF. This is great! We should talk soon, either by telephone, or I should send you email. Meanwhile, here is an document I prepared some time ago that describes what documentation we had and what form it was in. This might interest you. Documents on the FSF Source CDs ------------------------------- Robert J. Chassell 1996/1997, updated 1999/2000 GNU systems, such as those with a Linux kernel, use six different documentation formats: plain text, HTML, LaTeX, man pages, DocBook, and Texinfo. FSF distributed 230 packages on its August 1999 Source CD-ROMs. Of the various packages, only about a dozen lack documention, or have a limited amount of documentation. On the other hand, nearly 100 of the 230 packages lack Texinfo documentation. The contents of this document are: * Priority in printing List of existing GNU documentation that is on the GNU CD that needs more work before being printed in hard copy, in the order I think is most important * Texinfo manuals Manuals in Texinfo format that printed, listing necessary include files and other minor fixes to enable printing * Texinfo manuals not printed Manuals in Texinfo format that were not printed because of bugs or for other reasons * Man pages * Files with paths that have `doc' in them: * GNU packages short on documentation in a usable format * How to list doc files in the GNU Source CD-ROMs * Find unique document names * Format Converters Need converters for: man page to Texinfo HTML to Texinfo LaTeX to Texinfo Need to debug and document DocBook to Texinfo Priority in printing -------------------- List of existing GNU documentation that is on the GNU CD that needs more work before being printed in hard copy, in the order I think is most important 94 pages diffutils-2.7/diff.texi 30 pages gzip-1.2.4/gzip.texi 45 pages fileutils-3.16/find.texi 58 pages fileutils-3.16/fileutils.texi 48 pages binutils-2.7/binutils.texi 13 pages binutils-2.7/cfg-paper.texi 38 pages binutils-2.7/configure.texi 103 pages autoconf-2.12/autoconf.texi 28 pages automake-1.0/automake.texi 74 pages dejagnu-1.3/dejagnu.texi 78 pages gettext-0.10/gettext.texi 4 pages gettext-0.10/nls.texi 55 pages wget-1.4.2/wget.texi 9 pages wdiff-0.5/wdiff.texi 54 pages textutils-1.22/textutils.texi 57 pages sh-utils-1.16/sh-utils.texi 14 pages sharutils-4.2/sharutils.texi 18 pages sharutils-4.2/remsync.texi 18 pages termutils-2.0/tput.texi 24 pages id-utils-3.2/id-utils.texi 8 pages ptx-0.4/ptx.texinfo 60 pages m4-1.4/m4.texinfo 144 pages cvs-1.9/cvs.texinfo 20 pages cvs-1.9/cvsclient.texi 31 pages cvs-1.9/pcl-cvs.texinfo 210 pages cfengine-1.3.16/cfdocs.texinfo 26 pages hello-1.3/hello.texi 30 pages finger-1.37/finger.texinfo 8 pages bc-1.03/dc.texinfo 13 pages dld-3.3/dld.texi 12 pages time-1.7/time.texi 12 pages units-1.53/units.texinfo 29 pages mtools-3.1/mtools.texi 110 pages screen-3.7.2/screen.texinfo 89 pages sipp-3.1/sipp.texinfo 27 pages stow-1.3.2/stow.texi 156 pages uucp-1.06/uucp.texi 78 pages gnats-3.2/gnats.texi 38 pages gnats-3.2/send-pr.texi 122 pages bash-2.0/bashref.texi 22 pages bash-2.0/hist.texinfo 56 pages bash-2.0/rlman.texinfo 20 pages readline-2.0/hist.texinfo 50 pages readline-2.0/rlman.texinfo 39 pages recode-3.4/recode.texi 52 pages regex-0.12/regex.texi 26 pages indent-1.9.1/indent.texinfo 20 pages metahtml-5.01/hist.texinfo 50 pages metahtml-5.01/rlman.texinfo 3 pages elisp-archive-1997.01.22/db-mode.texinfo 10 pages ispell-3.1.20/ispell.texinfo 48 pages ilisp-5.8.a04/ilisp.texi 128 pages hyperbole-4.01/hyperbole.texi 13 pages libg++-2.7.2/cfg-paper.texi 38 pages libg++-2.7.2/configure.texi 35 pages libg++-2.7.2/g++FAQ.texi 36 pages libg++-2.7.2/gperf.texi 40 pages libg++-2.7.2/iostream.texi 130 pages libg++-2.7.2/libg++.texi 88 pages octave-2.0.2/liboctave.texi 282 pages octave-2.0.2/octave.texi 289 pages maxima-5.2/maxima.texi 252 pages nihcl-3.1.4/nihcl.texinfo 13 pages libg++-2.7.2/cfg-paper.texi 38 pages libg++-2.7.2/configure.texi 35 pages libg++-2.7.2/g++FAQ.texi 36 pages libg++-2.7.2/gperf.texi 40 pages libg++-2.7.2/iostream.texi 130 pages libg++-2.7.2/libg++.texi `the rest': 36 pages cperf-2.1a/gperf.texinfo 29 pages graphics-0.17/graphics.texi 26 pages ed-0l2/ed.texinfo 38 pages elib-1.0/elib.texi 194 pages g77-0.5.19/g77.texi 132 pages gcal-2.10/gcal.texi 175 pages gcl-2.2.1/gcl-tk.texi 21 pages gdbm-1.7.3/gdbm.texinfo 62 pages git-4.3.16/git.texinfo 62 pages gmp-2.0.2/gmp.texi 498 pages gpc-2.0/gpc.texi 454 pages mule-2.3/emacs.texi 20 pages guile-1.0/ctax.texi 11 pages guile-1.0/gtcltk.texi 107 pages guile-1.0/guile.texi 29 pages guile-1.0/in.texi 17 pages guile-1.0/lang.texi 28 pages guile-1.0/guile-programmer.texi 44 pages guile-1.0/guile-user.texi Texinfo manuals =============== Manuals printed. `@s' means set in smallbook page number as reported by TeX formatting command @s 103 pages /u/doc/gnu/CD-files/autoconf-2.12/autoconf.texi @s 28 pages /u/doc/gnu/CD-files/automake-1.0/automake.texi @s 122 pages /u/doc/gnu/CD-files/bash-2.0/bashref.texi @s 22 pages /u/doc/gnu/CD-files/bash-2.0/hist.texinfo @s 68 pages /u/doc/gnu/CD-files/bash-2.0/termcap.texi @s 56 pages /u/doc/gnu/CD-files/bash-2.0/rlman.texinfo @s 8 pages /u/doc/gnu/CD-files/bc-1.03/dc.texinfo @s 48 pages /u/doc/gnu/CD-files/binutils-2.7/binutils.texi @s 13 pages /u/doc/gnu/CD-files/binutils-2.7/cfg-paper.texi @s 38 pages /u/doc/gnu/CD-files/binutils-2.7/configure.texi @s 210 pages /u/doc/gnu/CD-files/cfengine-1.3.16/cfdocs.texinfo [194] (cfdocs.cps ! Extra }, or forgotten \endgroup. l.1 , 117} Fixed by removing `@cindex' entry with no argument from line 6863 @s 36 pages /u/doc/gnu/CD-files/cperf-2.1a/gperf.texinfo problem with /u/doc/gnu/CD-files/cvs-1.9/cvs.texinfo (cpio.aux ! Missing @endcsname inserted. @- Invoking `cpio@- title @xrdef ...@'=@other @expandafter @gdef @csname X#1 @endcsname {#2}} l.7 'xrdef {Invoking `cpio'-title}{Invoking cpio} ? Fixed by removing ` and ' from @node line 325 and other places in node lines. @node Invoking `cpio', Media, Tutorial, Top @s 144 pages /u/doc/gnu/CD-files/cvs-1.9/cvs.texinfo commented out @afourpaper @s 20 pages /u/doc/gnu/CD-files/cvs-1.9/cvsclient.texi @s 31 pages /u/doc/gnu/CD-files/cvs-1.9/pcl-cvs.texinfo @s 74 pages /u/doc/gnu/CD-files/dejagnu-1.3/dejagnu.texi @s 94 pages /u/doc/gnu/CD-files/diffutils-2.7/diff.texi @s 13 pages /u/doc/gnu/CD-files/dld-3.3/dld.texi @include: /u/doc/gnu/CD-files/dld-3.3/version.texi @s 26 pages /u/doc/gnu/CD-files/ed-0l2/ed.texinfo @s 38 pages /u/doc/gnu/CD-files/elib-1.0/elib.texi @include: /u/doc/gnu/elib-1.0/gpl.texi @s 58 pages /u/doc/gnu/CD-files/fileutils-3.16/fileutils.texi @include /u/doc/gnu/CD-files/fileutils-3.16/version.texi @include perm.texi @include getdate.texi @s 45 pages /u/doc/gnu/CD-files/fileutils-3.16/find.texi @include perm.texi @s 30 pages /u/doc/gnu/CD-files/finger-1.37/finger.texinfo @s /u/doc/gnu/CD-files/fontutils-0.6/fontu.texi @include intro.texi @include install.texi @include overview.texi @include bugs.texi @include filefmts.texi @include imageto.texi @include imgrotate.texi @include fontcvt.texi @include charspace.texi @include limn.texi @include bzrto.texi @include bpltobzr.texi @include xbfe.texi @include bzredit.texi @include gsrenderf.texi @include enhance.texi @include copying.texi @include freedom.texi @include index.texi @s 194 pages /u/doc/gnu/CD-files/g77-0.5.19/g77.texi (has @c smallbook) @include news.texi @include install.texi @include bugs.texi @s 132 pages /u/doc/gnu/CD-files/gcal-2.10/gcal.texi (has @c smallbook and @c set smallbook) @s 175 pages /u/doc/gnu/CD-files/gcl-2.2.1/gcl-tk.texi (has @c smallbook) @s 21 pages /u/doc/gnu/CD-files/gdbm-1.7.3/gdbm.texinfo @s 78 pages /u/doc/gnu/CD-files/gettext-0.10/gettext.texi @s 4 pages /u/doc/gnu/CD-files/gettext-0.10/nls.texi included in about-nls-tmp.texi since not included elsewhere @s 62 pages /u/doc/gnu/CD-files/git-4.3.16/git.texinfo @s 62 pages /u/doc/gnu/CD-files/gmp-2.0.2/gmp.texi (has @c smallbook) @s 78 pages /u/doc/gnu/CD-files/gnats-3.2/gnats.texi @include version.texi @include flowchart.txt @include states.texi @include fields.texi @include p-usage.texi @include s-usage.texi @include p-admin.texi @include p-inst.texi Also input: epsf.tex flowchart.eps @s 38 pages /u/doc/gnu/CD-files/gnats-3.2/send-pr.texi @include version.texi @include states.texi @include fields.texi @include s-usage.texi @include categ.texi @s 498 pages /u/doc/gnu/CD-files/gpc-2.0/gpc.texi (has @c smallbook) @include copying.texi @include contributors.texi @include funding.texi @include lookfeel.texi @include gnu.texi @include purpose.texi @include install.texi @include invoke.texi @include keywords.texi @include builtin.texi @include extend.texi @include borland2ep.texi @include bpqstart.texi @include bugs.texi @include how_to_contrib.texi @include fpk_vs_gnu.texi @include notes.texi @include pvs.texi @include sets.texi @include gpi.texi @include automake.texi @include c-stuff.texi @include md.texi @include tm.texi @include rtl.texi depending on configuration /u/doc/gnu/CD-files/gpc-2.0/c-stuff.texi includes or top level does @c @include rtl.texi @c @include md.texi @c @include tm.texi @s 29 pages /u/doc/gnu/CD-files/graphics-0.17/graphics.texi @s 20 pages /u/doc/gnu/CD-files/guile-1.0/ctax.texi @s 11 pages /u/doc/gnu/CD-files/guile-1.0/gtcltk.texi @s 107 pages /u/doc/gnu/CD-files/guile-1.0/guile.texi @s 29 pages /u/doc/gnu/CD-files/guile-1.0/in.texi @s 17 pages /u/doc/gnu/CD-files/guile-1.0/lang.texi @s 28 pages /u/doc/gnu/CD-files/guile-1.0/guile-programmer.texi @include version.texi @include what-goes.texi @c @include tk.texi @include tk-new.texi: not present, use tk.texi @include goonix.texi @include threads.texi @c @include applet-ref.texi @include gh-ref.texi @include scm-ref.texi @include more-resources.texi @include ci.texi @include pi.texi @include ti.texi @s 44 pages /u/doc/gnu/CD-files/guile-1.0/guile-user.texi @include version.texi @include intro.texi @c @include install.texi @include startup.texi @include using-guile.texi @include libguile.texi @c @include tk.texi @include other.texi @c @include i18n.texi @include more-resources.texi @c @include install-probs.texi @include cindex.texi @include pi.texi Apparently not printed: expect.texi guile-programmer/applet-ref.texi guile-programmer/libguile-procs.texi guile-programmer/tk.texi guile-programmer/version.texi guile-programmer/vi.texi guile-user/goonix.texi guile-user/i18n.texi guile-user/install-probs.texi guile-user/install.texi guile-user/missing.texi guile-user/other.texi guile-user/tk.texi @s 30 pages /u/doc/gnu/CD-files/gzip-1.2.4/gzip.texi @include gpl.texinfo @s 26 pages /u/doc/gnu/CD-files/hello-1.3/hello.texi @s 128 pages /u/doc/gnu/CD-files/hyperbole-4.01/hyperbole.texi @include ../etc/hypb-mouse.txt (change to local dir; location in erroron CD-ROM @s 24 pages /u/doc/gnu/CD-files/id-utils-3.2/id-utils.texi @s 48 pages /u/doc/gnu/CD-files/ilisp-5.8.a04/ilisp.texi (has @c smallbook) @s 26 pages /u/doc/gnu/CD-files/indent-1.9.1/indent.texinfo (has @c smallbook) @s 13 pages /u/doc/gnu/CD-files/libg++-2.7.2/cfg-paper.texi @s 38 pages /u/doc/gnu/CD-files/libg++-2.7.2/configure.texi (has @c smallbook) @s 35 pages /u/doc/gnu/CD-files/libg++-2.7.2/g++FAQ.texi @s 36 pages /u/doc/gnu/CD-files/libg++-2.7.2/gperf.texi @s 40 pages /u/doc/gnu/CD-files/libg++-2.7.2/iostream.texi @s 130 pages /u/doc/gnu/CD-files/libg++-2.7.2/libg++.texi (has @c smallbook) @include lgpl.texinfo @s 60 pages /u/doc/gnu/CD-files/m4-1.4/m4.texinfo @include version.texi @s 20 pages /u/doc/gnu/CD-files/metahtml-5.01/hist.texinfo @include hsuser.texinfo @include hstech.texinfo @s 50 pages /u/doc/gnu/CD-files/metahtml-5.01/rlman.texinfo @include rluser.texinfo @include rltech.texinfo @s 29 pages /u/doc/gnu/CD-files/mtools-3.1/mtools.texi 454 pages /u/doc/gnu/CD-files/mule-2.3/emacs.texi @include screen.texi @include commands.texi @include entering.texi @include basic.texi @include mini.texi @include m-x.texi @include help.texi @include mark.texi @include killing.texi @include regs.texi @include display.texi @include search.texi @include fixit.texi @include files.texi @include buffers.texi @include windows.texi @include frames.texi @include major.texi @include indent.texi @include text.texi @include programs.texi @include building.texi @include abbrevs.texi @include picture.texi @include sending.texi @include rmail.texi @include dired.texi @include calendar.texi @include misc.texi @include custom.texi @include trouble.texi @include cmdargs.texi @include anti.texi @include msdog.texi @include gnu.texi @include glossary.texi @s 88 pages /u/doc/gnu/CD-files/octave-2.0.2/liboctave.texi (has @c smallbook) @include preface.texi @include gpl.texi @include intro.texi @include array.texi @include matvec.texi @include factor.texi @include range.texi @include nleqn.texi @include optim.texi @include quad.texi @include diffeq.texi @include error.texi (has no contents) @include install.texi (has no @chapter, @itemize -- is part of other whole; fixed by adding @chapter, @itemize; also, no index called: @flindex; commented out ) @include bugs.texi @include cp-idx.texi @include fn-idx.texi @s 282 pages /u/doc/gnu/CD-files/octave-2.0.2/octave.texi (has @c smallbook) @include conf.texi @include preface.texi @include intro.texi @include invoke.texi @include expr.texi @include stmt.texi @include func.texi @include var.texi @include arith.texi @include linalg.texi @include poly.texi @include nonlin.texi @include diffeq.texi @include optim.texi @include quad.texi @include control.texi @include signal.texi @include set.texi @include stats.texi @include plot.texi @include image.texi @include audio.texi @include io.texi @include special.texi @include matrix.texi @include strings.texi @include system.texi @include history.texi @include help.texi @include program.texi @include amuse.texi @include emacs.texi @include install.texi @include bugs.texi @include rluser.texi @include gnuinfo.texi @include gpl.texi @include cp-idx.texi @include vr-idx.texi @include fn-idx.texi @include op-idx.texi @include rd-idx.texi @include in-idx.texi @s 8 pages /u/doc/gnu/CD-files/ptx-0.4/ptx.texinfo @include version.texi @s 20 pages /u/doc/gnu/CD-files/readline-2.0/hist.texinfo @include hsuser.texinfo @include hstech.texinfo @s 50 pages /u/doc/gnu/CD-files/readline-2.0/rlman.texinfo @include rluser.texinfo @include rltech.texinfo (lack @end deftypefun on line 34) @s 39 pages /u/doc/gnu/CD-files/recode-3.4/recode.texi @include version.texi @include charset.texi @s 52 pages /u/doc/gnu/CD-files/regex-0.12/regex.texi line 1570: problem with \' in .aux file; removed from title @subsection The Match-end-of-buffer Operator (@code{\'}) @s 28 page /u/doc/gnu/CD-files/rx-1.5/rx.texi @s 110 pages /u/doc/gnu/CD-files/screen-3.7.2/screen.texinfo @s 57 pages /u/doc/gnu/CD-files/sh-utils-1.16/sh-utils.texi Index problem with: Fran@,{c}ois @include version.texi @include getdate.texi @s 14 pages /u/doc/gnu/CD-files/sharutils-4.2/sharutils.texi @include version.texi @s 18 pages /u/doc/gnu/CD-files/sharutils-4.2/remsync.texi @s 27 pages /u/doc/gnu/CD-files/stow-1.3.2/stow.texi (has @c smallbook) @include version.texi @s 18 pages /u/doc/gnu/CD-files/termutils-2.0/tput.texi @s 54 pages /u/doc/gnu/CD-files/textutils-1.22/textutils.texi @include version.texi @s 12 pages /u/doc/gnu/CD-files/time-1.7/time.texi @include version.texi @s 12 pages /u/doc/gnu/CD-files/units-1.53/units.texinfo @s 156 pages /u/doc/gnu/CD-files/uucp-1.06/uucp.texi @s 9 pages /u/doc/gnu/CD-files/wdiff-0.5/wdiff.texi @include version.texi @s 55 pages /u/doc/gnu/CD-files/wget-1.4.2/wget.texi @s 3 pages /u/doc/gnu/CD-files/elisp-archive-1997.01.22/db-mode.texinfo @s 10 pages /u/doc/gnu/CD-files/ispell-3.1.20/ispell.texinfo @s 289 pages /u/doc/gnu/CD-files/maxima-5.2/maxima.texi @include Lists.texi @include Differentiation.texi @include Integration.texi @include Polynomials.texi @include Simplification.texi @include Expressions.texi @include Function.texi @include Input.texi @include Program.texi @include Plotting.texi @c @include NonCommutative.texi @include Floating.texi @include Numerical.texi @include Trigonometric.texi @include Equations.texi @include Arrays.texi @include Series.texi @include Symmetries.texi @include Groups.texi @include Operators.texi @include Constants.texi @include Special.texi @include Command.texi @include Contexts.texi @include Matrices.texi @include Runtime.texi @include Miscellaneous.texi @include Rules.texi @include Number.texi @include Help.texi @include Differential.texi @c @include xrefs.texi @include Statistics.texi @include Limits.texi @include Logarithms.texi @include Debugging.texi @include Affine.texi @include Tensor.texi @include Ctensor.texi @c @include None.texi @include Indices.texi (maxima.fns ! Extra }, or forgotten \endgroup. l.1 \initial {}} @s 252 pages /u/doc/gnu/CD-files/nihcl-3.1.4/nihcl.texinfo @include ArrayOb.texinfo @include Arraychar.texinfo @include Assoc.texinfo @include AssocInt.texinfo @include Bag.texinfo @include Bitset.texinfo @include Class.texinfo @include Collection.texinfo @include Date.texinfo @include Dictionary.texinfo @include Exception.texinfo @include FDSet.texinfo @include Float.texinfo @c @include Fraction.texinfo @include Heap.texinfo @c @include HeapProc.texinfo @include IdentDict.texinfo @include IdentSet.texinfo @include Integer.texinfo @include Iterator.texinfo @include KeySortCltn.texinfo @include Link.texinfo @include LinkOb.texinfo @include LinkedList.texinfo @include LookupKey.texinfo @include NIHCL.texinfo @include nihclerrs.texinfo @include Nil.texinfo @include OIOifd.texinfo @include OIOin.texinfo @include OIOistream.texinfo @include OIOnihin.texinfo @include OIOnihout.texinfo @include OIOofd.texinfo @include OIOostream.texinfo @include OIOout.texinfo @include Object.texinfo @include OrderedCltn.texinfo @include Point.texinfo @c @include Process.texinfo @include Random.texinfo @include Range.texinfo @include ReadFromTbl.texinfo @c @include Rectangle.texinfo @include Regex.texinfo @c @include Scheduler.texinfo @c @include Semaphore.texinfo @include SeqCltn.texinfo @include Set.texinfo @c @include SharedQueue.texinfo @include SortedCltn.texinfo @include Stack.texinfo @c @include StackProc.texinfo @include StoreOnTbl.texinfo @include String.texinfo @include TemplateC.texinfo @include TemplateH.texinfo @include Time.texinfo @include Vector.texinfo cp /cdrom/sipp-3.1/doc/sipp.texinfo . @s 89 pages /u/doc/gnu/CD-files/sipp-3.1/sipp.texinfo Texinfo manuals not printed --------------------------- @s /u/doc/gnu/CD-files/gcl-2.2.1/gcl-si.texi @include number.texi Not printed because as.texinfo includes files not available: @s /u/doc/gnu/CD-files/binutils-2.7/as.texinfo Not printed presumably clear in config.texi @include c-h8300.texi @include c-hppa.texi @include c-i386.texi @include c-i960.texi @include c-m68k.texi @include c-mips.texi @include c-ns32k.texi @include c-sh.texi @include c-sparc.texi @include c-z8k.texi @include c-vax.texi Not printed because bfd.texinfo includes files not available: @s /u/doc/gnu/CD-files/binutils-2.7/bfd.texinfo bfd.texinfo includes files not available: @include init.texi @include section.texi @include syms.texi @include archive.texi @include format.texi @include reloc.texi @include core.texi @include targets.texi @include archures.texi @include opncls.texi @include libbfd.texi @include cache.texi @include linker.texi @include hash.texi @include aoutx.texi @include coffcode.texi @include elf.texi @c @include elfcode.texi cpio-2.4.2/cpio.texi Had to change @group @example to @example @group in all locations Not for printing: Only is @chapter: libobjects-0.1.19/advertisement.texi @include version.texi @include machines.texi @include version.texi Only is @chapter: libobjects-0.1.19/announce.texi @include version.texi @include news.texi @include version.texi Only is @chapter: libobjects-0.1.19/readme.texi @include version.texi Too many problems: libobjects-0.1.19/libobjects.texi Some problems: No copy of version.texi in directory; commented out. @include install.texi Also, had to comment out: @subtitle Version @value{OBJECTS_VERSION} @subtitle (for use with @samp{gcc} version @value{GCC_VERSION}) @include install.texi @include version.texi; commented out. Also, had to comment out @ifset INSTALL_ONLY ... @end ifset @include todo.texi @include version.texi; commented out. make-3.75 mule-2.3/gnu1.texi @include gnu.texi (GNU Manifesto) mule-2.3/info.texi @include info-stnd.texi (How to use Info) octave-2.0.2/hist.texinfo @include hsuser.texinfo @include hstech.texinfo octave-2.0.2/kpathsea.texi @include freedom.texi octave-2.0.2/rlman.texinfo @include rluser.texinfo @include rltech.texinfo octave-2.0.2/standards.texi @include make-stds.texi regex-0.12/xregex.texi (appears only a little different from regex.texi) rx-1.5/regex.texi (only two differences from regex-0.12/regex.texi) tar-1.11.8/doc/docwarn.texi tar-1.11.8/doc/header.texi tar-1.11.8/doc/tar.texinfo tar-1.11.8/doc/version.texi termcap-1.3/termcap.texi TeX-3.1415/* texinfo-3.9/* w3-2.2.26/w3.txi xboard-3.5.0/xboard.texi (not a complete document; no \input header) @include gpl.texinfo gnans-1.5.1/gnans.texi (cannot find screendump.ps, etc.) gnans-1.5.1/hist.texinfo @include hsuser.texinfo @include hstech.texinfo rlman.texinfo @include rluser.texinfo @include rltech.texinfo @s 64 pages /u/doc/gnu/CD-files/autoconf-2.12/standards.texi /u/doc/gnu/CD-files/binutils-2.7/standards.texi @include make-stds.texi /u/doc/gnu/CD-files/binutils-2.7/make-stds.texi libg++-2.7.2/standards.texi @include make-stds.texi libg++-2.7.2/gpl.texinfo bison-1.25/bison.texinfo calc-2.02f/calc.texinfo cfengine-1.3.16/version.texi cvs-1.9/CVSvn.texi ddd-2.0/termcap.texi flex-2.5.4/MISC/texinfo/flex.texi g77-0.5.19/bugs0.texi g77-0.5.19/install0.texi g77-0.5.19/news0.texi gawk-3.0.0/doc/gawk.texi gcc-2.7.2.2/ gcl-2.2.1/info/bind.texi (one line file) gdb-4.16/ glibc-2.0/ Man pages --------- cd /cdrom As a shell commands: cd /cdrom pushd umount -v /dev/scd0 && eject /dev/scd0 # [go back to cdrom # 1] mount -v -o ro -t iso9660 /dev/scd0 /cdrom pushd For 2nd CD, use >> to append find . \! -type d \( -name '*.man' -o -name '*.[1-9]' -o -name '*.n' \) -exec ls -ald {} \; > /u/doc/gnu/Man-pages-list ------------------------ Remove dates from Man-pages-list list so file names look like: ./automake-1.0/ansi2knr.1 then: (progn (flush-lines "ChangeLog\\.[1-5]$") (flush-lines "ARTICLE\\.[1-9]$") (flush-lines "NEWS\\.[1-9]$") (flush-lines "NEWS\\.[1-9]\\.[1-9]$") (flush-lines "NEWS-\\.[1-9]$") (flush-lines "README-\\.[1-9]$") (flush-lines "README-\\.[1-9]\\.[1-9]$") (flush-lines "README-\\.[1-9]\\.[1-9]\\.[1-9]$") (flush-lines "README-[1-9]\\.[1-9]$") (flush-lines "README-[1-9]\\.[1-9]\\.[1-9]$") (flush-lines "README.Xfree3.2$")) (query-replace "./" "/cdrom/") Shell commands: cd /u/doc/gnu/CD-files mkdir automake-1.0 cd automake-1.0 cp /cdrom/automake-1.0/ansi2knr.1 . groff -man -T dvi ansi2knr.1 >ansi2knr.dvi mp1() { groff -man -T dvi $1 > `basename $1 .1`.dvi ; } mp2() { groff -man -T dvi $1 > `basename $1 .2`.dvi ; } mp3() { groff -man -T dvi $1 > `basename $1 .3`.dvi ; } Copy page length to `Printed-manuals' file. Copy path to `Printed-manuals' and append .dvi filename. Files with paths that have `doc' in them: ---------------------------------------- cd /cdrom As a shell commands: cd /cdrom pushd umount -v /dev/scd0 && eject /dev/scd0 # [go back to cdrom # 1] mount -v -o ro -t iso9660 /dev/scd0 /cdrom pushd For 2nd CD, use >> to append find . -path '*doc*' \! -type d -exec ls -ald {} \; >/u/doc/Doc-directory-docs find . -path '*doc*' \! -type d -exec ls -ald {} \; >/u/doc/doc-file-list remove first few columns using `C-x r k' Files to flush -------------- (progn ;; [have following] (flush-lines "\\.texinfo$") (flush-lines "\\.texi$") (flush-lines "\\.txi$") (flush-lines "\\.man$") (flush-lines "\\.[1-9]*$") (flush-lines "\\.n$") (flush-lines "\\.tex$") (flush-lines "\\.doc$") (flush-lines "\\.txt$") (flush-lines "\\.html$") (flush-lines "\\.ps$") (flush-lines "\\.ms$") (flush-lines "\\.dvi$") ;; [do not want] (flush-lines "\\.TBL$") (flush-lines "\\.el$") (flush-lines "\\.h$") (flush-lines "\\.c$") (flush-lines "\\.info-[1-9]*$") (flush-lines "\\.elc$") (flush-lines "\\.in$") (flush-lines "\\.am$") (flush-lines "\\.sed$") (flush-lines "\\.cvsignore$") (flush-lines "\\.delete$") (flush-lines "\\.dat$") (flush-lines "\\.plt$") (flush-lines "\\.dif $") (flush-lines "\\.com$") (flush-lines "\\.jp$") (flush-lines "\\.aux$") (flush-lines "\\.cp$") (flush-lines "\\.fn$") (flush-lines "\\.info$") (flush-lines "\\.ky$") (flush-lines "\\.log$") (flush-lines "\\.pg$") (flush-lines "\\.toc$") (flush-lines "\\.tp$") (flush-lines "\\.vr$") (flush-lines "ChangeLog$") (flush-lines "ChangeLog.fsf$") (flush-lines "Makefile$") (flush-lines "configure$") (flush-lines "BOOKFILES$") (flush-lines "CHANGES$") (flush-lines "CONTRIB$") (flush-lines "COPYING$") ) GNU packages short on documentation in a usable format ------------------------------------------------------ based on: GNU Source Code CD-ROMs, Edition 14, August 1999 This is a list of the programs on the GNU Source Code CD-ROMs that which appear to lack documentation in a usable format. I have not looked at each program, but rather have searched for files that characterize documentation, such as Texinfo files, man pages, and the like. ------------------------------- Lack any obvious documentation: abuse-2.0 clx-5.02 gimp-data-extras-1.0.0 gnumach-1.2 intlfonts-1.1 mesa-demos-3.0 mig-1.1 pcl-gcl-2.2 windows32api-0.1.2 xaw3d-1.5 xinfo-1.01.01 Have a little documentation: btyacc-3.0 has some documentation in its README file cvsweb-1.0 two paragraphs of documentation in its README file Lack Texinfo documentation: acm-4.8 19kb README file and 18kb ps doc file adns-0.4 6kb README file aegis-3.19 47kb README file and many man pages. apache-1.3.6 HTML, man page, and README barcode-0.92 HTML, ps and txt cook-2.10 HTML, man pages cxref-1.5a README in HTML, man, TeX format and FAQ,html dgs-0.5 ps files and man pages diction-0.7 man page doschk-1.1 README file dosemu-0.98.8 txt file, 400+ kb, and man pages in doc directory electric-5.4g6 HTML elisp-archive-1998.03.12 no Texinfo documentation empire-4.2.6 man pages enscript-1.6.1 txt files, man pages es-0.9-beta1 65kb man page exim-3.03 txt files, man pages, some html f2c-1998.10.14 143kb ps file, man pages ffcall-1.6 man pages, HTML freedos-0.3beta README file gamma-3.5.3 HTML gd-1.6.3 111kb HTML generic-nqs-3.50.5 man pages, txt geomview-1.6.1.9 HTML, TeX, man pages, txt gforth-0.4.0 ps and TeX ghostscript-5.10 ps and txt ghostview-1.5 ps and man gimp-1.0.4 almost no Texinfo documentation gleem-1.0 HTML gn-2.24 HTML gnat-3.11p txt gnome-1.0 developers documentation only gnucash-1.2.3 looks like dev docs only gnuchess-4.0.80 man pages, txt gnugo-2.0 man page gnuplot-3.7 270kb `doc' format gnuserv-2.1alpha man page gnussl-0.2.1 ps and TeX gprolog-1.0.0 HTML and TeX greg-0.6 HTML groff-1.11.1 man pages, ps, `doc' format guavac-1.2 no Texinfo documentation hp2xx-3.2.0 man page and TeX httptunnel-2.0 txt of the RFC hylafax-4.0.2 HTML, man pages inetutils-1.3.2 man pages jargon-4.1.4 HTML java2html-1.2 HTML jpeg-6b man pages, txt karma-1.6 `doc' format less-340 man pages lesstif-0.88.9 HTML libpng-1.0.3 man pages, txt lout-3.16 ps lynx-2.8.2 HTML, man page maverick-5.1 HTML, man page, ps mc-4.1.35 SGML, man page, and FAQ mesa-lib-3.0 HTML mkisofs-1.11.3 man pages mm-1.07 man pages motti-2.2 README ms-0.07.2 man pages mutt-0.95.6i txt ncurses-4.2 HTML, man pages nethack-3.2.2 txt, man pages nvi-1.79 man pages, ps, txt oaklisp-1993.07.20 man page p2c-1.20.1 man page patch-2.5 man page pcre-2.08 HTML, man pages, txt perl-5.005.02 man pages php-3.0.12 HTML pips-1.01 HTML pth-1.1.5 ps, man pages r-0.65.0 HTML, TeX rc-1.6 man page rcs-5.7 man pages roxen-1.1 HTML rsync-2.3.1 man pages sane-1.0.1 TeX, man pages saoimage-1.26 TeX, man pages, txt shtool-1.4.6 README smail-3.2 man pages sneps-2.4.0 TeX, ps stump-2.3 man pages superopt-2.5 README swarmdocs-1.4.1b SGML talkfilters-1.0 man pages tcl-8.0.5 man pages tiff-3.4beta037 HTML, man pages tile-forth-2.1 man pages tk-8.0.5 man pages ucblogo-4.6 man page userv-0.64.1 HTML vrweb-1.5 HTML webstump-2.0 txt, HTML which-2.8 man page wn-2.0.8 HTML x11-6.4 man pages, TeX xgrabsc-2.41 man pages xmcd-2.5 man pages xpm-3.4k HTML, man pages ygl-4.0g HTML zlib-1.1.3 txt, man page Packages containing LaTeX documentation: cxref-1.5a LaTex (6kb), HTML, man page gnussl-0.2.1 LaTeX (two 100kb files) gprolog-1.0.0 LaTeX (300kb) and HTML r-0.65.0 LaTex (~20kb), HTML (~15kb) sane-1.0.1 LaTeX (70kb), man pages, HTML saoimage-1.26 LaTeX (90kb), man page (25 kb), txt (70kb) sneps-2.4.0 LaTeX (123kb) x11-6.4 LaTeX (210kb), man pages Packages containing HTML documentation: apache-1.3.6 HTML, man page, and README barcode-0.92 HTML, ps and txt cook-2.10 HTML, man pages cxref-1.5a README in HTML, man, TeX format and FAQ,html electric-5.4g6 HTML ffcall-1.6 man pages, HTML gamma-3.5.3 HTML gd-1.6.3 111kb HTML geomview-1.6.1.9 HTML, TeX, man pages, txt gleem-1.0 HTML gn-2.24 HTML gprolog-1.0.0 HTML and TeX greg-0.6 HTML hylafax-4.0.2 HTML, man pages jargon-4.1.4 HTML java2html-1.2 HTML lesstif-0.88.9 HTML lynx-2.8.2 HTML, man page maverick-5.1 HTML, man page, ps mesa-lib-3.0 HTML ncurses-4.2 HTML, man pages pcre-2.08 HTML, man pages, txt php-3.0.12 HTML pips-1.01 HTML r-0.65.0 HTML, TeX roxen-1.1 HTML tiff-3.4beta037 HTML, man pages userv-0.64.1 HTML vrweb-1.5 HTML webstump-2.0 txt, HTML wn-2.0.8 HTML xpm-3.4k HTML, man pages ygl-4.0g HTML Packages containing man pages aegis-3.19 47kb README file and many man pages. apache-1.3.6 HTML, man page, and README cook-2.10 HTML, man pages cxref-1.5a README in HTML, man, TeX format and FAQ,html dgs-0.5 ps files and man pages diction-0.7 man page dosemu-0.98.8 txt file, 400+ kb, and man pages in doc directory empire-4.2.6 man pages enscript-1.6.1 txt files, man pages es-0.9-beta1 65kb man page exim-3.03 txt files, man pages, some html f2c-1998.10.14 143kb ps file, man pages ffcall-1.6 man pages, HTML generic-nqs-3.50.5 man pages, txt geomview-1.6.1.9 HTML, TeX, man pages, txt ghostview-1.5 ps and man gnuchess-4.0.80 man pages, txt gnugo-2.0 man page gnuserv-2.1alpha man page groff-1.11.1 man pages, ps, `doc' format hp2xx-3.2.0 man page and TeX hylafax-4.0.2 HTML, man pages inetutils-1.3.2 man pages jpeg-6b man pages, txt less-340 man pages libpng-1.0.3 man pages, txt lynx-2.8.2 HTML, man page maverick-5.1 HTML, man page, ps mc-4.1.35 SGML, man page, and FAQ mkisofs-1.11.3 man pages mm-1.07 man pages ms-0.07.2 man pages ncurses-4.2 HTML, man pages nethack-3.2.2 txt, man pages nvi-1.79 man pages, ps, txt oaklisp-1993.07.20 man page p2c-1.20.1 man page patch-2.5 man page pcre-2.08 HTML, man pages, txt perl-5.005.02 man pages pth-1.1.5 ps, man pages rc-1.6 man page rcs-5.7 man pages rsync-2.3.1 man pages sane-1.0.1 TeX, man pages saoimage-1.26 TeX, man pages, txt smail-3.2 man pages stump-2.3 man pages talkfilters-1.0 man pages tcl-8.0.5 man pages tiff-3.4beta037 HTML, man pages tile-forth-2.1 man pages tk-8.0.5 man pages ucblogo-4.6 man page which-2.8 man page x11-6.4 man pages, TeX xgrabsc-2.41 man pages xmcd-2.5 man pages xpm-3.4k HTML, man pages zlib-1.1.3 txt, man page How to list doc files in the GNU Source CD-ROMs ----------------------------------------------- Useful commands in Emacs: `C-x r s R' Copy region into register R (`copy-to-register'). `C-x r i R' Insert text from register R (`insert-register'). Useful string to insert @c !!! RJC set @smallbook Work first on Texinfo files. Here is an example of what to do: Create a directory in which to work: mkdir -p /u/doc/gnu/CD-files cd /u/doc/gnu/CD-files [See below on how to copy files from CD to this directory.] For each file: mkdir hello-1.3 cd hello-1.3 # [mount CD on /cdrom] mount -v -o ro -t iso9660 /dev/scd0 /cdrom cp /cdrom/hello-1.3/gpl.texinfo /cdrom/hello-1.3/hello.texi . 'M-x dirs', find file, insert @smallbook as needed, then `C-c C-t C-b' To copy files from CD, first use `find' with an appriate regexp to create a file with the names of the files to be copied in it, such as `Texinfo-files' or `HTML-files' How to list following types of file: .texinfo .texi .txi .man .[1-9]* .n .tex .doc .txt .html .ps .ms .dvi As a shell commands: cd /cdrom pushd umount -v /dev/scd0 && eject /dev/scd0 # [go back to cdrom # 1] mount -v -o ro -t iso9660 /dev/scd0 /cdrom pushd # For 2nd CD, use >> to append find . \( -name '*.texinfo' -o -name '*.texi' -o -name '*.txi' -o -name '*.man' -o -name '*.[1-9]' -o -name '*.n' -o -name '*.tex' -o -name '*.doc' -o -name '*.txt' -o -name '*.html' -o -name '*.ps' -o -name '*.ms' -o -name '*.dvi' \) -exec ls -ald {} \; > /u/doc/file-list For Texinfo files only: find . \( -name '*.texinfo' -o -name '*.texi' -o -name '*.txi' \) -exec ls -ald {} \; > /u/doc/Texinfo-files For HTML files only: find . -name '*.html' -exec ls -ald {} \; > /u/doc/HTML-files For man pages only: find . \! -type d \( -name '*.man' -o -name '*.[1-9]' -o -name '*.n' \) -exec ls -ald {} \; > /u/doc/Man-pages-files See also Files with paths that have `doc' in them: The following puts files in deep directories, not flat. I.e., into files like this: /u/doc/gnu/CD-files/bash-2.0/lib/glob/doc/glob.texi /u/doc/gnu/CD-files/bash-2.0/lib/readline/doc/hist.texinfo /u/doc/gnu/CD-files/bash-2.0/lib/readline/doc/hstech.texinfo rather than /u/doc/gnu/CD-files/bash-2.0/glob.texi /u/doc/gnu/CD-files/bash-2.0/hist.texinfo /u/doc/gnu/CD-files/bash-2.0/hstech.texinfo Remember toremove dates from Texinfo-files list and replace ./ with /cdrom/ `tar' needs file names that look like: /cdrom/bash-2.0/lib/readline/doc/hist.texinfo Copy `/u/doc/Texinfo-files' to `/u/doc/Texinfo-files-for-tar' Here is the shell command to use to copy the appropriate files from the CD to a working directory: cd /cdrom; tar -c -v -f - --files-from=/u/doc/gnu/Texinfo-files-for-tar | (cd /u/doc/gnu/CD-files; tar xvf -) Then do this: cd /u/doc/gnu/CD-files/ cp . # [to find which files to not format, since they will be included] grep @include * Then insert @smallbook as needed then run tex; texindex; tex or run texi2dvi then print After a successful print run, list the file's name in Printed-manuals Find unique document names -------------------------- Files have names such as: autoconf-2.13/autoconf.texi autoconf-2.13/install.texi autoconf-2.13/make-stds.texi autoconf-2.13/standards.texi Go to list, remove beginning until directory name, then uniq --check-chars=6 foo foobar Then use Emacs keyboard macro to remove filenames after a / Format Converters ----------------- 60 packages containing man pages. need a man page to Texinfo converter Or else, the Emacs Info mode should read man pages (or switch transparently to Man page mode) so that people using GNU Emacs do not have such a hard time finding documents that are either in Info or in man pages. 33 packages contain HTML documentation. need an HTML to Texinfo converter 8 packages contain LaTeX documentation. need a LaTeX to Texinfo converter Perhaps, the LaTeX could be converted to Info using the (old and not very good) latexinfo.el program Work is needed to debug and document the existing DocBook to Texinfo and Texinfo to DocBook converters