lynx-dev
[Top][All Lists]
Advanced

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

lynx-dev dev.17 (patch): Options Menu


From: Philip Webb
Subject: lynx-dev dev.17 (patch): Options Menu
Date: Wed, 1 Dec 1999 19:27:47 -0500 (EST)

this is a new patch vs the files in the dev.16 breakout,
covering the Options Menu & other changes omitted previously.
i've also restored a couple of `see's'.

--- old/INSTALLATION    Wed Dec  1 17:13:47 1999
+++ new/INSTALLATION    Wed Dec  1 17:26:51 1999
@@ -29,16 +29,20 @@
 
 Step 1.  Compile-time Variables.
 
-  There are a few variables that MUST be defined in order for Lynx to build
+  There are a few variables that MUST be defined if Lynx is 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.
+  Lynx MUST be able to find lynx.cfg at start-up: using configure
+  (e.g. with UNIX or Cygwin), its location is best set with --libdir ;
+  you can check in lynx_cfg.h after configure has run, if you wish.
+  otherwise, you can use LYNX_CFG_FILE in userdefs.h ,
+  environment variable LYNX_CFG or the -cfg command-line option.
+
+  If you are using configure, you need not make any changes in userdefs.h .
+  There are a few variables you can't define with configure --options
+  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').
+  can also be defined in lynx.cfg or via the Options Menu.
 
   Lynx implements Native Language Support.  Read "ABOUT-NLS", if you want
   to build an international version of Lynx or tailor status-line prompts,
@@ -46,12 +50,6 @@
 
 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 .
@@ -67,30 +65,30 @@
   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.
+  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.
+Step 4.  News.
 
-  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.
+  Set NNTPSERVER in lynx.cfg to your site's NNTP server
+  or set the environment variable externally.  For posting to be enabled,
+  NEWS_POSTING must be 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 messages.
 
-Step 5.  Anonymous accounts *** VERY IMPORTANT!!!!! ***
+Step 5.  Anonymous Accounts *** VERY IMPORTANT!!!!! ***
 
-  If you are building Lynx for personal use only, you should skip this.
+  If you are building Lynx for personal use only, you can 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,
+  i.e. making Web access publicly available to 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,
@@ -253,22 +250,18 @@
         Do not compile-in code used to connect to FTP servers.
 
   --disable-forms-options               (define NO_OPTION_FORMS)
-        Disable the forms-based options screen.  (See --disable-menu-options).
-        The default behavior is to compile both forms and menu options code
-        with FORMS_OPTIONS switch in lynx.cfg, or -forms_options command-line
-        switch.
+       Disable the Form-based Options Menu (see --disable-menu-options).
+       The default is to compile key-based & form-based Options Menu code,
+       allowing users the final choice via FORMS_OPTIONS in lynx.cfg
+       or the -forms_options command-line switch.
 
   --disable-gopher                      (define DISABLE_GOPHER)
         Do not compile-in code used to connect to GOPHER servers.
@@ -280,23 +273,19 @@
         enabled, the actual directory style is configurable from lynx.cfg).
 
   --disable-menu-options                (define NO_OPTION_MENU)
-        Disable the menu-style options screen.  (See --disable-forms-options).
-        The default behavior is to compile both styles options menu code with
-        FORMS_OPTIONS switch in lynx.cfg, or -forms_options command-line
-        switch.
+       Disable the Key-based Options Menu.
+       See --disable-forms-options (above) for further details.
 
   --disable-news                        (define DISABLE_NEWS)
         Do not compile-in code used to connect to NNTP (netnews) servers.
         
--- old/PROBLEMS        Wed Dec  1 17:10:17 1999
+++ new/PROBLEMS        Fri Nov 26 12:48:39 1999
@@ -127,8 +127,8 @@
     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
-    that there is no "show color (&)  : ON" on the Options screen.
+    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
 
--- old/lynx.cfg        Wed Dec  1 18:12:56 1999
+++ new/lynx.cfg        Wed Dec  1 18:30:33 1999
@@ -491,8 +491,8 @@
 #URL_DOMAIN_PREFIXES:www.
 #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org
 
-# Lynx Options Menu style toggle:  forms-based or old-style.
-# Works if old-style menu is compiled in as well as the forms-based menu.
+# Toggle whether the Options Menu is key-based or form-based;
+# the key-based version is available only if specified at compile time.
 #FORMS_OPTIONS:TRUE
 
 # Display partial pages while downloading
