============================== F E A T U R E S ==============================

PolyglotMan takes man pages from most of the popular flavors of UNIX and
transforms them into any of a number of text source formats. PolyglotMan
was formerly known as RosettaMan. The name of the binary is still called
rman , for scripts that depend on that name; mnemonically, just think
"reverse man". Previously PolyglotMan required pages to be formatted by
nroff prior to its processing. With version 3.x, it prefers [tn]roff source
and usually produces results that are better yet. And source processing is
the only way to translate tables. Source format translation is not as
mature as formatted, however, so try formatted translation as a backup

This version 3.3 is able to convert man pages to:

- ASCII      -- plain text
- TkMan      -- Tk format wrapped with commands
- Tk         -- just emit list of text-tags pairs
- Sections   -- simple plain text reformat
- Roff       -- primitive analogue of roff
- HTML       -- HTML 4.0 standard document
- XML        -- DocBook XML support by by Aaron Hawley
- MIME       -- generates MIME compliant to RFC 1563
- LaTeX      -- typical LaTeX
- LaTeX2e    -- rest same as old LaTeX
- RTF        -- Rich Text Format (RTF) could use more work
- pod        -- Perl 5 pod, plain old documentation format
- AmigaGuide -- AmigaGuide support by Chris Young

Filters excluded from the application:

- PostScript -- Use groff or psroff to generate PostScript
- FrameMaker -- FrameMaker comes with filters that convert from roff to MIF

============================ R E Q U I R E M E N T ==========================

PolyglotMan tested and worked fine on the following configurations:

- IcarOS i386               (Kickstart 51.51, Workbench 40.0, AROS ABIv0)
- AROS One i386             (Kickstart 51.51, Workbench 40.0, AROS ABIv0)

================================= U S A G E =================================

In Wanderer (or WB) you can use a RMAN tool-script by aGGreSSor
It's more convenient for conversion to Text, RTF, AmigaGuide, HTML or XML.
(Optional) installation can be done by clicking on the "Install" icon.

You can improve a man pages conversion to HTML if you use RMAN for man->RTF
conversion and use RTF2HTML (from RTF-riddle package) for RTF->HTML 5.0.

PolyglotMan is not perfect in all cases, but it usually does a good job,
and in any case reduces the problem of converting man pages to light editing.

You may need to delete all text from the beginning of the man-file to .TH tag
in the source man-file for getting the best conversion.  This  is  especially
true for the AmigaGuide because unrecognized tags appearing in man pages 
after 2003 will be converted to spaces. An AmigaGuide file that starts with
spaces will not open.

However, all filters are available to you from CLI
AROS release improvements AmigaDOS version and help ? support

rman [ options ] [ file ]

[-f <filter>]

One of the following filters:
<ASCII|roff|TkMan|Tk|Sections|HTML|XML|MIME|LaTeX|LaTeX2e|RTF|pod|AmigaGuide>

