summaryrefslogtreecommitdiffstats
path: root/PROBLEMS
diff options
context:
space:
mode:
Diffstat (limited to 'PROBLEMS')
-rw-r--r--PROBLEMS258
1 files changed, 258 insertions, 0 deletions
diff --git a/PROBLEMS b/PROBLEMS
new file mode 100644
index 0000000..621ccc1
--- /dev/null
+++ b/PROBLEMS
@@ -0,0 +1,258 @@
+Lynx PROBLEMS file.
+
+Ideally you would never have to read this, but inevitably problems
+do arise. As implementation and installation problems become known
+they will be outlined in this file.
+
+---------
+
+ The install script will attempt to preserve your current settings in the
+ lynx.cfg file. You should review these (at the end of lynx.cfg) after
+ install. For instance references to lynx.browser.org for a startfile can
+ be removed, since that site is no longer maintained.
+
+---------
+
+ Some customized installs of OpenSSL are not detected by the configure
+ script. For example, with Redhat9, we did this to work around:
+
+ #!/bin/sh
+ KRB=/usr/kerberos
+ export LIBS="-L$KRB/lib -lssl -lcrypto -lgssapi_krb5 -lkrb5 -lk5crypto -lcom_err"
+ export CPPFLAGS="-I$KRB/include -I/usr/include/openssl"
+ export CFLAGS="-O -g $CPPFLAGS"
+ ./configure --with-ssl $*
+
+---------
+
+ The configure script check for IPv6 (--enable-ipv6) assumes that your build
+ machine can listen for IPv6 connections. It cannot determine if you want
+ to use it only for outgoing connections. If the configure script is
+ otherwise successful, it will warn about a nonfunctioning getaddrinfo()
+ function, and does not define these symbols needed to successfully compile
+ IPv6 support. You can work around this by by editing lynx_cfg.h:
+
+ HAVE_GAI_STRERROR
+ HAVE_GETADDRINFO
+
+---------
+
+ Control-Z on Unix can cause aberrant behavior. If you encounter
+ problems, use -restrictions=suspend to disable it, and only '!'
+ for escapes to shell (on VMS control-Z is unconditional 'Q'uit,
+ with no attempt to suspend the Lynx process only temporarily).
+ Control-Z on Unix often works better with slang.
+
+---------
+
+ Screen resizing can be a bit funny. If you resize the screen,
+ documents that have been cached will be out of whack. Any further
+ documents will look fine. You can reload documents to the current
+ window size with CTRL-R
+
+---------
+
+ If the configure script dies when it discovers that gcc is broken,
+ despite the fact there is a perfectly good ANSI cc in the PATH,
+ try setting the CC environment variable to your working cc compiler
+ before running configure: e.g.
+
+ setenv CC cc (or set CC=cc; export CC , depending on the shell)
+ ./configure
+
+---------
+
+ If you run into a problem compiling GridText.c, try omitting -O from the
+ compiler flags; it is a very big file and may not compile successfully
+ if you include optimization.
+
+---------
+
+ On a Sun system, the message:
+ "Alert!: Unable to connect to remote host"
+ will be displayed every time an attempt is made to access a host
+ other than localhost if Lynx has been built without the resolv
+ library and needed it, or with it and shouldn't have been.
+ Unfortunately, there's no way to check in the Makefile whether
+ -lresolv should be included in the LIBS="" list. What's necessary
+ depends on how that Sun is configured. To get the build right for
+ your SUN 3 or 4 OS, if you didn't have RESOLVLIB defined in the
+ Makefile define it and build Lynx again, or vice versa. Also, if
+ you have upgraded to the bind-8.1 or later library, you should try
+ changing -lresolv to -lbind.
+
+---------
+
+ On Sun systems when accessing sites that use multiple IPs for one URL,
+ you may experience a core dump. It's a bug in the resolver library,
+ which can be fixed by downloading & installing Sun's jumbo patch:
+ search Sun support information, e.g., Solaris newsgroups,
+ or see the following Lynx Archive items:
+
+ http://www.flora.org/lynx-dev/lynx-dev/9606/0422.html
+ http://www.flora.org/lynx-dev/html/month0497/msg01018.html
+ http://www.flora.org/lynx-dev/html/month0497/msg01064.html
+
+ The Sun `shelltool' and `cmdtool' terminals are stupid by default.
+ In order to get bold text to appear differently than inverse video,
+ the user should put this line in ~/.Xdefaults:
+
+ Term*boldStyle: Offset_X
+
+ From the `shelltool' man page, it seems that an analogous line
+ in ~/.defaults
+
+ /Tty/Bold_style "Offset_X"
+
+ ought to work just as well, but you may not get the desired
+ behavior until you modify your .Xdefaults file (and run `xrdb
+ ~/.Xdefaults'). Note also that there are other supported values
+ for the boldStyle resource/Bold_style default, all of which begin
+ with "Offset_". (helpful hint from kevin@traffic.den.mmc.com)
+
+---------
+
+ Directory browsing has been implemented for VMS, but there are no
+ plans to port additional DIRED support, because Lynx must handle files
+ as streams, and this precludes "serious" Directory/File Management on
+ VMS. Use a jumps file link to CSwing (sources or executables are
+ available from ftp://narnia.memst.edu), or define CSWING_PATH in
+ userdefs.h or lynx.cfg to invoke CSwing via the DIRED_MENU command.
+
+---------
+
+ If one switches between K)eypad "Numbers act as arrows" versus "Links
+ are numbered" in the 'o'ptions menu when the current document is a
+ DIRED menu in which links have been tagged, the tagging can be trashed
+ (so don't switch at such times 8-).
+
+---------
+
+ When "Links are numbered" is on, if a line is split on an anchor (to
+ obey right margin restrictions), and there is no space in the bolded
+ string such that the entire "[#]string" must be moved down, the "[#]"
+ becomes bolded, instead on only "string".
+
+---------
+
+ The Mosaic v2.5 hostlist uses HTML similar to that of Lynx's bookmark
+ file, but with </UL></HTML> at the bottom, such that it is not fully
+ compatible with Lynx's file. If you try to use the Mosaic file as if
+ it were a Lynx bookmark file, the </UL></HTML> will not be taken into
+ account and new links will be added below rather than above those end
+ tags. Instead, add a link to the Mosaic file in your Lynx file, and
+ to the Lynx file in your Mosaic file, so that you can access both files
+ with both clients.
+
+---------
+
+ SOCKSification and the -socks switch have not yet been integrated with
+ the slang library support.
+
+---------
+
+ There is an apparently broken version of select() in libcurses.a
+ of HP/UX 10.10. It also breaks tn3270, ncftp, emacs, and xemacs.
+ Using:
+ LIBS="-lc -lcurses -ltermcap \
+ ^^^
+ (i.e, adding -lc *before* the -lcurses) in the snake3 and snake3-slang
+ targets of the top level Makefile yields a usable image, but with
+ inappropriate video attributes on the Lynx displays (reverse video and
+ underscores on everything). Using "-lc -lHcurses" instead fixes the
+ ^^^^^^^^^
+ video attributes but then the arrow keys are messed up. - Donald S.
+ Teiser (dsteis01@homer.louisville.edu)
+ NOTE: If HP fixes the problem or you come up with a better workaround,
+ notify the lynx-dev@nongnu.org list.
+ Updated NOTE (1996-09-02): A patch reportedly is available from HP to
+ fix the select() problem, so that "-lc" is no longer needed, but
+ the curses glitch is not yet fixed, and you should still include
+ "-lHcurses".
+ Updated NOTE (1997-02-03): The problems reportedly are fixed with
+ patches PHCO_8086 and PHCO_8947 from HP.
+ Updated NOTE (1997-12-15): PHCO_8086 & PHCO_8947 are very old and are
+ no longer available. The current patch to install if running
+ under HP-UX 10.20 is PHCO_11342.
+
+---------
+
+ Lynx juggles variable abilities of curses packages or emulations to
+ display bolding and underlining simultaneously. This may fail if
+ Lynx thinks that your terminal, in connection with the curses package,
+ supports a capability which the terminal hardware or emulation does not
+ in fact support. Setting the right TERM environment variable, tweaking
+ terminfo or termcap files, or compiling with a newer version of ncurses
+ or slang may solve problems with missing highlighting or strange
+ characters appearing on the screen. Also, for a mono terminal,
+ make sure "show color" is not set to ON in the Options Menu.
+
+ The Wyse 50 and older TeleVideo terminals, among others, are
+ "magic cookie" terminals. This means that display attributes like
+ reverse, blink, underline, etc. work in a bizarre way that makes them
+ difficult to program. You may see extra spaces scattered around your
+ screen (separating different sorts of highlight); or sections of the
+ screen may be unexpectedly highlighted.
+ There is a workaround which works by restricting the terminal to a
+ single standout attribute (e.g., normal and reverse, but no others).
+ Implementing the workaround is specific to your curses implementation.
+ Most versions of curses use one of two terminal databases, called
+ "termcap" and "terminfo". Updating these databases is system-specific.
+ New databases should be available from the vendor or other sources.
+ For the Wyse 50, try
+ <URL: http://www.wyse.com/text/custserv/faq/wy50faq.htm>;
+ extract the "wy50" (NOT "wy50-mc") entry and use that in place of the
+ existing one. See `terminfo', `infocmp', `tic' etc. man pages if
+ necessary.
+ Alternatively, compiling Lynx with the slang library may avoid problems
+ with these terminals.
+
+ The Sun console driver (aka wscons(7)) implements "reverse" and "bold"
+ as "reverse", causing confusion where Lynx uses the distinction between
+ the two to convey information. Lynx tries to detect this automatically,
+ but if it fails (for instance, you are running under "screen"), try
+ setting the -noreverse commandline option.
+
+---------
+
+ On VMS, Lynx, and other TCP-IP software, have been experiencing chronic
+ problems of incompatibilities between DECC and MultiNet headers whenever
+ new versions of either DECC or MultiNet are released. The Lynx build
+ procedure for VMS and a maze of spaghetti #ifdef-ing in tcp.h of the
+ libwww-FM had previously been successful in dealing with this problem
+ across all versions of MultiNet and of DECC, VAXC, and Pat Rankin's
+ VMS port of GNUC, but are now not 100% successful. If you get compiler
+ messages about "struct timeval timeout" having no linkage, add that
+ declaration immediately below the inclusion of ioctl.h for MultiNet in
+ tcp.h (by deleting the "#ifdef NOT_DEFINED" and "#endif /* NOT_DEFINED */"
+ lines):
+ [...]
+ #include "multinet_root:[multinet.include.sys]ioctl.h"
+ struct timeval {
+ long tv_sec; /* seconds since Jan. 1, 1970 */
+ long tv_usec; /* microseconds */
+ };
+ [...]
+ If you get compiler warnings about incompatible multinet_foo()
+ declarations, delete those where indicated in tcp.h. For the most
+ current versions of MultiNet, you can modify tcp.h to use the DECC
+ socket and related headers.
+
+ On VMS, the ftp function does not work with SOCKETSHR 0.9D and NETLIB
+ 2 (NETLIB 1 may work). This is because the functions getsockname()
+ and getpeername() within SOCKETSHR make incorrect calls to the NETLIB
+ functions. This results in zeroes being returned for part of the local
+ IP address. Since ftp sends this IP address to the remote end, the
+ remote server ends up sending a file back to a non-existent address.
+ Andy Harper (A.HARPER@kcl.ac.uk) has fixed these problems in the
+ SOCKETSHR 0.9D sources and offers the fixes as:
+ http://alder.cc.kcl.ac.uk/fileserv/zip/socketshr_src_09d-2.zip
+ ftp://ftp2.kcl.ac.uk/zip/socketshr_src_09d-2.zip
+
+---------
+
+ On VMS, to build an SSL-capable version, lynx and the ssl library
+ e.g., OpenSSL, must be built using the same network library. If you
+ build OpenSSL without specifying the network library (the 5th parameter
+ of the makevms.com script), it will guess, possibly not the one you
+ intended. We have tested only the UCX configuration -TD (2002/9/15).