                              SkyReader v1.01

                   Copyright (c) 1996-1998 Timo Sirainen
                              All Rights Reserved


 If you can't get something work, read "FAQ" section from end of this file

 For all bug reports, include which version of SkyReader, for what platform
 (DOS, OS/2..) and which message packet type (BW, QWK..) you are using.

 If you find any key file generators to SkyReader, please send them to me.

.. To find out all features of SkyReader,

  * Read this file through
  * Check every part of setup
  * Check from keyboard configuration all key combinations SkyReader can do
    while reading messages
  * Some configuration can be made only with text editor, see files colors.cfg,
    language.dat, savemsg.tpl and saverep.tpl

.. Disclaimer:

  This program is provided 'as is', without any warranties. You run this
  program on your own responsibility. The author is not responsible of any data
  loss or any other damage this program might cause to you.


.. And the license agreenment :

  You may use SkyReader with the following restrictions:

     * SkyReader is shareware. You have to pay for it after using it 60 days.
       See register.txt for details.
     * You may NOT change SkyReader executables in any way.
     * You may NOT sell, sublicense or rent SkyReader.
     * If SkyReader is to be distributed, it should be distributed unaltered
       and in full.
     * Author can terminate or change this license at any time.


.. These files should come with SkyReader:

        readme.txt      - This file
        colors.cfg      - Color configuration file (*)
        register.txt	- Registeration form
        register.fin    - Finnish registeration form
        language.*      - Language files (*)
        tables.dat      - Translation tables
        whatsnew.txt    - What's new in SkyReader
        skysig.txt      - Default signature file
        default.tag     - Default tagline file
        readmsg.kbd     - Keyboard data file
        savemsg.tpl     - Save message template file (*)
        saverep.tpl     - Save reply message template file (*)
        file_id.diz     - Diz...

   (*) These files can be modified only with text editor, not from SkyReader's
       config.

   And depending of the version you are using you should have some of these:

        sky386.exe      - 386 version of SkyReader. REQUIRES DOS4GW.EXE!
        sky2.exe        - OS/2 version of SkyReader.
        skyw32.exe      - Win32 character mode version of SkyReader.
        sky             - Linux version of SkyReader.

.. Command line parameters

        skyread [/v] [/c<fname>] [/t] [/m] [packet.000]

        packet.000 : You can immediately open mail packet by entering it's name
                     to command line.

        /v : Keep startup video mode. Usable when you have messed up
             SkyReader's video modes.
        /c : Read configuration from file <fname> instead of the
             default SKY???.CFG.
        /t : Don't change title name in OS/2 version. Without this switch
             SkyReader/2 crashes under TShell.
        /m : Use with MDA (display adapter)

.. Then something about SkyReader's features:

  *  Blue Wave v3, QWK, Hippo v2, OMEN and SOUP v1.2 compatible offline mail
     reader.

  *  SkyReader has 386, OS/2, Win32 and Linux character mode executables.
     You also need a DOS4GW extender to run SkyReader/386. Almost everybody
     has it, so I won't put it into SkyReader's archive.

  *  SkyReader can use almost any screen resolution your video card / video
     drivers can make. 255x255 is the limit.

  *  You can change almost all texts displayed by SkyReader from language.dat
     file.

  *  You can change screen colors from colors.cfg file. This will be build into
     SkyReader's setup some day.

  *  In signature, tagline file and almost everywhere except in message text
     you can use some macros :

       @CR@     : This macro will be replaced with CRLF characters.
       @AT@     : Area tag in "filename" mode, can be used for example when
                  saving messages to file. Eg. "Area.Tag.Name" -> "Area_Tag".
       @VER@    : Current version number of SkyReader. Eg. 1.00
       @OS@     : Operating system ID (D, 386, 2, W32, L)
       @LONGOS@ : Longer version of @OS@ (386, OS/2, Win32, Linux)
       @FORMAT@ : Offline format used in currently opened message packet (BW,
                  Hippo, OMEN, QWK, SOUP)
       @TAG@    : Randomized tagline, could be put eg. in sig file.
       @GETTAG@ : Randomize new tagline, also tagline file may be specified
                  like @GETTAG.filename.tag@
       @BBS@    : Currently opened message packet: BBS name
       @SYSOP@  : Currently opened message packet: Sysop name

       @PID@    : SkyReader's Process ID

       @TASKS@        : Number of tasks running currently  (OS/2 only)
       @THREADS@      :   ""      threads     ""           (OS/2 only)
       @PROCS@        :   ""      processes   ""           (OS/2, Linux only)

        *** For OS/2, Win32 and Linux versions
       @UPTIME_DAYS@  : Number of days computer has currently been on
       @UPTIME_HOURS@ :  ""      hours       ""
       @UPTIME_MINS@  :  ""     minutes      ""
       @UPTIME_SECS@  :  ""     seconds      ""
        **************************************

       @AREA@   : Current area

       @D@      : Current date
       @DD@     : Current day
       @DM@     : Current month
       @DY@     : Current year
       @T@      : Time currently

       @FROM@   : Message from
       @FFROM@  : First name 
       @LFROM@  : Last name

       @TO@     : Message to
       @FTO@    : First name
       @LTO@    : Last name

       @MSGNUM@ : Message number
       @SUBJ@   : Message subject
       @DATE@   : Message date

       @FLAG_READ@    : "Read" flag status (Yes/No)
       @FLAG_SAVED@   : "Saved" flag status (Yes/No)
       @FLAG_REPLIED@ : "Replied" flag status (Yes/No)
       @FLAG_PRINTED@ : "Printed" flag status (Yes/No)
       @MARK_REPLY@   : "Reply" mark ("Reply " / "")
       @MARK_SAVE@    : "Save" mark ("Save " / "")
       @MARK_PRINT@   : "Print" mark ("Print " / "")
       @MARK_DEL@     : "Del" mark ("Del " / "")

       @RFROM@, @RFFROM@, @RLFROM@, @RTO@, @RFTO@, @RLTO@, @RSUBJ@ and @RDATE@
       are same as above, except for replies. These should be used in taglines
       and signature files. The upper ones should be used in setup strings. All
       the @Rxxxx@ macros will some day work also without the 'R' character..

       Also for Blue Wave tagline files compatibility:

         @N@ = @RTO@ = User name (reply to)
         @FN@ = @RFTO@ = first name
         @LN@ = @RLTO@ = last name

       You can also add simple 'commands' inside macros, eg. :

        @MACRO@      = "This is a macro"         normal
        @MACRO.10@   = "This is a "              max. 10 chars long
        @MACRO:10@   = "This is a "              max. 10 chars long

        @MACRO.20@   = "This is a macro"         max. 20 chars long (no effect)
        @MACRO:20@   = "This is a macro     "    set length to 20 chars

        @MACRO:20R@  = "     This is a macro"    Right justify to 20 chars
        @MACRO:20C@  = "  This is a macro   "    Center justify to 20 chars

        @MACRO.20:5@ = " is a macro"             Start displaying from 5th char

        @MACRO:20'!@  = "This is a macro !!!!"   Fill empty area with <chr>
        @MACRO:20C'?@ = "? This is a macro ??"    ""

  *  Different quote styles :
        >>>>>>   = Just add a '>' character to each line
        TS>JS>   = Add initials and '>' character to each line
         TS> JS> = Add space, initials and '>' character to each line
         TS>>>>  = Add space and initials if line is not already quoted. If it
                   is, add a new '>' character after initials.

  *  SkyReader can use CHARSET or CHRS kludge if found. Eg. if SkyReader finds
     line :

        ^aCHARSET: LATIN-1

     It will look if "LATIN-1" translation table is defined in translation
     table setup and convert the current message through that translation
     table.


