Begin
File:rman.tgz 
Description:filter for manual pages
Keywords:filter man rosetteman rman manual pages
Version:        
Entered-date:   
Author:         
Ported-by:      
Original-site:  
Copying-policy:	
Supplemental:   

RosettaMan is a filter for UNIX manual pages.  It takes as input man
pages formatted for a variety of UNIX flavors (not [tn]roff source)
and produces as output a variety of file formats.  Currently
RosettaMan accepts man pages as formatted by the following flavors of
UNIX: Hewlett-Packard HP-UX, AT&T System V, SunOS, Sun Solaris, OSF/1,
DEC Ultrix, SGI IRIX, Linux, SCO; and produces output for the following
formats: printable ASCII only (stripping page headers and footers),
section and subsection headers only, TkMan, [tn]roff, Ensemble,
SGML (soon--I finally found a DTD), HTML, LaTeX, RTF, Perl 5's pod.

RosettaMan improves on other man page filters in several ways: (1) its
analysis recognizes the structural pieces of man pages, enabling high
quality output, (2) its modular structure permits easy augmentation of
output formats, (3) it accepts man pages formatted with the varient
macros of many different flavors of UNIX, and (4) it doesn't require
modification or cooperation with any other program.

RosettaMan is a rewrite of TkMan's man page filter, called bs2tk.  (If
you haven't heard about TkMan, a hypertext man page browser, you
should grab it via anonymous ftp from ftp.cs.berkeley.edu:
/ucb/people/phelps/tkman.tar.Z.)  Whereas bs2tk generated output only for
TkMan, RosettaMan generalizes the process so that the analysis can be
leveraged to new output formats.  A single analysis engine recognizes
section heads, subsection heads, body text, lists, references to other
man pages, boldface, italics, bold italics, special characters (like
bullets), tables (to a degree) and strips out page headers and
footers.  The engine sends signals to the selected output functions so
that an enhancement in the engine improves the quality of output of
all of them.  Output format functions are easy to add, and thus far
average about about 75 lines of C code each.
 
archive contents:

drwxrwxr-x  0 mphunter techies 	         Jan 23 11:35 rman
-rw-rw-r--  0 mphunter techies 	    1197 Jan 15 15:38 rman/Copyright
-rw-rw-r--  0 mphunter techies 	     388 Jan 15 15:38 rman/MANIFEST
-rwxrwxr-x  0 mphunter techies 	   42254 Jan 15 15:41 rman/rman
-rw-rw-r--  0 mphunter techies 	    6059 Jan 15 15:38 rman/README-rman
-rw-rw-r--  0 mphunter techies 	    8019 Jan 15 15:38 rman/rman.1
-rw-rw-r--  0 mphunter techies 	   61540 Jan 15 15:38 rman/rman.c
-rw-rw-r--  0 mphunter techies 	    8382 Jan 15 15:38 rman/rman.html
drwxrwxr-x  0 mphunter techies 	         Jan 23 11:37 rman/contrib
-r-xr-xr-x  0 mphunter techies 	    2049 Jan 23 11:37 rman/contrib/man2html
-rw-rw-r--  0 mphunter techies 	    1428 Jan 15 15:38 rman/contrib/README-contrib
-rw-rw-r--  0 mphunter techies 	    4991 Jan 15 15:38 rman/contrib/http-rman.c
-rw-rw-r--  0 mphunter techies 	     660 Jan 15 15:38 rman/contrib/http-rman.html
-rw-rw-r--  0 mphunter techies 	    3423 Jan 15 15:41 rman/Makefile
-rw-rw-r--  0 mphunter techies 	   40489 Jan 15 15:41 rman/rman.o
drwxrwxr-x  0 mphunter techies 	         Jan 16 10:13 rman/test
drwxrwxr-x  0 mphunter techies 	         Jan 15 15:43 rman/test/html
drwxrwxr-x  0 mphunter techies 	         Jan 15 15:44 rman/test/man1
-rw-rw-r--  0 mphunter techies 	    8019 Jan 15 15:38 rman/test/man1/rman.1
End