@@ -1078,14 +1078,9 @@
 #
 #USE_FIXED_RECORDS:TRUE
 
-# VI_KEYS can be turned on by the user in the options
-# screen or the .lynxrc file.  This is just the default.
-#
+# Vi or Emacs movement keys, i.e. familiar hjkl or ^N^P^F^B .
+# These are defaults, which can be changed in the Options Menu or .lynxrc .
 #VI_KEYS_ALWAYS_ON:FALSE
-
-# EMACS_KEYS can be turned on by the user in the options
-# screen or the .lynxrc file.  This is just the default.
-#
 #EMACS_KEYS_ALWAYS_ON:FALSE
 
 # DEFAULT_KEYPAD_MODE specifies whether numbers work like arrows or
@@ -1155,22 +1150,20 @@
 #
 #DEFAULT_USER_MODE:NOVICE
 
-# DEFAULT_EDITOR sets the default editor for Lynx users.
-# If an editor is defined then the user may edit local documents
-# using that editor.  The editor will also be used for sending
-# mail messages.  If no editor is defined here or by the user
-# the user will not be able to edit local documents and a primitive
-# line oriented mail input mode will be used.
-# NOTE: Do not define an editor unless you know that every user will
-#       know how to use it.  Most users do not enjoy getting stuck in
-#       an unknown editor that they can't exit.  Users can
-#       easily define an editor of their own using the options menu,
-#       so it is not always desirable to set the DEFAULT_EDITOR.
+# If DEFAULT_EDITOR is defined, users may edit local documents with it
+# & it will also be used for sending mail messages.
+# If no editor is defined here or by the user,
+# the user will not be able to edit local documents
+# and a primitive line-oriented mail-input mode will be used.
+#
+# For sysadmins: do not define a default editor
+# unless you know EVERY user will know how to use it;
+# users can easily define their own editor in the Options Menu.
 #
 #DEFAULT_EDITOR:
 
-# SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR except that it can't be
-# changed.
+# SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR,
+# except that it can't be changed by users.
 #
 #SYSTEM_EDITOR:
 
@@ -1216,10 +1209,12 @@
 # for the .mil domain as well as the .il domain.  If the entry is '.il' this
 # will not happen.
 
-# PRINTER & DOWNLOADER DEFINITIONS:
+# PRINTER, DOWNLOADER & UPLOADER DEFINITIONS:
 # Lynx has 4 pre-defined print options & 1 pre-defined download option,
 # which are called up on-screen when `p' or `d' are entered;
 # any number of options can be added by the user, as explained below.
+# Uploaders can be defined only for UNIX with DIRED_SUPPORT:
+# see the Makefile in the top directory & the header of src/LYUpload.c .
 #
 # For `p' pre-defined options are: `Save to local file', `E-mail the file',
 # `Print to screen' and `Print to local printer attached to vt100'.
@@ -1260,7 +1255,7 @@
 # `Printer' can be any file-handling program you find useful,
 # even if it does not physically print anything.
 #
-# Usually, downloading involves the use of (e.g.) Ckermit or ZModem
+# Usually, down/up-loading involves the use of (e.g.) Ckermit or ZModem
 # to transfer files to a user's local machine over a serial link,
 # but download options do not have to be download-protocol programs.
 #
@@ -1293,39 +1288,15 @@
 # by using a script to make a subdirectory in /tmp,
 # but may conflict with very strong security or permissions restrictions:
 #DOWNLOADER:Use Zmodem to download to the local terminal:set %s 
%s;td=/tmp/Lsz$$;mkdir $td;ln -s $1 $td/"$2";sz $td/"$2";rm -r $td:TRUE
-
-# Note for OS/390: The following is strongly recommended  /* S/390 -- gil -- 
1464 */
-# to undo ASCII->EBCDIC conversion.
+# Uploader examples:
+ #UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE
+ #UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE
+ 
+# Note for OS/390: /* S/390 -- gil -- 1464 */
+# The following is strongly recommended to undo ASCII->EBCDIC conversion.
 #
 #DOWNLOADER:Save OS/390 binary file: iconv -f IBM-1047 -t ISO8859-1 %s 
>%s:FALSE
 