.. Something about the non-user-definable keys:

  *  "Select area to read" screen:
        Enter  : Select area
        E      : Enter new message to area in cursor
        Alt-P  : Personal mail scan
        Alt-R  : Read only msgs which have reply mark on.
        Tab    : Go to next area which has unread messages
        Sh-Tab : Go to prev   ""
        Alt-Tab:   ""

  *  "Select message to read" screen:
        Enter  : Read message
        E      : Enter new message
        *      : Toggle message read status
        ~      : Toggle message replied status
        Ctrl-S : Toggle save mark
        Ctrl-R : Toggle reply mark
        Delete : Toggle delete mark
        Tab    : Jump to next different subject/from/to field
        Sh-Tab : Jump to prev   ""
        Alt-Tab:   ""

  *  "Select reply to read" screen:
        Enter  : Read reply
        Delete : Toggle delete mark

  *  "Reading reply" screen:
        Delete : Toggle delete mark
        S      : Save reply
        E      : Edit reply
        M      : Move reply to another area
        Alt-T  : Select new inbound translation table
        Alt-O  : Select new outbound translation table
        R      : Toggle Rot13 crypting on/off

  *  Setup -> Area override -> Selection screen:
        Space  : Flag area
        -      : Unflag all areas
        +      : Flag all areas
        *      : Invert all area flags

  *  To see what keys work while reading messages, go to setup -> keyboard
     configuration..


.. (FAQ) Frequently Asked Questions

Q: Can I remove that "~~~ SkyReader" text from end of message?
A: Sure, just clear "signature file" field from preferences -> file names or
   edit skysig.txt.

Q: SkyReader says that mail packet is corrupted but other readers can still
   read it. Why?
A: You have almost surely something wrong with packer settings. With BW and
   Hippo packets this can be only reason (AFAIK)

Q: I upgraded SkyReader from older version and it doesn't work now??
A: If you haven't read whatsnew.txt, do it!! If there's nothing new that could
   have crashed SkyReader with older configurations .. well .. just try if it
   begins to work if you delete sky???.cfg (and data\*.ini). If still not,
   complain to author.

Q: I use SkyReader/Win32 and I have set "display archiver output" switch to no,
   but still I can see their output!
A: You're using DOS packers, replace then with Windows versions. There's no way
   to hide DOS programs' output in Win32 program AFAIK.


.. Contacting info:

     (Sorry, I don't have BBS or read Fidonet anymore..)
     E-Mail  : skyreader@sicom.fi

     WWW     : http://www.fix.no/skyreader/
     FTP     : ftp://ftp.fix.no/pub/dist/skyreader
     IRC     : IRCnet: #skyreader (well, at least here is one bot usually :)

     And snailmail:

        Timo Sirainen
        Huusharjuntie 10
        FIN-50180 Mikkeli
        Suomi / Finland
