lynx-dev printer options (patch)

[Philip Webb]

980820 Al Gilman replied to Philip Webb re printer-option help text:
>> i'm quite willing to `do it yourself', if only patching  lynx.cfg ,
>> but would like some comment from others before i jump in.
> the language which assumes the system administrator is user of lynx.cfg
> is dated & could be changed in lynx.cfg and the User's Guide,
> which should refer to extensibility of the p)rint[er selection] menu.
 
*** lynx.cfg    Wed Aug 19 22:51:43 1998
--- lynxcfg.d1  Thu Aug 20 20:49:21 1998
***************
*** 904,972 ****
  #cso_proxy:http://some.server.dom:port/
  #no_proxy:host.domain.dom
  
! # Printer definitions
! # any number of printers may be defined by using multiple
! # printer definition sets.  Printers may be any program
! # that could be useful to your users, they do not necessarily
! # have to print.
  #
! # the definition of a printer is of the form
  # PRINTER:<printer name>:<printer command>:<printer option>:<lines/page>
  #
! #    <printer name> is the name that the user will see.
! # <printer command> is the command line arguments for printing a file.
! #                 The %s will be replaced with the file being printed.
! #                   If a second %s is given the second %s will be replaced by
! #                   a suggested filename that is prettier than the tempfile
! #                   name given in the first %s.  This does not remove the 
first
! #                   %s from the command line in any manner.  If you need to
! #                   use only the second %s file name in your printer command,
! #                   then I suggest creating a script which will first copy the
! #                   first %s file name to the second %s file name, and then
! #                   executing your print command with the second %s file name.
! #  <printer option> specifies whether the printer should be disabled for
! #                 users without printing options.  The options are
! #                 TRUE or FALSE;
! #                 TRUE means the printer will always be ENABLED
! #                      regardless of printer or anonymous settings
! #                 FALSE means the printer will be DISABLED when
! #                       the -noprint option is on, or for anonymous
! #                       users which are not allowed to print
  #
! #  <lines/page>    is an optional parameter for indicating the number of
! #                lines per page for the printer.  Defaults to 66.  Used
! #                for computing the approximate number of pages and
! #                generating a statusline query of whether to proceed if
! #                the document is longer than 4 printer pages.  Uses the
! #                current screen length for the computation when the
! #                built in "print to screen" option is selected.
  #
! #  You must put the whole definition on one line.
! #
! #  If you must use a colon, precede it with a backslash!
! #
! #  If you have a very busy VMS print queue and Lynx deletes the temporary
! #  files before they have been queued, use the VMSPrint.com included in
! #  the distribution.
! #
! #    examples
  #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE
  #PRINTER:Office printer:lpr -POffprt %s:TRUE
  #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58
  #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58
! #  Check out the lpansi program in utils/ for printing on vt100
! #  attached printers.
! #PRINTER:Use vt100 print sequence to print from your local terminal:lpansi 
%s:TRUE
! #  Don't use the following printer on anonymous accounts since
! #  allowing shell input is very dangerous.
! #PRINTER:Specify your own print command:echo -n "Enter a print command\: "; 
read word; sh -c "$word %s":FALSE
! #  Pass to a sophisticated file viewer (sources for most are available in
! #  ftp://space.mit.edu/pub/davis/most).  The most -k switch suppresses the
! #  invocation of hexadecimal display mode if 8-bit or control characters
! #  are present.  The +s switch invokes secure mode.
  #PRINTER:Use Most to view:most -k +s %s:TRUE:23
  
  # Downloader definitions
  # any number of downloaders may be defined by using multiple
--- 904,961 ----
  #cso_proxy:http://some.server.dom:port/
  #no_proxy:host.domain.dom
  
! # PRINTER DEFINITIONS: Lynx comes with 3 pre-defined print options
! # which are called up on-screen when `p' is entered:
! # `Print to local file', `E-mail the file', `Print to screen'.
! # Any number of options can be added by the user, as explained below;
! # `printer' here can be any file-handling program you find useful,
! # even it does not physically print anything.
  #
! # To define a print option use the following format:
  # PRINTER:<printer name>:<printer command>:<printer option>:<lines/page>
  #
