[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
lynx-dev (patch) INSTALLATION
lynx-dev (patch) INSTALLATION
Thu, 25 Nov 1999 17:04:23 -0500 (EST)
below is a patch to tidy up & clarify `General Configuration Instructions
(all ports)' in INSTALLATION; i hope it doesn't change any content.
please read it from the point of view of Joe User or Jill Sysadmin,
who are approaching Lynx for the first time.
--- old/INSTALLATION Sat Aug 28 15:04:14 1999
+++ new/INSTALLATION Thu Nov 25 16:42:20 1999
@@ -25,62 +25,76 @@
Follow the instructions given immediately below to configure for your system,
and then go to the respective section concerning the port you wish to compile.
I. General configuration instructions (all ports).
-Step 1. (define compile-time variables -- See the userdefs.h file.)
- There are a few variables that MUST be defined, or Lynx will not build.
- There are a few more that you will probably want to change. The variables
- that must be changed are marked as such in the userdefs.h file. Just edit
- this file, and the changes should be straight forward. If you compile
- using autoconfigure, you can set most defines with option switches and do
- not absolutely have to edit userdefs.h. Many of the variables are now
- configurable in the lynx.cfg file, so you may set them at run-time if you
- wish. Lynx implements Native Language Support. Read "ABOUT-NLS" if you
- want to build an international version of Lynx or tailor the statusline
- prompts, messages and warnings to the requirements of your site.
-Step 2. (define run-time variables -- See the lynx.cfg file for details.)
- Set up local printers, downloaders, assumed character set, key mapping,
- and colors in the lynx.cfg file. Please read "lynx.cfg" thoroughly as
- many of the features of Lynx, and how to use them, are explained. Also
- see the example mime.types, mailcap and jumps files in the samples
- subdirectory. Lynx MUST be able to find the lynx.cfg file at start-up.
- The location of the lynx.cfg file may be compiled in with the LYNX_CFG_FILE
- defined in userdefs.h (or with the configure option explained in the Unix
- section below), specified with an environment variable, LYNX_CFG, or
- specified with the "-cfg" command line option.
-Step 3. (You may skip this step if you are not interested in any special
- characters and any local files or WWW pages you will view all use the
- ISO-8859-1 "ISO Latin 1" Western European character set.) People who
- will be running Lynx in an environment with different and incompatible
- character sets should configure CHARACTER_SET (the Display character set)
- and ASSUME_LOCAL_CHARSET to work correctly for them before creating
- bookmark files et cetera. Read "lynx.cfg" for detailed instructions.
- Additional character sets and their properties may be defined with tables
- in the src/chrtrans directory, see the README.* files therein.
-Step 4. (optional -- news for UNIX and VMS)
- Set NNTPSERVER in "lynx.cfg" to your site's NNTP server, or set the
- environment variable externally. For news posting ability to be enabled
- in Lynx, the NEWS_POSTING symbol must be defined to TRUE in userdefs.h or
- lynx.cfg. Also define LYNX_SIG_FILE in userdefs.h or lynx.cfg so that it
- points to users' signature files for appending to posted messages.
-Step 5. (Anonymous account -- VERY IMPORTANT!!!!! -- )
- If you are building Lynx for your personal use only you may skip this
- step. If you are setting up an anonymous account with Lynx, you are
- STRONGLY advised to use the -anonymous command line option. If you do
- not use this option, users may be able to gain access to all readable
- files on your machine! ALSO NOTE that many implementations of telnetd
- allow passing of environment variables, which might be used by
- unscrupulous people to modify the environment in anonymous accounts.
- When making Web access publicly available via anonymous accounts intended
- to run Lynx captively, be sure the wrapper uses the -cfg and -homepage
- switches to specify the configuration and start files, rather than relying
- on the LYNX_CFG, LYNX_CFG_FILE, or WWW_HOME variables.
+Step 1. Compile-time Variables.
+ There are a few variables that MUST be defined in order for Lynx to build
+ and there are others you may want to change.
+ If you are using configure (e.g. with UNIX or Cygwin), you don't strictly
+ need to make any changes in userdefs.h , but it is wise to check there
+ to make sure e.g. that the location of lynx.cfg is correctly defined.
+ There are a few variables you can't define with configure --switches
+ but can define in userdefs.h , e.g. numbering fields as well as links.
+ Many variables which can be defined with configure or userdefs.h
+ can also be defined in lynx.cfg or via the Options Page (key `o').
+ Lynx implements Native Language Support. Read "ABOUT-NLS", if you want
+ to build an international version of Lynx or tailor status-line prompts,
+ messages and warnings to the requirements of your site.
+Step 2. Run-time Variables.
+ Lynx MUST be able to find lynx.cfg at start-up: its location
+ can be compiled in with LYNX_CFG_FILE defined in userdefs.h
+ or with the configure option explained in the Unix section below,
+ or may be specified with environment variable LYNX_CFG
+ or with the "-cfg" command-line option.
+ Read lynx.cfg thoroughly, as many Lynx features and how to use them
+ are explained there, in some cases ONLY there. Set up local printers,
+ downloaders, assumed character set, key mapping and colors in lynx.cfg .
+ Also see the sample mime.types, mailcap and jumps files
+ in the samples subdirectory.
+Step 3. Alternative Character Sets.
+ You may skip this, if you are not interested in special characters
+ and all local files or WWW pages you will view will use the ISO-8859-1
+ "ISO Latin 1" Western European character set.
+ If you will be running Lynx in an environment with different incompatible
+ character sets, configure CHARACTER_SET (the Display character set)
+ and ASSUME_LOCAL_CHARSET to work correctly before creating bookmark files
+ and other such items: read "lynx.cfg" for detailed instructions.
+ Additional character sets and their properties may be defined with tables
+ in the src/chrtrans directory: see the README.* files therein.
+Step 4. News for UNIX and VMS.
+ Set NNTPSERVER in "lynx.cfg" to your site's NNTP server, or set the
+ environment variable externally. For news posting ability to be enabled
+ in Lynx, the NEWS_POSTING symbol must be defined to TRUE in userdefs.h or
+ lynx.cfg. Also define LYNX_SIG_FILE in userdefs.h or lynx.cfg so that it
+ points to users' signature files for appending to posted messages.
+Step 5. Anonymous accounts *** VERY IMPORTANT!!!!! ***
+ If you are building Lynx for personal use only, you should skip this.
+ If you are setting up anonymous accounts to use Lynx captively,
+ i.e. making Web access publicly available to unknown users
+ who should not be allowed any other type of access to your system,
+ you are STRONGLY advised to use the -anonymous command-line option:
+ if you do not use this option, users may be able to gain access
+ to all readable files on your machine!
+ Many implementations of telnetd allow passing of environment variables,
+ which might be used to modify the environment in anonymous accounts,
+ allowing mischief or damage by malicious users, so make sure the wrapper
+ uses the -cfg and -homepage switches to specify lynx.cfg and start-file,
+ rather than relying on variables LYNX_CFG, LYNX_CFG_FILE and WWW_HOME.
II. Compile instructions -- UNIX
SUPPORT ___________//___, Philip Webb : address@hidden
ELECTRIC /]     | Centre for Urban & Community Studies
TRANSIT `-O----------O---' University of Toronto
- lynx-dev (patch) INSTALLATION,
Philip Webb <=