-# Unix ONLY:
-#===========
-# Uploader definitions (implemented only with Unix DIRED_SUPPORT;
-#                       see the Makefile in the top directory,
-#                      and the header of ./src/LYUpload.c)
-# any number of uploaders may be defined by using multiple
-# uploader definition sets.  Uploaders may be any programs
-# that could be useful to your users; they do not necessarily
-# have to be upload protocol programs.  The most common use
-# of an uploader is to use Ckermit or some other transfer
-# program so that the user may easily transfer files from
-# their local machine over a serial link.
-#
-# the definition of an uploader is of the same form as a downloader
-# UPLOADER:<uploadername>:<uploader command>:<uploader option>
-#
-#  You must put the whole definition on one line.
-#
-#  If you must use a colon, precede it with a backslash!
-#
-#  If you do not include a %s, you will not be prompted for an
-#  output filename.
-#
-#    example
-#UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE
-#UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE
-
 # If NO_DOT_FILES is TRUE (normal default via userdefs.h), the user will not
 # be allowed to specify files beginning with a dot in reply to output filename
 # prompts, and files beginning with a dot (e.g., file://localhost/path/.lynxrc)
@@ -1406,7 +1377,7 @@
 # The definition here will override that in userdefs.h
 # and can be toggled via an "-image_links" command-line switch.
 # The user can also use the LYK_IMAGE_TOGGLE key (default `*')
-# or the `Show Images' option in the (new) Options Form.
+# or `Show Images' in the Form-based Options Menu.
 #
 #MAKE_LINKS_FOR_ALL_IMAGES:FALSE
 
@@ -1420,7 +1391,7 @@
 # The definition here will override that in userdefs.h
 # and can be toggled via a "-pseudo_inlines" command-line switch.
 # The user can also use the LYK_INLINE_TOGGLE key (default `[')
-# or the `Show Images' option in the (new) Options Form.
+# or `Show Images' in the Form-based Options Menu.
 #
 #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE
 
--- old/lynx.hlp        Wed Dec  1 17:12:02 1999
+++ new/lynx.hlp        Wed Dec  1 18:39:10 1999
@@ -184,7 +184,7 @@
               toggles forcing of the secure flag for SSL cookies.
 
        -forms_options
-              toggles the style of options (menu or forms).
+             toggles whether the Options Menu is key-based or form-based.
 
        -from  toggles transmissions of From headers.
 
--- old/lynx.man        Wed Dec  1 18:40:46 1999
+++ new/lynx.man        Wed Dec  1 18:41:55 1999
@@ -198,7 +198,7 @@
 toggles forcing of the secure flag for SSL cookies.
 .TP
 .B -forms_options
-toggles the style of options (menu or forms).
+toggles whether the Options Menu is key-based or form-based.
 .TP
 .B -from
 toggles transmissions of From headers.
 
--- old/userdefs.h      Wed Dec  1 18:43:43 1999
+++ new/userdefs.h      Wed Dec  1 18:59:37 1999
@@ -1002,18 +1002,17 @@
 #if defined(EXEC_LINKS) || defined(EXEC_SCRIPTS)
 
 /**********
- * if ENABLE_OPTS_CHANGE_EXEC
- * is defined then the user will be able to change
- * the execution status within the options screen.
+ * if ENABLE_OPTS_CHANGE_EXEC is defined, the user will be able to change
+ * the execution status within the Options Menu.
  */
 /* #define ENABLE_OPTS_CHANGE_EXEC */
 
 /**********
- * if NEVER_ALLOW_REMOTE_EXEC is defined then local execution of
- * scripts or lynxexec and lynxprog URLs will only be implemented
- * from HTML files that were accessed via a "file://localhost/" URL,
- * and the options menu for "L)ocal executions links" will only
- * allow toggling between "ALWAYS OFF" and "FOR LOCAL FILES ONLY".
+ * if NEVER_ALLOW_REMOTE_EXEC is defined,
+ * local execution of scripts or lynxexec & lynxprog URLs will be implemented
+ * only from HTML files that were accessed via a "file://localhost/" URL
+ * and the Options Menu for "Local executions links" will allow toggling
+ * only between "ALWAYS OFF" and "FOR LOCAL FILES ONLY".
  */
 /* #define NEVER_ALLOW_REMOTE_EXEC */
 