! #    <printer name> is what you will see on the print screen.
! # <printer command> is the command your system will execute:
! #                   include %s for the file being printed;
! #                   if a second %s is given it will be replaced
! #                   by a suggested filename that is prettier
! #                   than the tempfile name given in the first %s,
! #                   but does not remove the first %s in any manner:
! #                   if you need to use only the second %s in your command,
! #                   create a script to copy the first %s to the second %s
! #                   then execute your command with the second %s.
! #  <printer option> TRUE : the printer will always be ENABLED;
! #                   FALSE : the printer will be DISABLED
! #                   when -noprint is given on the command-line
! #                   and for anonymous users (who are not allowed to print).
! #  <lines/page>     (optional) the number of lines/page (default 66):
! #                   this is used to compute the approximate number of pages
! #                   and generates a status-line query whether to proceed
! #                   if the document is > 4 printer pages;
! #                   it uses current screen length for the computation
! #                   when `print to screen' is selected.
  #
! # You must put the whole definition on one line;
! # if you must use a colon, precede it with a backslash!
! # If you have a very busy VMS print queue
! # and Lynx deletes the temporary files before they have been queued,
! # use the VMSPrint.com included in the distribution.
  #
! # Examples:
  #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE
  #PRINTER:Office printer:lpr -POffprt %s:TRUE
  #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58
  #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58
! # To specify a print option at run-time:
! # NBB if you have ANONYMOUS users, DO NOT allow this option!
! #PRINTER:Specify at run-time:echo -n "Enter a print command\: "; read word; 
sh -c "$word %s":FALSE
! # To pass to a sophisticated file viewer: -k suppresses invocation
! # of hex display mode if 8-bit or control characters are present;
! # +s invokes secure mode (see ftp://space.mit.edu/pub/davis/most):
  #PRINTER:Use Most to view:most -k +s %s:TRUE:23
! # To check out lpansi in utils/ for printing on vt100 attached printers:
! #PRINTER:Use vt100 print sequence to print from local terminal:lpansi %s:TRUE
! # You can construct your own option choices from the examples as templates.
  
  # Downloader definitions
  # any number of downloaders may be defined by using multiple

*** lug.mr      Thu Aug 20 21:11:21 1998
--- Lynx_users_guide.html       Thu Aug 20 21:16:11 1998
***************
*** 302,324 ****
  <h2><A NAME="7"
  ><em>Printing, Mailing, and Saving rendered files to disk.</em></A></h2>
  
! Rendered HTML documents, and plain text files, may be printed using the
! '<em>p</em>' command while viewing the document.  After pressing the
! '<em>p</em>' key a menu of <em>Print Options</em> will be displayed.  The
! menu will vary according to several factors.  First, some sites set up
! special accounts to let users run Lynx to access local information systems.
! Typically these accounts require no passwords and do not require users to
! identify themselves.  As a result such accounts are called "anonymous"
! accounts, and their users are considered "anonymous" users.  In most
! configurations, all Lynx users (including anonymous users) are able to
! mail files to themselves and print the entire file to the screen.
! 
! <p>Additional print options are available for users who are using
! Lynx from their own accounts (that is, so-called "non-anonymous
! users").  In particular, the <em>Save to a local file</EM>
! option allows you to save the document into a file on your disk
! space.        Any number of additional print options may also be
! available as configured by your system administrator.
  
  <p>Some options, such as <em>Save to a local file</em>, involve prompting
  for an output filename.  All output filename entries are saved in a
--- 302,316 ----
  <h2><A NAME="7"
  ><em>Printing, Mailing, and Saving rendered files to disk.</em></A></h2>
  
! To print, mail or save the document you have on-screen, enter 
'<em>p</em>',<br>
! which displays a menu of <em>Print Options</em>, including 3 pre-defined:<br>
! `Print to local file', `E-mail the file', `Print to screen'.<br>
! In most configurations, all Lynx users (including anonymous users)<br>
! can mail files to themselves and print the entire file to the screen;<br>
! users with named accounts (or individuals using Lynx on a micro)<br>
! can also save documents to files in their disk space;<br>
! if you have access to lynx.cfg, you can define your own options:<br>
! see the detailed advice in lynx.cfg.
  
  <p>Some options, such as <em>Save to a local file</em>, involve prompting
  for an output filename.  All output filename entries are saved in a

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