home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / jagspeed.zip / JAGSPEED.INI < prev   
Text File  |  1994-02-17  |  18KB  |  412 lines
  1.  
  2. ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  3. ² JagSpeed.ini - help and configuration file for the JagSpeed/2 program ²
  4. ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  5.  
  6.  
  7.                               ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  8.                               ² Introduction ²
  9.                               ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  10.  
  11.     JagSpeed/2 is a 32-bit OS/2 2.X PM file manager.  Unlike OS/2's Drives 
  12. program, JagSpeed/2 looks like traditional DOS fullscreen file managers but 
  13. makes use of the advanced features of OS/2 including the Presentation 
  14. Manager user-interface and multi-tasking.  In addition to all the usual 
  15. features you would expect, you are able to compare subdirectories, 
  16. calculate file sizes and interact with a commandline to minimise any typing 
  17. you might do.  
  18.  
  19.     The program allows a user to have two directory listings on the screen 
  20. at the same time, each in a separate window.  The program allows the user 
  21. to make the most common file and program operations easily whilst still 
  22. providing the user with an ordinary commandline.  The program executes DOS 
  23. and Windows programs too.  
  24.  
  25.                               ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  26.                               ² Requirements ²
  27.                               ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  28.  
  29.     The program runs under OS/2 2 Presentation Manager.  Current version 
  30. uses System Monospaced and Courier fonts.  If these fonts are missing, 
  31. information in the file windows does not line up.  The fonts can be 
  32. installed using the Selective Install program in the System Setup folder.  
  33.  
  34.     The program supports FAT or HPFS file systems but not long file names.  
  35.  
  36.     I would advise the user to set the keyboard speed to fast.  This can be 
  37. done using your computer's reference disk.  
  38.  
  39.                               ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  40.                               ² Installation ²
  41.                               ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  42.  
  43.     From the OS/2 Desktop, open the Templates folder, drag the Program icon 
  44. (using the right mouse button) over to the Desktop area or into another 
  45. folder.  When you do this the program's settings will appear automatically.  
  46. Simply fill the Path and file name entry field with the full path name of 
  47. the jagspeed.exe file.  Click on the General tab, change the Title to a 
  48. more appropriate name (eg JagSpeed/2) then double click on the top left 
  49. hand corner (system icon) to save these changes.  Now double click on the 
  50. icon to start JagSpeed/2.  
  51.  
  52.                                 ΘÄÄÄÄÄÄÄÄÄÄÄ¿
  53.                                 ² Operation ²
  54.                                 ╖ÄÄÄÄÄÄÄÄÄÄÄδ
  55.  
  56.     The current file window, and therefore drive and subdirectory, is 
  57. presented in two ways:  the colour of the window and the command line 
  58. prompt.  
  59.  
  60.     Clicking on either file window or the commandline gives it input focus.  
  61. If using the keyboard the Tab key switches between file windows and the Esc 
  62. key switches between the current file window and the commandline.  
  63.  
  64.     File operations (chosen from the Files pulldown on the menu bar) 
  65. operate on the currently selected files.  Selected files are shown 
  66. hilighted.  The file windows are implemented using Extended Selection List
  67. Boxes, so selecting items and scrolling should be familiar to most
  68. users. To summarise:
  69.  
  70. Mouse operation:
  71.     click on item to change the currently selected file
  72.     use the scroll bar to scroll the window
  73.     double click to:
  74.        change to subdirectory (if subdirectory), otherwise
  75.        execute (if .exe, .cmd, .com or .bat extension), otherwise
  76.        edit, view etc according to program associations defined below
  77.  
  78. Keyboard operation:
  79.     '', '', Home, End, Page up/down changes the currently selected file
  80.     any char to scroll window to next file beginning with that char
  81.     'enter' key to:
  82.        change to subdirectory (if subdirectory), otherwise
  83.        execute (if .exe, .cmd, .com or .bat extension), otherwise
  84.        edit, view etc according to program associations defined below
  85.  
  86. Multiple selections:
  87.     drag up/down items to select adjacent files (automatically scrolls)
  88.     Shift + single click to select all files between previous click
  89.     Ctrl + single click to toggle selection of individual files
  90.  
  91.     The commandline is implemented using a Combo box.  New commands may be 
  92. entered by typing them in and entering.  The commandline uses basic editing 
  93. keys (insert, delete, backspace etc) and supports the clipboard.  Commands 
  94. entered are stored, can be viewed and re-entered or further edited from the 
  95. drop down list box.
  96.  
  97.                            ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  98.                            ² General information ²
  99.                            ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  100.  
  101.     File operations operate on the selected files and subdirectories and 
  102. all subdirectories leading from them.  
  103.  
  104.     The program behaves as the os/2 'move' command, in that it will not
  105. move files across drives. If required: copy then delete.
  106.  
  107.     The program offers the same protection to read-only files as do
  108. commands from an os/2 command prompt. For example set the 'r' attibute off
  109. before deleting them.
  110.  
  111.     File sizes listed in columns are actual file sizes - as provided by the
  112. 'dir' command. The differences between issuing a 'dir' and a window listing
  113. is that the latter includes hidden files and excludes the '.' subdirectory.
  114.  
  115.     File sizes provided along top of windows or when using the size
  116. function are totals of disk space allocated to those files - as provided by
  117. the 'chkdsk' command.
  118.  
  119.     The compare function compares the files in each window using their date 
  120. and time stamps.  Comparison on a byte by byte basis takes too long and 
  121. offers little practical benefit.  Users wanting to ensure files are 
  122. identical ought to use the OS/2's 'comp' command.
  123.  
  124.     A user requiring more information following an error popup can issue a 
  125. 'help xxx' command, where xxx was displayed in the popup.  
  126.  
  127.     Programs, double clicking and typing operate only on the first of a
  128. selected group of files.  
  129.  
  130.     The colours and fonts used by JagSpeed/2 can be changed, they are also 
  131. saved between program executions.  From the OS/2 System folder, select the 
  132. OS/2 System Setup folder.  Use the Color Palette and Font Palette programs 
  133. to configure as required. The font and colour of any item can be changed.
  134.  
  135.     When a colour is dropped onto the current file window, it then becomes 
  136. the current window colour.  This means that if the user then selects the 
  137. other window it will change automatically to the current window colour.  A 
  138. similar principle applies when dropping a colour onto the other file 
  139. window.  
  140.  
  141.     If the boxes in this file don't line up, change to a monospaced font.
  142.  
  143.                                    ΘÄÄÄÄÄÄ¿
  144.                                    ² Bugs ²
  145.                                    ╖ÄÄÄÄÄÄδ
  146.  
  147.     Please report bugs and suggestions for improvement to jgalvez at 
  148. crovm3.  
  149.  
  150.     There are no known bugs.
  151.  
  152.                               ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  153.                               ² Configurations ²
  154.                               ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  155.  
  156.     This file allows a user to configure such things as favourite programs, 
  157. file extension associations and the behaviour of some of the functions.
  158.  
  159.     The program reads this configuration file on startup.  By default it 
  160. assumes the file has the same path & name as the program file but with an 
  161. extension of 'ini' rather than 'exe'.  Alternatively the user may provide the 
  162. full pathname of the configuration file as an argument.  
  163.  
  164.     The order of the items does not matter as long as you keep to the
  165. following layout:  <keyword>:<blank space><user-defined values>
  166.  
  167.     Note that ALL keywords are FOUR characters long, immediately followed
  168. by a colon AND these must be the FIRST FIVE characters on a line.
  169.  
  170.                             ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  171.                             ² Favourite programs ²
  172.                             ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  173.  
  174.     The keywords below allow the user to add programs and commands to the 
  175. Programs pulldown on the menu bar.  These programs can be either OS/2 PM, 
  176. OS/2 FS, DOS or Windows.  Commandline arguments to the programs can also be 
  177. provided including the currently selected file in the file window.  
  178.  
  179.     Full path information is not required if the program can be found using 
  180. the PATH environment variable in config.sys.  When a program is invoked 
  181. JagSpeed/2 replaces the %s with the currently selected filename and 
  182. executes the command in the current window's directory.  For example:  
  183.  
  184.     CFXX: d:\utils\almcos2 %s ha:= = b /bin
  185.  
  186.     It is not necessary to provide a %s, if none is provided the command is
  187. still executed.
  188.  
  189.     The user can also specify any text (up to 20 chars in length) to 
  190. represent each of the programs in the Programs submenu.  If more than 20 
  191. are used the trailing chars are ignored.  
  192.  
  193. CN01: please
  194. CF01: 
  195.  
  196. CN02: read
  197. CF02: 
  198.  
  199. CN03: jagspeed.ini
  200. CF03: 
  201.  
  202. CN04: to
  203. CF04: 
  204.  
  205. CN05: configure
  206. CF05: 
  207.  
  208. CN06: these
  209. CF06: 
  210.  
  211. CN07: programs
  212. CF07: 
  213.  
  214. CN08:
  215. CF08:
  216.  
  217. CN09: print file
  218. CF09: print %s
  219.  
  220. CN10: display file
  221. CF10: more < %s
  222.  
  223. CN11: edit (system editor)
  224. CF11: c:\os2\e.exe %s
  225.  
  226. CN12: directory listing
  227. CF12: dir/p
  228.  
  229.                                ΘÄÄÄÄÄÄÄÄÄÄÄÄ¿
  230.                                ² Delete key ²
  231.                                ╖ÄÄÄÄÄÄÄÄÄÄÄÄδ
  232.  
  233.     The keyword below determines whether the user is prompted before making 
  234. deletions.  Anything other than off, is taken as indicating the user wishes 
  235. verification, the default behaviour.  
  236.  
  237. DELE: on
  238.  
  239.                             ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  240.                             ² Comparing windows ²
  241.                             ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  242.  
  243.     The keyword below determines whether the file windows are automatically 
  244. updated before they are compared.  Updating the windows first is the safest 
  245. thing to do, however there may be circumstances in which you would not want 
  246. to update the windows.  An example would be if you wanted to compare the 
  247. files on two diskettes at a machine which only had one diskette drive; 
  248. (each file window would display the contents of a different diskette).  
  249.  
  250.     Anything other than off, is taken as indicating the user wishes 
  251. updating before comparisons, the default behaviour.  
  252.  
  253. UPCO: on
  254.  
  255.                              ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  256.                              ² Selecting files ²
  257.                              ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  258.  
  259.     The keyword below determines whether the 'Select all' function selects 
  260. both files and subdirectories or just files.  Anything other than off, is 
  261. taken as indicating the user wishes to select only files, the default 
  262. behaviour.  
  263.  
  264. PLUS: on
  265.  
  266.     The user should be aware that setting the UPCO and PLUS keywords off
  267. will allow him to erase everything on a drive with only two keystokes, if
  268. performed whilst in the root directory.
  269.  
  270.                             ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  271.                             ² Drive information ²
  272.                             ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  273.  
  274.     The keyword below determines how much information is given to the user 
  275. when displaying the drive selection dialog box.  In addition to the drive 
  276. letter, the user can opt for label, total and free disk space information.  
  277. The info is displayed for each drive as an aid to drive selection.  Drives 
  278. with removable media not present do not show full information.  
  279.  
  280.     A reason for opting to switch full info off would be in the case of a 
  281. system connected to many drives, particularly with removable ones, which take 
  282. some time to be read.  Anything other than off, is taken as indicating the 
  283. user wishes full drive information, the default behaviour.  
  284.  
  285. INFO: on
  286.  
  287.                        ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  288.                        ²  File extension associations ²
  289.                        ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  290.  
  291.     The keyword below determines whether, and if so, which program is 
  292. executed when the mouse is double-clicked or the enter key is used over a 
  293. file.  The program is passed the currently selected file's name as a 
  294. parameter.  These programs can be either OS/2 PM, OS/2 FS, DOS or Windows.  
  295.  
  296.     The user may associate particular file extensions with particular 
  297. programs, giving each extension - program combination on separate lines
  298. below.  The user can also provide a default program if no file extension 
  299. association exists.  The use of a default program can be switched off.
  300.  
  301.     Full path information is required unless a program can be found using 
  302. the PATH environment variable.  In the case of the default program 
  303. (indicated by the keyword ENTR:)  anything other than off, the default, is 
  304. taken as indicating the name of the program to be executed.  
  305.  
  306.     For those interested, the programs listed above in the Favourite 
  307. Programs section are executed as if the text had been entered at the 
  308. command line. Operating system commands, programs and batch files can all 
  309. executed, if desired, the currently selected file can be placed on any
  310. position on the command line.
  311.  
  312.     On the other hand, only programs and batch files can be used in this 
  313. section.  Programs are dealt with in the same way as program objects and 
  314. associations in the OS/2 WorkPlace Shell, ie filename extensions need to be 
  315. provided, a working directory is unnecessary since the current directory is 
  316. used and the parameters are automatically the name of the currently 
  317. selected file.  
  318.  
  319. .TXT: e.exe
  320. .BAK: e.exe 
  321. ENTR: c:\os2\e.exe
  322.  
  323.                            ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  324.                            ² Default directories ²
  325.                            ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  326.  
  327.     The keywords below determine the initial subdirectories displayed in 
  328. the file windows.  DIRL and DIRR refer to the left and right windows 
  329. respectively.  If used, ensure that the drive letter preceeds the 
  330. subdirectory name.  If these are not set the current (or working) 
  331. subdirectory when JagSpeed/2 is executed will be used.  
  332.  
  333. DIRL: c:\
  334. DIRR: c:\
  335.  
  336.                           ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  337.                           ² Default sorting method ²
  338.                           ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  339.  
  340.     The keyword below determines if and how the subdirectories and files 
  341. are sorted in each window.  Valid selections are:
  342.         unsorted -  no sorting performed
  343.         name -      sort by stem of filename
  344.         extension - sort by extension
  345.         size -      sort by size
  346.         datetime -  sort by date & time
  347.     In the last 4 cases sorting is first performed automatically by 
  348. subdirectory and file, then within that the sort choice.  In case you 
  349. didn't know - subdirectories can have extensions too!  
  350.  
  351.     Anything other than one of the 5 valid methods above, is taken as 
  352. indicating the user wishes to sort by extension, the default behaviour.  
  353.  
  354. SORT: extension
  355.  
  356.                           ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  357.                           ² Displaying file names ²
  358.                           ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  359.  
  360.     The keyword below determines whether file operations display the names 
  361. of files as they are acted upon (copied, moved etc).  Although it is 
  362. reassuring to see that the program is working (not hung!) it actually 
  363. makes the operations take longer to perform.
  364.  
  365.     Anything other than off, is taken as indicating the user wishes to have 
  366. the file names displayed, the default behaviour.  
  367.  
  368. FILS: on
  369.  
  370.                          ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  371.                          ² Presentation parameters ²
  372.                          ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  373.  
  374.     The colours, fonts and window size information are stored between 
  375. program executions.  These 'presentation parameters' are stored in the
  376. os2.ini system file.
  377.  
  378.     The keyword below determines whether when the program starts up it uses 
  379. a default set of parameters or those stored from the previous execution of 
  380. the program.  In the latter case, if this is the first time the program has 
  381. been executed on a system and consequently no parameter information exists, 
  382. then the default parameters are automatically selected for the user.  
  383.  
  384.     Anything other than off, is taken as indicating the user wishes to use 
  385. the parameters previously set, the default behaviour.  
  386.  
  387. PARA: on
  388.  
  389.                      ΘÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  390.                      ² Pausing after programs / commands ²
  391.                      ╖ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄδ
  392.  
  393.     Programs (chosen from the Programs pulldown on the menu bar) or 
  394. commands (entered from the command-line) are executed in sessions.  The 
  395. keywords below determine whether when the program / command finishes, the 
  396. session is automatically closed or whether the user is first prompted to 
  397. hit a key.  
  398.  
  399.     Generally automatic closure is preferable, however programs / commnads 
  400. that use stdio for output (ie non-PM programs or operating system commands 
  401. such as chkdsk) would flash their messages and dissapear before the user 
  402. could read them.  In such cases the user would want to pause before the 
  403. session was destroyed.  
  404.  
  405.     Anything other than off, is taken as indicating the user wishes to 
  406. pause the session.  off is the default behaviour for programs, on the 
  407. default for commands.  
  408.  
  409. PPRO: off
  410. PCOM: on
  411.  
  412.