@database TimeUL.guide
@master HD2:nvx/TimeUL.guide
@remark Created with Heddley v1.1 (c) Edd Dumbill 1994

@node "MAIN" "TIME-UL V1.0 "


                      @{b}@{u}@{bg shine}Time-UL 1.0 by Stigg/Nerve Axis@{ub}@{uu}@{bg back}



                    @{"  What is it   " link "INFO" 0} Program Description
                    @{"How Do I Use It" link "HOW" 0} Program Usage
                    @{" Configuration " link "CONFIG" 0} Program Setup
                    @{" Who Did What  " link "RANT" 0} Program Credits
                    @{"  Nerve Axis   " link "NVX" 0} Where to find us

@endnode

@node "INFO" "What the hell is this thing anyway?"


   This is a little utility to calculate the time it will take to 
   upload selected files to a bbs.

   It enables you to see approximately how long the files you intend
   to upload will take with your modem running at 100% speed or your
   average @{"CPS" link "CPS" 0}.





                            @{"BACK TO MAIN MENU" link "MAIN" 0}
@endnode

@node "CPS" "Upload speed"


   CPS - Characters Per Second

   Modems are usually classified by their speed, eg. 14400 bits per second.
   When a file is uploaded to a BBS, this is the speed at which it is sent,
   however the modem uses some of the bits for error detection. This means
   that though the modem is working at 14400 bits per second you may not
   acheive:
   
                    14400/8 = 1800 characters per second

   The modem generally uses 2 bits per character transmitted, so the actual
   upload speed of a 14400 modem will be:
   
                    14400/10 = 1440 characters per second

   This is not the end of the story! Most modern modems implement real time
   data compression, ie. They pack your data as they transmit it. The result
   depends upon the data, but you will get used to seeing how fast your
   modem works by watching the status bar in your comms software.

   For this reason, Time-UL lets you set default CPS values for different
   modem speeds.

                            @{"Ok" link "INFO" 0}
@endnode

@node "HOW" "How Do I Use It"


                      @{b}@{u}@{bg shine}Time-UL 1.0 © 1995 Nerve Axis@{ub}@{uu}@{bg back}


   Run the program from Workbench or Shell and the main window will appear.

   Choose the desired baud rate by clicking on the left column.

   Select the @{b}Add@{ub} gadget and a file requester will appear. @{"Select" link "SELECT" 0} the
   required files, the total size and upload time will be displayed below
   the list of files.

   The @{b}Delete@{ub} button allows you to delete entries from the list of files
   selected so far. Click on the file name in the list and then on the
   Delete button. The total size and upload time will be adjusted once a
   file has been deleted.
   
   The @{b}Clear@{ub} button allows you to dump the current list of files and
   start over.

   The @{b}About@{ub} button gives some useful info, such as Nerve Axis BBS numbers,
   these boards are open to all.

   The @{b}Help@{ub} button will load this AmigaGuide(tm) file, providing it
   can be located in the same drawer as the program AND amigaguide.library
   is available on yer system.

                               @{b}@{u}WARNING@{ub}@{uu}
   If you change the name of the program and run from the CLI/Shell then it
   will not be able to find it's icon amd will ignore all user preferences



                            @{"BACK TO MAIN MENU" link "MAIN" 0}
@endnode

@node "SELECT" "How to select files"


   To Select Files
   ~~~~~~~~~~~~~~~
   The ASL FileRequester is used to select files. To ease things a little,
   it has Multi-Select enabled, so all you have to do is hold down a shift
   key and click on lots of files before hitting 'Ok'. There is also a
   pattern gadget to keep the list of files selected as small as possible.
   
   For more information on using ASL File Requesters refer to your Amiga
   manual.



                            @{"OK" link "HOW" 0}
@endnode

@node "RANT" "Credits For This Program"


                      @{b}@{u}@{bg shine}Time-UL 1.0 © 1995 Nerve Axis@{ub}@{uu}@{bg back}


                    Original Idea...........@{b}Narcosis@{ub}                      

                    Design..................@{b}Axe and Crash!@{ub}

                    C Code..................@{b}Stigg@{ub}       

                    Docs by.................@{b}Crash! and Stigg@{ub}






                          @{"Ooh! That's Nice!" link "MAIN" 0}
@endnode

@node "CONFIG" Configuration


                      @{b}@{u}@{bg shine}Time-UL 1.0 © 1995 Nerve Axis@{ub}@{uu}@{bg back}

   All the program preferences are stored as ToolTypes in the programs icon.
   Select the icon and then 'Information' from the Workbench-->Icon menu.
   Below is a quick guide to what the prefs are and how to use them:

   @{b}Baud Rate:@{ub}  The program defaults to modem settings of 10 bits per byte
               with no compression. Now in practise, many modems can better
               the figures estimated using these values. For example, by
               default a 14400 modem will ul at 1440 characters per second.
               In reality, you get about 1570 or higher (depending on
               modem/file/line etc.) So to compensate, you can enter the
               modem speed as a ToolType, followed by the CPS rating.
               
               EG. for the 14400 modem mentioned, enter the following:
            
               14400=1570
            
               The program will now be that bit more accurate for your use.
            
               NB. If you enter unrecognised speeds, they are ignorred! ie.
               1275=130 will have no effect what-so-ever.

   @{b}DEFRATE:@{ub}    If you do not specify a default speed, the program assumes
               that you are using a 300 bps modem (very SAD). You want the
               program to always start using the speed of your modem, so you
               use the following ToolType:
            
               DEFRATE=n          where n:
                                          0 for  300 bps modem
                                          1 for  1200 bps modem
                                          2 for  2400 bps modem
                                          3 for  4800 bps modem
                                          4 for  9600 bps modem
                                          5 for 14400 bps modem
                                          6 for 16800 bps modem
                                          7 for 19200 bps modem
                                          8 for 21600 bps modem
                                          9 for 28800 bps modem

               me, I use a 14400 modem, so I have the following Tool Type:
            
               DEFRATE=5

   @{b}PATTERN:@{ub}    If you do not like the patterns I have used in the file
               selector then put your own in here! You must enclose them in
               braces () and separate each type with a vertical bar |. So
               to include only .ZIP or .ZOO files, use:
            
               PATTERN=(*.ZIP|*.ZOO)

   If you take a look at the ToolTypes set in the icon, you should get the
   idea, I have put them all in commented out, remove braces to enable them!

                               @{b}@{u}WARNING@{ub}@{uu}
   When setting ToolTypes _DO_NOT_ put extra spaces in, they cause problems.
   So:
   		14400=1570                            CORRECT
   		14400 = 1570                          WRONG
   		PATTERN = (*.zip|*.lha)               WRONG
   		DEFRATE =7                            WRONG


                            @{"BACK TO MAIN MENU" link "MAIN" 0}
@endnode

@node "NVX" Nerve Axis

   This is one of many utils to come from Nerve Axis. Contact one of our
   Bulletin Boards for info on others, or just to say hello. All welcome:

                @{b}Trick Or Treat II@{ub}    +44 (0)1703 391797
                @{b}13th Hour@{ub}            +44 (0)1704 505845
                @{b}The Edge@{ub}             +44 (0)1226 289303
                @{b}Power Plant@{ub}          +44 (0)1229 431590

@endnode
