Re: lynx-dev patch: images & options

[Leonid Pauzner]

30-Jul-99 04:52 Philip Webb wrote:
> 990728 Klaus Weide invited:
>> Please take this over, as far as I'm concerned.
>> I'm not sure it isn't too technical for the UG, but leave that to you
>> (and shall try not to complain, whatever you do :) ).
> and Philip Webb replied:
>> i'll saddle my horse, shine my armour & sharpen my spear ...

> below are patches for Users Guide, Options Help &  lynx.cfg ,
> adding explanations of the various choices for revealing/not images,

I think the text in User Guide and Options Help now degraded dramatically:
try reading lynx 2.6 users guide - it was written for users, not a very
technical people nor hackers.
Also I hate you <br> tags for every line, it was discussed before a lot.

IMHO the present Options Help is enough:

                                  Show Images

   Text-based browser cannot show images directly, so we have a choice:
   ignore all images without ALT= text string (this is also switched by
   '[' key), show labels (see also "verbose images" for choice between
   [IMAGE] and filename), use links for every image to make it possible
   to download them (also switched by '*' key). Changing these settings
   will not be saved but could be made permanent by changing the
   respective settings in lynx.cfg.
   ^^^^^^^^^^
Perhaps this word may be replaced with actual options name,
though we have not do this before:

say, [-key and *-key help doesn't say what lynx.cfg option is responsible for
its default! We have 100+ lynx.cfg options and Users Guide will be completely
unreadable if we include all the references there. Instead, lynx.cfg comments
should be corrected if necessary to be as clear as possible.


> & moving VERBOSE_IMAGES to immediately precede the others in  lynx.cfg .
> please assess THE RENDERED HTML, NOT the source below.

> i await the arrival of the piranhas ...

> *** old/Lynx_users_guide.html Thu Mar  4 05:39:45 1999
> --- new/Lynx_users_guide.html Fri Jul 30 03:56:40 1999
> ***************
> *** 49,54 ****
> --- 49,55 ----
>   <li><A HREF="#DirEd" NAME="ToC-DirEd">Directory Editing</A>
>   <li><A HREF="#MiscKeys" NAME="ToC-MiscKeys">Scrolling and Other useful 
> commands</A>
>   <li><a href="#Forms" NAME="ToC-Forms">Lynx and HTML Forms</a>
> + | <a href="#Images" NAME="ToC-Images">Lynx and HTML Images</a>
>   <li><a href="#Tables" NAME="ToC-Tables">Lynx and HTML Tables</a>
>   | <a href="#Tabs" NAME="ToC-Tabs">Lynx and HTML Tabs</a>
>   <li><a href="#Frames" NAME="ToC-Frames">Lynx and HTML Frames</a>
> ***************
> *** 1497,1502 ****
> --- 1498,1535 ----
  >><em>&lt;META <tab id="cdis">HTTP-EQUIV="Content-Disposition"<BR>
>   <tab to="cdis">CONTENT="file;&nbsp;filename=name.suffix"&gt;</em><BR>
>   [<A HREF="#ToC-Forms">ToC</A>]
> +
> + <h2 ID="Images"><A NAME="Images"><em>Lynx and HTML Images</em></a></h2>
> +
> + As a text browser, Lynx does not display images as such<br>
> + -- you need to define a viewer in <em>lynx.cfg</em>: see there -- ,<br>
> + but users can choose a number of ways of showing their presence.
> + <p>
> + There are 3 choices in <em>lynx.cfg</em>, with 2 corresponding keys:
> + <p><pre>
> +      MAKE_LINKS_FOR_ALL_IMAGES        *  IMAGE_TOGGLE
> +      MAKE_PSEUDO_ALTS_FOR_INLINES     [  INLINE_TOGGLE
> +      VERBOSE_IMAGES                   no corresponding key
> + </pre><p>
> + You can also use the Options Menu, as outlined below:
> + <p><pre>
> +      key  lynx.cfg       FM LM .lynxrc    variable in source
> +
> +        *  MAKE_LINKS_     Y  N       N    clickable_images
> +        [  MAKE_PSEUDO_    Y  N       N    pseudo_inline_alts
> +           VERBOSE_        Y  Y       Y    verbose_img
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> + FM = new Form Menu ; LM = old List Menu ;
> + in  .lynxrc ,  VERBOSE_IMAGES  is called `verbose_images':
> + the other two cannot be saved between sessions.
> + </pre><p>
> + In the Forms Menu, the 3-way `Show images' selection<br>
> + combines the effects of the `*' & `[' keys, as follows:
> + <p><pre>
> +      Ignore      clickable_images = FALSE, pseudo_inline_alts = FALSE
> +      As labels   clickable_images = FALSE, pseudo_inline_alts = TRUE
> +      As links    clickable_images = TRUE,  pseudo_inline_alts = unchanged
> + </pre>

>   <h2 ID="Tables"><A NAME="Tables"><em>Lynx and HTML Tables</em></a></h2>

> *** old/lynx_help/keystrokes/option_help.html Wed Feb 17 09:29:33 1999
> --- new/lynx_help/keystrokes/option_help.html Fri Jul 30 04:16:40 1999
> ***************
> *** 251,271 ****

>   <H1><A NAME="SI">Show Images</A></H1>

> ! Text-based browser cannot show images directly, so we have a choice:
> ! <em>ignore all</em> images without ALT= text string
> ! (this is also switched by <A HREF="../Lynx_users_guide.html#[-key">'[' 
> key</A>),
> ! <em>show labels</em> (see also "verbose images" for choice between [IMAGE] 
> and filename),
> ! <em>use links</em> for every image to make it possible to download them
> ! (also switched by <A HREF="../Lynx_users_guide.html#*-key">'*' key</A>).
> ! Changing these settings will not be saved but could be made permanent
> ! by changing the respective settings in lynx.cfg.

>   <H1><A NAME="VB">Verbose Images</A></H1>

> ! Controls whether or not Lynx replaces the [LINK], [INLINE] and [IMAGE] 
> comments
> ! (for images without ALT) with filenames of these images.  This is extremely
> ! useful because now we can determine immediately which images are decorations
> ! (button.gif, line.gif) and which are important.

>   <H1><A NAME="VI">VI keys</A></H1>

> --- 251,275 ----

>   <H1><A NAME="SI">Show Images</A></H1>

> ! This option combines the effects of the `*' & `[' keys as follows:
> ! <p><pre>
> !      <em>ignore</em> all images which lack an ALT= text string,
> !      <em>show labels</em>, e.g. [INLINE] -- see `Verbose Images' below -- ,
> !      <em>use links</em> for every image, enabling downloading.
> ! </pre><p>
> ! This option setting cannot be saved between sessions.<br>
> ! See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A>
> ! & <em>lynx.cfg</em> for more details.

>   <H1><A NAME="VB">Verbose Images</A></H1>

> ! This allows you to replace [LINK], [INLINE] and [IMAGE]<br>
> ! -- for images without ALT -- with filenames:<br>
> ! this can be helpful by revealing which images are important<br>
> ! & which are merely decoration, e.g. <em>button.gif</em>, 
> <em>line.gif</em>.<br>
> ! See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A>
> ! & <em>lynx.cfg</em> for more details.
> !

>   <H1><A NAME="VI">VI keys</A></H1>

> *** old/lynx.cfg      Wed Jul 28 23:49:15 1999
> --- new/lynx.cfg      Fri Jul 30 04:34:20 1999
> ***************
> *** 459,473 ****
...