1
This directory contains files contributed by PolyglotMan users. These
2
files are not installed, supported or regularly updated to work with
3
new versions of PolyglotMan. They are included because some may find
4
them useful, and if so they prevent duplication of effort.
8
* sutter.txt - "Edward L. Sutter" <els@sage.sage.att.com>
10
"...converting "man" directories with their typical sub-directories of
11
man1, man2, etc... to an equivalently structured "html" directory with
12
the same sub-directory heirarchy."
14
"I added an option to rman that allows it to search for the files over
15
a specified set of directories. This allows (for example) manpages under
16
man1 that reference something under man3 to be properly linked."
20
* bennett.txt - Anne Bennett <anne@alcor.concordia.ca>
22
"... I applied the mods in contrib/sutter.txt, and then amplified
23
them. I append the relevant context diffs. In short, I added options
24
"-P" (a URL prefix for use with the paths found by "-S"), and "-H" and
25
"-F" (header and footer HTML files to help adjust the style of the
26
resulting page, for example by adding company logos,
27
return-to-home-page buttons, etc.)."
31
* authried.txt - Erwin Authried <eauth@mail4u.atnet.at>
33
"I wrote a small perl script (it's a quick hack) to view man-pages
34
with the web-browser."
38
* gzip.patch - Todd Larason <jtl@molehill.org>
40
"I keep several manpage hierarchies locally, for easy comparison when
41
programming for multiple unix machines, most of which are across a
42
relatively slow link. To save disk space, I keep them gzipped.
44
"Here's a small patch to make .so handling work against gzipped files.
45
It's a late-night-after-a-long-day hack, but it seems clean enough. If
46
you think there might be any interest, feel free to include it either in
47
rman itself or the contrib directory. It's against 3.0a3."
51
* man2html - Marc Donner (donner@fid.morgan.com)
53
A Korn Shell script that is moderately generic. It takes all the
54
files in a directory or a set of directories and does them one at a
55
time, putting the html output somewhere appropriate. The only
56
infelicity in the script is the stuff with localeo (local electronic
57
office) which is a hack put together to tweak the URLs not to refer to
58
localhost, which is broken right now, but directly to the local
63
* sco-wrapper.sh - Dag Nygren <dag@newtech.fi>
65
SCO puts the names of valid man page sections in the file /etc/default/man.
66
This wrapper extracts the names from this file and passes them on to
67
PolyglotMan for use in determining man page cross references.
71
* http-rman.{c,html} - Fredrik Lundh <fredrik@kalle.teragon.ivab.se>
73
An HTTP server using PolyglotMan to produce hypertext renditions of
78
* lewis.pl - Herb Lewis <herb@chomps.engr.sgi.com>
80
CGI bin script written in Perl.
84
* hman.{cgi,ksh,pl} by teto@geocities.com
85
A more recent version may be available at http://www.geocities.com/SiliconValley/Lakes/8777/hman.html
87
hman.cgi An example of a cgi-bin wrapper to launch hman.pl
88
Ideally, all customization should occur here
89
hman.ksh A stand-alone (non-browser) version of hman.cgi
90
hman.pl The core of the PolyglotMan front-end
92
"I've written a man to html front-end that appears to have unique features:
93
A second attempt to locate related man pages is made if the original
96
"Since PolyglotMan can filter nroff's output or can work with raw
97
nroff files, this viewer allows selection of the actual man page
98
file. Thus either raw or cooked man pages can be selected directly.
100
"The program is basic perl, but the implementation allows all customization
101
to be embodied in enviroment variables that should be set in a cgi-bin
106
* youki.pl - Youki Kadobayashi <youki@center.osaka-u.ac.jp>
108
CGI bin script written in Perl 5, and using CGI.pm
109
and thus "it can be accelerated with mod_perl".
113
rman_html_split - Robert Moniot <moniot@fordham.edu>
116
Breaks up rman HTML output in file (or standard input) into separate
117
section files, placing them into a directory. With manual page.
121
Other converters are not included in this directory, but rather are
122
available over the net:
124
* bsdi-man.pl - Fritz Heinrichmeyer
126
Available at: http://ES-sun2.fernuni-hagen.de
129
* bbc_man2html - Brooks Cutter (brooks@paradyne.com)
131
Available at: http://www.stuff.com/~bcutter/home/programs/bbc_man2html.html
134
* rman.pl - Alex Gagin
136
Available at: http://www.jinr.dubna.su/~gagin/rman.pl.html
138
(Be aware that the communications link is slow.)
141
* manner.pl - Ray W. Hiltbrand
143
Available at: ftp://ftp.eng.auburn.edu/pub/rayh/man2html/manner.pl
146
The active list kept at http://http.cs.berkeley.edu/~phelps/tcltk/polyglotmen.html