@@ -1038,18 +1037,16 @@
  * LOCAL_EXECUTION_LINKS_ALWAYS_ON will be FALSE
  * if NEVER_ALLOW_REMOTE_EXEC has been defined.
  *
- * if LOCAL_EXECUTION_LINKS_ALWAYS_OFF_FOR_ANONYMOUS is
- * true all execution links will be disabled when the
- * -anonymous command line option is used.  Anonymous
- * users are not allowed to change the execution options
- * from within the Lynx options menu so you might be able
- * to use this option to enable execution links and set
- * LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE to TRUE to
- * give anonymous execution link capability without compromising
- * your system (see comments about TRUSTED_EXEC rules in
- * lynx.cfg for more information).
- *
+ * if LOCAL_EXECUTION_LINKS_ALWAYS_OFF_FOR_ANONYMOUS is true,
+ * all execution links will be disabled when the -anonymous
+ * command-line option is used.  Anonymous users are not allowed
+ * to change the execution options from within the Lynx Options Menu,
+ * so you might be able to use this option to enable execution links
+ * and set LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE to TRUE
+ * to give anonymous execution-link capability without compromising
+ * your system (see comments about TRUSTED_EXEC rules in lynx.cfg ).
  */
+ 
 #define LOCAL_EXECUTION_LINKS_ALWAYS_ON          FALSE
 #define LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE  FALSE
 #define LOCAL_EXECUTION_LINKS_ALWAYS_OFF_FOR_ANONYMOUS FALSE
@@ -1062,8 +1059,7 @@
  *
  * UNIX:
  * =====
- * CGI script support.  Defining LYNXCGI_LINKS (done by the configure script)
- * allows you to use the
+ * CGI script support.  Defining LYNXCGI_LINKS allows you to use the
  *
  *   lynxcgi:path
  *
@@ -1139,27 +1135,21 @@
 #define CHECKMAIL      FALSE   /* report unread and new mail messages */
 
 /*********************************
- * VI_KEYS can be changed in lynx.cfg and can be turned on by the user
- * in the options screen or the .lynxrc file.  This is just the default.
- */
-#define VI_KEYS_ALWAYS_ON      FALSE /* familiar h,j,k, & l */
-
-/*********************************
- * EMACS_KEYS can be changed in lynx.cfg and can be turned on by the user
- * in the options screen or the .lynxrc file.  This is just the default.
- */
-#define EMACS_KEYS_ALWAYS_ON   FALSE /* familiar ^N, ^P, ^F, ^B */
+ * Vi or Emacs movement keys.  These are defaults,
+ * which can be changed in lynx.cfg , the Options Menu or .lynxrc .
+#define VI_KEYS_ALWAYS_ON      FALSE /* familiar h j k l */
+#define EMACS_KEYS_ALWAYS_ON   FALSE /* familiar ^N ^P ^F ^B */
 
 /*********************************
- * DEFAULT_KEYPAD_MODE specifies whether by default the user
- * has numbers that work like arrows or else numbered links
- * DEFAULT KEYPAD MODE may be set to
- *     NUMBERS_AS_ARROWS   or
- *     LINKS_ARE_NUMBERED  or
- *     LINKS_AND_FIELDS_ARE_NUMBERED
- *
- * This default setting can be overridden in lynx.cfg (but not to
- * the third value), and it can be changed at run time by the user.
+ * DEFAULT KEYPAD MODE may be set to NUMBERS_AS_ARROWS
+ *                                or LINKS_ARE_NUMBERED
+ *                                or LINKS_AND_FIELDS_ARE_NUMBERED
+ * to specify whether numbers (e.g. [10]) appear before all links,
+ * allowing immediate access by entering the number on the keyboard,
+ * or numbers on the numeric key-pad work like arrows;
+ * the 3rd option causes form fields also to be preceded by numbers.
+ * The first two options (but not the last) can be changed in lynx.cfg
+ * and all three can be changed via the Options Menu.
  */
 #define DEFAULT_KEYPAD_MODE    LINKS_AND_FIELDS_ARE_NUMBERED

-- 
========================,,============================================
SUPPORT     ___________//___,  Philip Webb : address@hidden
ELECTRIC   /] [] [] [] [] []|  Centre for Urban & Community Studies
TRANSIT    `-O----------O---'  University of Toronto

reply via email to

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