lynx-dev
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

lynx-dev Re: [2.8.2dev.8] Revised LYPrint and ENV VARS documentation pat


From: Kim DeVaughn
Subject: lynx-dev Re: [2.8.2dev.8] Revised LYPrint and ENV VARS documentation patch (was: Env var documentation)
Date: Sat, 12 Dec 1998 14:43:55 -0800

On Wed, Dec 09, 1998, Klaus Weide (address@hidden) said:
|
| > > +\fIgettext\fR(GNU),
| > > +\fIwget\fR(GNU)
|
| Is the (GNU) right anywhere?
| I have wget(1), no gettext(anything).
| Debian GNU/Linux with wget, gettext, gettext-doc packages installed.

The current releases of gettext and wget available at prep.ai.mit.edu
don't have any man pages in their distributions.

I think this is part of the misguided (IMNSHO) attempt by the gnu-folk
to eliminate man pages, in favor of info pages.  Both packages *do* have
info pages; also the man pages of recent releases of various gnu utility
packages, include mush-words like the following in them:

 >DESCRIPTION
 >       This documentation is no longer being maintained  and  may
 >       be inaccurate or incomplete.  The Texinfo documentation is
 >       now the authoritative source.
 >
 >       This manual page documents the GNU version of ls.  dir and
 >       vdir are versions of ls with different default output for-


| No slang man pages (do they exist?), but slang has VMS help files
| (at least it used to).

In the current 1.2.2 release of slang, there is one .hlp doc in the doc/OLD
subdir.  Everything else (presumably the current docs), are in the form of
.txt files, README, etc.


Ah well, I had meant to include curses/ncurses in my previous patch anyway,
so here's a patchlet to be applied ON TOP OF my lengthy 12/09/98 patch, that
I think clarifies things.


One thing that is still missing from the man page, is a good REFERENCES
section.  Perhaps someone who's familier with the various HTTP and HTML
specs, appropriate RFC's, and whatnot, could add such a section ...?

/kim


Against 2.8.2dev.8 WITH my 12/09/98 patch already applied:

diff -uNr lynx-2.8.2-dev.8.orig/lynx.hlp lynx-2.8.2-dev.8+kd/lynx.hlp
--- lynx-2.8.2-dev.8.orig/lynx.hlp      Wed Dec  9 11:07:38 1998
+++ lynx-2.8.2-dev.8+kd/lynx.hlp        Sat Dec 12 13:53:37 1998
@@ -756,8 +756,23 @@
  Do not send the unsubscribe message to the lynx-dev list, itself.
 
 2 SEE ALSO
-       environ(7),  execve(2),  ftp(1),   gettext(GNU),   locale-
-       conv(3), setlocale(3), termcap(5), terminfo(5), wget(GNU)
+       catgets(3),   curses(3),  environ(7),  execve(2),  ftp(1),
+       gettext(GNU),  localeconv(3),  ncurses(3),   setlocale(3),
+       slang(?), termcap(5), terminfo(5), wget(GNU)
+
+       Note  that  man page availability and section numbering is
+       somewhat platform dependent, and may vary from  the  above
+       references.
+
+       A  section  shown as (GNU), is intended to denote that the
+       topic may be available via an info page, instead of a  man
+       page  (ie, try "info subject", rather than "man subject").
+
+       A section shown as (?) denotes that documentation  on  the
+       topic exists, but is not part of an established documenta-
+       tion retrieval system (see the distribution files  associ-
+       ated  with the topic, or contact your System Administrator
+       for further information).
 
 2 ACKNOWLEDGMENTS
  Lynx has incorporated code from a variety of sources along the way.
diff -uNr lynx-2.8.2-dev.8.orig/lynx.man lynx-2.8.2-dev.8+kd/lynx.man
--- lynx-2.8.2-dev.8.orig/lynx.man      Wed Dec  9 11:02:52 1998
+++ lynx-2.8.2-dev.8+kd/lynx.man        Sat Dec 12 13:46:39 1998
@@ -779,15 +779,33 @@
 "unsubscribe lynx-dev" as the only line in the body of your message.
 Do not send the unsubscribe message to the lynx-dev list, itself.
 .SH SEE ALSO
+.hy 0
+\fIcatgets\fR(3),
+\fIcurses\fR(3),
 \fIenviron\fR(7),
 \fIexecve\fR(2),
 \fIftp\fR(1),
 \fIgettext\fR(GNU),
 \fIlocaleconv\fR(3),
+\fIncurses\fR(3),
 \fIsetlocale\fR(3),
+\fIslang\fR(?),
 \fItermcap\fR(5),
 \fIterminfo\fR(5),
 \fIwget\fR(GNU)
+.hy 1
+.PP
+Note that man page availability and section numbering is somewhat
+platform dependent, and may vary from the above references.
+.PP
+A section shown as (GNU), is intended to denote that the topic
+may be available via an info page, instead of a man page (ie, try
+"info subject", rather than "man subject").
+.PP
+A section shown as (?) denotes that documentation on the topic exists,
+but is not part of an established documentation retrieval system (see
+the distribution files associated with the topic, or contact your
+System Administrator for further information).
 .SH ACKNOWLEDGMENTS
 Lynx has incorporated code from a variety of sources along the way.
 The earliest versions of Lynx included code from Earl Fogel of Computing
##--eof--##

reply via email to

[Prev in Thread] Current Thread [Next in Thread]