Short:    Reads HTML pages with YAM mail client
Author:   Rodolfo Ignazi rodign@inwind.it or rodign@tiscali.it
Uploader:
Version:  1.7b
Type:     comm/mail
Name:     YamHTML.yam or .rx
Legal:    FreeWare

Some info about my Arexx script:
It is used for reading HTML pages and embedded images (if there are) downloaded
along with e-mails using YAM mail client for Amiga. It uses various amiga browsers.

Note For All Users:
I am very interested to have emails which gives you some problem (if they are not
private issues), I need them to test the script and, hopefully, find out the problem.
A brief description of the problem would be useful.
If you send me the emails it's better to send them as attachments in raw format.
To get a raw format you may use save from the YAM message menu when you are on the
reading window.

1.7b Note:
Added a control on a never happened event ( but who knows ? ). and another minor but
useful change.
For Boing Bag 3.9-2 users: It may happen that AWeb, if opened on its own screen,
remains stuck to the front and can only be dragged down.
It depends of the new exec.library, the cure is:
SetPatch SKIPROMUPDATES  exec.library
on the startup-sequence.

1.7,1.7a Note:
If you have read this doc before 1.7, please look trough it for 1.7,1.7a Notes.

Installing:
First of all you'll have to edit the script lines 3, 4, 5 and 6 to set
your browsers paths and names modifying the preset lines to your needs.
Don't use MultiView as Default it don't unlock files, use SimpleHtML instead.

There are two ways for installing it:
1)
  » Copy the file YamHtml.yam into the Rexx directory inside YAM:.
  » Start YAM and press config button or select Configuration from the
    Settings menu.
  » Click on Arexx to the left list of options of the configuration window.
  » Scroll the Scripts list on the right until you see
    'When reading a message' option, then click on it.
  » Find the file using the Script gadget at the bottom,
    the string gadget must show: YAM:Rexx/YAMhtml.yam
  » Choose Arexx in the cycle gadget.
  » It seems to work fine regardless of the 'Wait for termination'
    checkbox  perhaps it is better to check it, just try it.
  » 'Open console window' checkbox may remain unchecked.
  » Click on Save.
  » Done
2)
  » Rename the file YamHtml.yam  to YamHtml.rx (as it is sensible to its own name).
  » Copy the file YamHtml.rx into the Rexx directory inside YAM:.
  » Start YAM and press Config button or select Configuration on the Settings menu.
  » Click on Arexx to the left list of options of the configuration window.
  » Look for the first free 'Scripts' menu entry (written in black are free)
    then click on it.
  » Find the file using the Script gadget at the bottom,
    the string gadget must show: YAM:Rexx/YAMhtml.rx .
  » Write YAMhtml in the 'Name' string gadget.
  » Choose Arexx in the cycle gadget.
  » It seems to work fine regardless of the 'Wait for termination'
    checkbox  perhaps it is better to check it, just try it.
  » 'Open console window' checkbox may remain unchecked.
  » Click on Save.
  » Done

1.7 Note: Usage has been updated.
Usage:
As there are two ways for installing it, there are two for using it too:
Choosing the first installation method (preferred) the program automatically
checks if there is an HTML document to be seen and asks you if you want or not
see it as HTML.
With the second method the program remains inactive until you call it by the
Scripts menu then if there is an HTML file to be seen it shows it to you.
You may have the script automatically show (without asking) the HTML email by
just change the file suffix from .yam to .rx leaving the Yam setting to
"When reading a message"
I did just forget to say that on the previous readme.

1.7 Note: Behavior has been updated
Behavior:
If an Amiga browser is running (AWeb,IBrowse or Voyager) the program uses it,
otherwise it will ask you to choose one. (This only once in an Amiga session).
If an Amiga browser is not running and you have been asked once to open one,
the program reopen the browser you had first choosen.
But if you,in the meantime, have changed your mind, you may change your browser
by closing the one you are using and opening a different one by hand.
If you are on line with Genesis or Miami and one of the above browswrs is running
the script will let the browser to get the doc. related pictures from the net.
The script now put the browsers window (for AWeb the screen too) to the front
exept for IBrowse and Voyager: This two puts a new window to the front if the
variable NewWind in line 7 of the script is set to "YES".
1.7a Note: The NewWind="YES" variable now controls the opening of a new window
           with AWeb also.
In this version, 1.7, I decided to cut off the option to start Voyager
from the prog. bacause it crashes my machine on starting Voyager,
precisely while loading cookies, I tried to take the piece of
code that does the job and run it as an Arexx macro from the shell
and it opens V nicely. It's unbelievable ,I can not understand.
Nevertheless, you may use V by starting it manually.
I think that V, at this stage, is a bit unreliable yet.
Please, read the beginning of this doc. on how to set the browsers paths and
names.

Sideffect:
Exiting Yam the script leaves a directory inside T: containing the last shown
document. It is not annoying to me but it is easy cure by writing a small ADOS
batch to be run on leaving Yam. If you want you may e-mail me about this and
for bug reports, thank you.
1.7 Note:
I enclose now a little Arexx to put on "Program Termination" of the Yam arexx
configuration (if you wish) .It will delete the last shown doc and the dir in T: .

Law:
This script is freeware and I, the author, will NOT be responsible if this
script or its misuse may cause any damage whatsoever.