lynx-dev printer options (revised patch)

[Philip Webb]

980821 NHE LP JCL JM commented on printer options & my patch.

i strongly recommend shortening the  4  on-screen descriptions
to the ones in my revised patches below:
they're in the source & i'll leave it to those who know where;
it's important to keep frequent messages brief,
provided there's adequate documentation elsewhere.
i've included NHE's explications of the new option
& JM's account of the purpose of `Print to screen' 
in  lynx.cfg  & the Users Guide;
i dropped the stuff about double %s, since no-one knows what it means.
these are vs the latest  lynx.cfg , which has changed slightly.

*** cfg281.mr   Sat Aug 22 20:15:13 1998
--- cfg281.d1   Sat Aug 22 20:52:29 1998
***************
*** 983,1049 ****
  # for the .mil domain as well as the .il domain.  If the entry is '.il' this
  # will not happen.
  
! # 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
! #  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\: "; 
rea
! d 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
  # downloader definition sets.  Downloaders may be any program
  # that could be useful to your users, they do not necessarily
--- 983,1037 ----
  # for the .mil domain as well as the .il domain.  If the entry is '.il' this
  # will not happen.
  
! # PRINTER DEFINITIONS: Lynx comes with 4 pre-defined print options
! # which are called up on-screen when `p' is entered:
! # `Save to local file', `E-mail the file', `Print to screen'
! # and `Print to local printer attached to vt100'.
! # `Print to screen' allows file transfers in the absence of alternatives
! # and is often the only option allowed here for anonymous users;
! # the 3rd & 4th options are not pre-defined for DOS/WINDOWS versions of Lynx.
! # 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 if 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.
! # <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 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
+ # You can construct your own option choices from the examples as templates.
  
! # DOWNLOADER DEFINITIONS:
  # any number of downloaders may be defined by using multiple
  # downloader definition sets.  Downloaders may be any program
  # that could be useful to your users, they do not necessarily

*** lug.d1      Sat Aug 22 21:35:13 1998
--- Lynx_users_guide.html       Sat Aug 22 21:30:47 1998
***************
*** 302,333 ****
  <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
! circular buffer, and any previous entries can be retrieved for re-use by
! pressing the <em>up-arrow</em> or <em>down-arrow</em> keys at the prompt.
! 
! <p>Note that if you want exact copies of text files without any expansions
! of TAB characters to spaces you should use the <a href="#9">Download</a>
! options. [<A HREF="#TOC">ToC</A>]
  
  <h2><A NAME="8"
  ><em>Viewing the HTML document source and editing documents</em></A></h2>
--- 302,334 ----
  <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 4 pre-defined:<br>
! `Save to local file', `E-mail the file', `Print to screen'<br>
! and `Print to local printer attached to vt100'.
! <p>
! `Print to screen' allows file transfers in the absence of alternatives<br>
! and is often the only option allowed here for anonymous users;<br>
! `Print to local printer' prefixes the `Print to screen' routine<br>
! with the VT100 standard `printer on' escape sequence and appends to it<br>
! the escape sequences for `form feed' and `printer off';<br>
! the 3rd & 4th options are not pre-defined for DOS/WINDOWS ports.
! <p>
! 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 prompt for an output filename.  These are saved<br>
! in a circular buffer, and any previous entries can be retrieved<br>
! for re-use by pressing the <em>up-arrow</em> or <em>down-arrow</em> keys
! at the prompt.
! <p>
! NB if you want exact copies of text files without expansion of TABs<br>
! to spaces you should use the <a href="#9">Download</a> options.
! [<A HREF="#TOC">ToC</A>]
  
-- 
========================,,============================================
SUPPORT     ___________//___,  Philip Webb : address@hidden
ELECTRIC   /] [] [] [] [] []|  Centre for Urban & Community Studies
TRANSIT    `-O----------O---'  University of Toronto