SkyReader v1.00 Copyright (c) 1996-1997 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 readme.fin - Finnish readme.txt 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] [/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 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. * Linux version uses ncurses 4.0, make sure you have /usr/share/terminfo linked to /usr/lib/terminfo * 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 @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 Ctrl-F3: 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: Linux version says "Can not open terminal: xxxxx", what's wrong?? A: ncurses 4.0 wants to read /usr/share/terminfo directory, so just type: ln -s /usr/lib/terminfo /usr/share/terminfo 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. .. New versions: You can always frequest or download the newest version of SkyReader from my BBS (see below). Use these magic names for frequesting: SKY386 - SkyReader/386 SKYOS2 - SkyReader/OS2 SKYW32 - SkyReader/Win32 SKYLNX - SkyReader/Linux .. Contacting info: Fidonet : 2:227/33.0 E-Mail : skyreader@fw.nullnet.fi or timo.sirainen@f33.n227.z2.fidonet.org Please use the first one, but it you don't get answer from there try the second one. BBS : +358-15-176242, 24h, v34 You can also use 2:227/34 (176246, v34+) for file requesting. WWW : http://www.pp.pitek.fi/~ylukio/sky/index.htm FTP : ftp://ftp.pitek.fi/pub/ylukio/skyreader And snailmail: Timo Sirainen Huusharjuntie 10 FIN-50180 Mikkeli Suomi / Finland