[comp.sys.next] Man pages broken on the next, not tbl

rit@killdeer.Stanford.EDU (Jean-Francois Rit) (05/04/91)

In follow up to my previous posting and after some cues from tbl
authorities, I found the bug. Could somebody confirm this please?

- Description: man pages containing tables specified with tbl are
not formated correctly (in release 2.1). 

- Ex: man mf breaks with a "no specification" error message.
(Incidently, man tbl breaks before that because of a ill positioned
.TS at the beginning of a line).

- Reason: the man command runs man pages through tbl for formatting.
But the man pages in release 2.1 have *already* been run through tbl.
The second passage through tbl generates the error. 
For example, the Ultrix 4.1 release running on the machine from which
I type this message has original tbl inputs in the man pages. 

- Suggested work around: You can generate yourself the needed man
pages by running nroff -man tbl.1 > /usr/man/cat1/tbl.1 for example.
Less pedestrian but more space consuming is /usr/etc/catman 1 (from
su).

- Suggested fix: Put back the original pages.

J-F Rit

das15@cunixa.cc.columbia.edu (Douglas A Scott) (05/05/91)

In this same area of discussion, a related question:  I saw in a previous
article on man pages that the nroff -man format automatically does tbl, eqn,
and nroff on files.

I have been trying to put the complete X Windows documentation into Librarian.
The chapters in the documentation are nroff format--at least the machine
thinks so:

zardoz> file CH01
CH01:   roff, nroff, or eqn input text

When I index these with Librarian, I set ixBuild's options so that it assumes
man format on all these files.  Indexing is no problem, but when I view the
files via Librarian, after the message "Formatting man file...", and the text
shows in the window, there are still formatting characters mixed with the
text:

T{ Keyboard events T}      T{ T}
T{ Pointer events T}      T{ T}
T{ Window crossing events T}      T{ T}
T{ Input focus events T}      T{ T}
T{ Keymap state notification event T}      T{ T}
T{ Exposure events  T}      T{ T}
T{ Structure control events T}      T{ T}
T{ Window state notification events T}      T{ T}

etc.

It is clear from the makefiles in the documentation directories that they are
intended to be eqn'd and tbl'd before nroff or troff.  Otherwise, the text
looks pretty nice...highlighted text shows up, etc.  It would be great to get
these to display with full formatting, though.  Any ideas on what these stray
characters do?

Thanks!

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Douglas Scott          Columbia University Computer Music Studio 
Internet: <doug@woof.columbia.edu> <das15@cunixa.cc.columbia.edu>
UUCP: ...!columbia!woof!zardoz!doug          Phone: (703)765-4771