[pkg-lynx-maint] Bug#791424: lynx: man-page references non-existent document, and web doc is on a to site

[Anonymous]

Package: lynx
Version: 2.8.9dev1-2
Severity: normal

Dear Maintainer,

Basic syntax for the http_proxy variable is incomplete.  The man page
reads:

  PROTOCOL_proxy

     Lynx supports the use of proxy servers that can act
     as firewall gateways and caching servers.  They are
     preferable   to  the  older  gateway  servers  (see
     WWW_access_GATEWAY, below).  Each protocol used  by
     Lynx,  (http,  ftp,  gopher,  etc),  can  be mapped
     separately by setting environment variables of  the
     form    PROTOCOL_proxy    (literally:   http_proxy,
     ftp_proxy,       gopher_proxy,       etc),       to
     “http://some.server.dom:port/”.    See  Lynx  Users
     Guide for additional details and examples.

It does not list all protocols available.  It does not provide the
format for proxies that require authentication (although one might
guess that it's the same format as RFC-compliant URLs).

Perhaps the biggest problem is that the man page references the "Lynx
User's Guide", but the debian distribution does not include it.
Running "info lynx" only gives another copy of the man page.  And
/usr/share/doc is only has:

/usr/share/doc/lynx/changelog.gz
/usr/share/doc/lynx/copyright
/usr/share/doc/lynx/changelog.Debian.gz

And worse, a web search only reveals this tor-hostile page:

  http://lynx.isc.org/lynx2.8.5/lynx2-8-5/lynx_help/Lynx_users_guide.html

Which reads:

  Forbidden

  You don't have permission to access /lynx2.8.5/lynx2-8-5/lynx_help/Lynx_users_guide.html on this server.

If tor users supply the query "!cache
http://lynx.isc.org/lynx2.8.5/lynx2-8-5/lynx_help/Lynx_users_guide.html"
to duckduckgo, then a cached version of the user's guide is available
-- but it does not include any examples that the man page claimed it
would have!  There is no more proxy information here than the man page
had.


-- System Information:
Debian Release: 8.1
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.16.0-4-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages lynx depends on:
ii  lynx-cur  2.8.9dev1-2+b1

lynx recommends no packages.

lynx suggests no packages.

-- no debconf information