aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/extras/rman/ANNOUNCE-rman
diff options
context:
space:
mode:
Diffstat (limited to 'nx-X11/extras/rman/ANNOUNCE-rman')
-rw-r--r--nx-X11/extras/rman/ANNOUNCE-rman78
1 files changed, 0 insertions, 78 deletions
diff --git a/nx-X11/extras/rman/ANNOUNCE-rman b/nx-X11/extras/rman/ANNOUNCE-rman
deleted file mode 100644
index 209b843a9..000000000
--- a/nx-X11/extras/rman/ANNOUNCE-rman
+++ /dev/null
@@ -1,78 +0,0 @@
-======================================================================
-
-PolyglotMan (nee RosettaMan) is a filter for UNIX manual pages. It
-takes as input man pages for a variety of UNIX flavors and produces as
-output a variety of file formats. Currently PolyglotMan accepts man
-pages from the following flavors of UNIX: Hewlett-Packard HP-UX, AT&T
-System V, SunOS, Sun Solaris, OSF/1, DEC Ultrix, SGI IRIX, Linux, SCO,
-FreeBSD; and produces output for the following formats: printable
-ASCII only (stripping page headers and footers), section and
-subsection headers only, TkMan, [tn]roff, RTF, SGML (soon--I finally
-found a DTD), HTML, MIME, LaTeX, LaTeX 2e, Perl 5's pod. Previously
-<I>PolyglotMan</I> required pages to be formatted by nroff prior to
-its processing; with version 3.0, it prefers [tn]roff source and
-usually can produce results that are better yet.
-
-PolyglotMan improves upon 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 variant
-macros of many different flavors of UNIX, and (4) it doesn't require
-modification of or cooperation with any other program.
-
-PolyglotMan 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, PolyglotMan 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.
-
-A note for HTML consumers: This filter does real (heuristic) parsing--
-no <PRE>! Man page references are turned into hypertext links. The files
-<URL:ftp://ftp.cs.berkeley.edu/ucb/people/phelps/tcltk/sgi-ls.1.html>
-and <URL:ftp://ftp.cs.berkeley.edu/ucb/people/phelps/tcltk/ksh.1.html>
-are examples of the quality of output produced entirely automatically
-(no retouching) by PolyglotMan. These translations were produced by
-PolyglotMan starting with the [tn]roff source (again no retouching).
-Several people have extended World Wide Web servers to format man pages
-on the fly. Check the README file in the contrib directory for a list.
-
-
-CHANGES in 3.0
-
-* [tn]roff source preferred for superior results, when roff macros are
- sufficiently recognized. Autodetection of source or formatted input.
-* New software license that makes it free for any use
-
-
-CHANGES in 2.5
-
-* SGML output format that adheres to Davenport DocBook v2.3 DTD
- (NOT READY IN CURRENT VERSION!)
-* MIME output format, for e-mail and Emacs 19.29's enriched mode
- (Neal Becker)
-* port to Macintosh by Matthias Neeracher
-* list of valid volume names can be given as a parameter (Dag Nygren)
-* updated to LaTeX2e (H. Palme)
-* debugging scaffolding erected (at the end of software's development cycle!)
-
-
-CHANGES in 2.2
-
-* when in SEE ALSO, hyphens would confuse man page-reference finder,
- so re-linebreak if necessary to eliminate them (!) (Greg Earle & Uri Guttman)
-
-
-CHANGES in 2.1
-
-* gets() replaced by custom code. gets() deprecated since it reads until \0,
- introducing security problems. (Robert Withrow)
-
-* TkMan module revised for Tk 4.0