[-S(ource of man page passed in)   [-F(ormatted man page passed in)]
[-r <man reference printf string>] [-i <title printf string>]
[-V(olume) <colon-separated list>] [-U(RLs as hyperlinks)]
[-b (show subsections)]            [-k(eep head/foot)]
[-n(ame of man page) <string>]     [-s(ection) <string>]
[-p(aragraph mode toggle)]         [-t(abstops spacing) <number>]
[-N(ormalize spacing, changebars)] [-y(zap hyphens toggle)]
[-K (declare that page has no breaks)]
[-d(iff) <file> (diff of old page source to incorporate)]
[-M(essage) <text> (included verbatim at end of Name section)]
[-R(ebus words for TkMan)]
[-o (no op)] [-O <arg> (no op with arg)]
[-q(uiet--don't report warnings)] [-h(elp)] [-v(ersion)]
[<filename>]

================================ S O U R C E ================================

Based on previous versions from aminet:
http://aminet.net/package/text/misc/rman
http://aminet.net/package/text/misc/rman-aguide
http://aminet.net/package/text/misc/rman_3.2_mos

AROS release created by

        ______ ______              ______ ______ 
 ______|:: .__|:: .__|_____ ______|:: ___|:: ___|______ _____ 
|: ,   |:  |  |:  |  |:  ,_|:  ,__|:___  |:___  |:  -  |:  ,_|
|__|___|______|______|___|   _____|______|______|______|___|

                home cross-compilation factory

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 9539   11420  83.5% -lh5- 530e Feb  6 14:03 RMan.info
[unknown]                52659  177316  29.7% -lh5- babd Feb  6 13:57 RMan/C/rman
[unknown]                16295   20920  77.9% -lh5- bda3 Oct  1 00:00 RMan/Docs.info
[unknown]                 3389    6629  51.1% -lh5- 69e8 Feb  6 02:24 RMan/Docs/CHANGES
[unknown]                 3843    5734  67.0% -lh5- f487 May 21  2009 RMan/Docs/CHANGES.info
[unknown]                  433     807  53.7% -lh5- b024 Jul 26  2003 RMan/Docs/MANIFEST
[unknown]                 3843    5734  67.0% -lh5- f487 May 21  2009 RMan/Docs/MANIFEST.info
[unknown]                 1160    2260  51.3% -lh5- e5ed Jul 26  2003 RMan/Docs/README-rman.txt
[unknown]                 3843    5734  67.0% -lh5- f487 May 21  2009 RMan/Docs/README-rman.txt.info
[unknown]                 5729   13618  42.1% -lh5- 4c62 Jul 26  2003 RMan/Docs/ReadMe.html
[unknown]                 3843    5734  67.0% -lh5- f487 May 21  2009 RMan/Docs/ReadMe.html.info
[unknown]                 2131    4599  46.3% -lh5- 0fa0 Feb  6 14:01 RMan/Docs/rman-3.3.i386-aros.readme
[unknown]                 3843    5734  67.0% -lh5- f487 May 21  2009 RMan/Docs/rman-3.3.i386-aros.readme.info
[unknown]                13154   35426  37.1% -lh5- 7f89 Feb  6 01:52 RMan/Example/man.1
[unknown]                 2341    5434  43.1% -lh5- 9a0d Feb  6 01:53 RMan/Example/mandb.8
[unknown]                 1913    4563  41.9% -lh5- a04d Feb  6 01:53 RMan/Example/manpath.5
[unknown]                  871    1890  46.1% -lh5- 7099 May 13  2020 RMan/Example/papersize.5
[unknown]                 5117   11935  42.9% -lh5- 992c Jul 26  2003 RMan/Example/rman.1
[unknown]                 1138    2482  45.9% -lh5- c399 Jul 26  2003 RMan/Example/rman_html_split.1
[unknown]                 3324    7436  44.7% -lh5- 4a20 Feb  6 02:30 RMan/Example/term.7
[unknown]                 5458   14912  36.6% -lh5- cdef Oct 22 00:00 RMan/Example/tzfile.5
[unknown]                  514    1807  28.4% -lh5- 515f Feb  5 16:31 RMan/Install
[unknown]                 1481    1824  81.2% -lh5- 0329 Oct 19 00:00 RMan/Install.info
[unknown]                  826    3014  27.4% -lh5- 76ec Feb  6 01:45 RMan/RMAN
[unknown]                 1187    1715  69.2% -lh5- 83e7 Feb 17  2015 RMan/RMAN.info
[unknown]                16178   17408  92.9% -lh5- 2850 Oct 26 00:00 RMan/Source.info
[unknown]                 9566   30115  31.8% -lh5- 3379 Jan 12  1999 RMan/Source/getopt.c
[unknown]                 1908    4591  41.6% -lh5- 0a58 Jan 12  1999 RMan/Source/getopt.h
[unknown]                  710    1355  52.4% -lh5- 3aa6 Feb  5 15:46 RMan/Source/Makefile
[unknown]                45224  147017  30.8% -lh5- 156c Feb  6 13:56 RMan/Source/rman.c
[unknown]                  353     536  65.9% -lh5- d148 Dec 26  2006 RMan/Source/Smakefile
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        31 files  221813  559699  39.6%            Feb  7 05:21