[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
lynx-dev (patch) INSTALLATION
From: |
Philip Webb |
Subject: |
lynx-dev (patch) INSTALLATION |
Date: |
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 <=