!Help153
========

As v1.53 is an update only, it it not issued with a full user/script guide.
This file describes the changes from the v1.50 documentation...


* Teletext

    If a "!startup" script exists (must be in lower case), you'll be asked if
    you want to run it when !Teletext starts.

    You can now click on email and web links. AcornURI and Fresco message are
    supported.
    Email:
      Also supports the method of using "<at>" or "(at)" for "@". This is
      mostly used by German broadcasters as their teletext character set has
      no '@' (it's an s-shaped thing).
    Web:
      Supports "http://www.heyrick.co.uk/", as well as "www.heyrick.co.uk".
      It will also try to match upon suffix, so it'll spot "cnn.com" and
      send the URI "http://cnn.com".
      Recognised suffixes: .com .co.uk .uk.com .org .fr .de .tv
      Note that the latter method MAY fail if no "www" was specified but was
      actually required; so if "http://whatever.org" fails, then you should
      try "http://www.whatever.org". It isn't really practical for Teletext
      to determine which is actually correct, as it'd have to do it's own DNS
      lookups! People should stop abbreviating URIs so much. You know, I saw
      the internet URI "whatever" (I can't remember what it was - bummer!)
      which just "assumed" you'd know they meant "http://www.whatever.com/".
      People who abbreviate it to that degree of pointlessness are, in my
      opinion, a whole bunch of words I can't write here. Okay, rant over!

    It is now possible to work around broadcasters that use Level 2 codes to
    do things like "black text on a white background". Simply enable the
    "Patch out black text" option in the configuration. This takes extra time
    (every character must be processed) and it has a side effects - so it is
    recommended that you turn the option OFF until it is needed. So far, I've
    only noticed this problem with RTL II's teletext service...



* Script interpreter:
    As version 1.05 has been released, this version is numbered 1.07 (there
    was an internal change in between!).

    New 'status' macro "day". This will try to return the current day as a
    number from 1 to 7 where 1 is Monday and 7 is Sunday. It reads from the
    current Territory, so may not work correctly on Territories with an
    'unusual' work week.
    Example:
      set A to status(day)
    This coupled with branches, can allow the same script to perform various
    different functions on different days of the week. Read the updated
    "!startup" script for an example...

    When running a new script, pages previously fetched by script were marked
    as 'deleted'. Now they are just marked as NOT being script pages, so the
    script will still ignore them, but they'll be in your cache.

    getframes() now copes with services (like MTV) that broadcast the SAME
    frame twice in succession (ie, 303.1 303.1 303.2 303.2...).
    When calling getframes(), it has a slightly different display in the
    status window to keep you more informed...

    appendgivenframes() now (correctly) supports OvationPro format. Bugfix!

    If a "!startup" script exists (must be in lower case), you'll be asked if
    you want to run it when !Teletext starts.

    "set <var> to status( <blah> )" can now accept:
      shiftkey
      ctrlkey
      altkey
    And will set <var> to '1' if the given key is down, else '0'. You can
    see an example of this in the "!startup" script provided, where it
    will only do certain things on certain days UNLESS you hold down the
    ALT key when the script begins (using 'Z' as the flag).



* Bug fixes:

    Preferred pages updates the global channel marker correctly.

    appendgivenframes() now (correctly) supports OvationPro format. Bugfix!

    Status can now be assigned to floating point variables.



* Nerdy:

    New WIMP message system to run scripts and fetch pages. Well, it was
    mainly added to allow scripts to be run; the page fetch/transfer stuff
    was easy to poke in. :-)

    It uses WIMP message &51C46. This is part of a block (&51C40-&51C7F) that
    has been officially allocated to me. Unlike some applications, I can make
    those 64 messages last for 64 different programs, simply by using the
    message number as an application specifier, and the word at block%!20 to
    determine the operation code. It is nice to see others doing this, I draw
    your attention to the NewsBase mail protocol as described in the "OS"
    StrongHelp manual.
    Read the end of the "Versions" file for message block details.

[end]

