home *** CD-ROM | disk | FTP | other *** search
/ Rockford Magazine / Rockford_Magazine_040_19xx_-_de_Disk_1_of_5_Side_A.d64 / betadocs.txt next >
Text File  |  2023-02-26  |  15KB  |  349 lines
  1.  
  2.                                  BROWSER NOTES
  3.  
  4.    Created: 11 September 1995
  5.    Docs updated on 7th Jan 1996
  6.  
  7.    Browser Update Dated: 7th Jan 1996
  8.  
  9.    The latest update of Browser is dated internally as 7th Jan, 1996
  10.  
  11.      -----------------------------------------------------------------
  12.  
  13.    Here's your opportunity to see a program work in progress!
  14.    No warranties, guarantees etc, ... These updates will be
  15.    posted periodically (every week or two).
  16.  
  17.    For those who have never used Browser, I highly recommend you download
  18.    browser2.sfx and read the documentation for it. This page only deals
  19.    with the updates since that release.
  20.      -----------------------------------------------------------------
  21.  
  22.      These notes will be appended to with each new update. All CURRENT
  23.      changes will be noted at the END of this file.
  24.      ALL options subject to change without notice.
  25.        ---------------------------------------------------------------
  26.  
  27.  
  28.    Early September Notes
  29.  
  30.      * Hot keys. When the highlight bar is over a file and you know what
  31.        it is, pressing the appropriate key will get you started reading
  32.        (or running) it. The keys are:
  33.  
  34.  
  35. A - Ascii
  36. P - Petscii
  37. B - BASIC
  38. N - ANSI
  39. D - DAT
  40. K - PKT
  41. R - Run  (only for C128 Prg files)
  42.  
  43.  
  44.      * Scratching & Renaming. When the highlight bar is over a file, you
  45.        can change the filename or scratch it. Shifted 'r' for renaming,
  46.        Shifted 's' for scratching. Scratching gives no warning. (Well you
  47.        have to hit the shift key so that should be enough warning).
  48.  
  49.        The index files (described later) are also scratched or renamed,
  50.        if they exist.
  51.  
  52.      * Index files. Browser will prompt to save an index file for any of
  53.        the file types which it can read. The index saves the file type,
  54.        screen size, etc. These index files consist of the filename with
  55.        the first character changed to a '%' symbol. These files are USR
  56.        files and don't appear in the Browser files window. Since it
  57.        relates to the T&S information for the file, if you move a file to
  58.        another disk or directory, forget about copying the index file for
  59.        it.
  60.        
  61.      * The (W)rite command. This brings up a window with options which
  62.        relate to saving a file to disk. Any of the options can be toggled
  63.        by using the key relating to each option.
  64.        
  65.  
  66.     Device: # (2-16)  Disk drive or Printer
  67.     Write:            DAT/ Packet/ Petscii/ Ascii
  68.     Disk or Printer   Either
  69.     Existing files    Append/ Ask/ Replace
  70.     Remainder or all  Either
  71.     eCho to screen    Yes/No
  72.    The Write as Packet option is not currently functional. You can't save
  73.        a Pet (or any 'non' .Dat file) as a DAT file. The Write option
  74.        appears when viewing an ANSI, but it doesn't work.
  75.        
  76.      NOTE: There is a *minor* bug in saving DAT to DAT files with all
  77.      drives other than a RamLink. It saves to other drives ok, but the
  78.      private/public flag tends to get mis-set.
  79.    
  80.        
  81.      * 'Remainder' lets you save from the current page you're viewing. If
  82.        you use this and have eCho to screen toggled as Yes, you can use
  83.        the stop key to stop the saving of text at any stage. This lets
  84.        you save portions of a long file as smaller individual files. (I
  85.        use it to grab stuff from the FAQ files).
  86.        
  87.      * DAT/PKT files do not let you save 'Remainder' in this manner - but
  88.        you can save the FAQ files (or any message) as a Pet or ASCII file
  89.        then use this method to retrieve what you need from it.
  90.        
  91.      * File naming. You can name a .DAT file that you save anything you
  92.        like, it doesn't even have to end in '.dat'.
  93.        
  94.      Hint: We often rename the messages.dat file to something else before
  95.      reading it with Browser, then save/append messages we want to answer
  96.      to 'messages.dat' so we can load QWKRR when finished reading the
  97.      mail packet.
  98.  
  99.        
  100.      * Listing a BASIC file will no longer crash the system. You can also
  101.        write a BASIC file to disk as a text file.
  102.        
  103.      * Depending on the size of the .DAT file and what's at the end,
  104.        Browser sometimes displays and 'extra' message at the end which
  105.        looks nasty on the screen. It's not a bug just the way the DAT
  106.        file ends.
  107.        
  108.    
  109.      -----------------------------------------------------------------
  110.    
  111.    Mid September Notes
  112.    
  113.      * This version is 'intelligent' in that it will attempt to determine
  114.        what type of file is being read (ascii, pet, .dat, ansi, pkt and
  115.        BASIC). For the most part it gets it right, but if not, its
  116.        'guess' can be ignored by pressing the appropriate key for the
  117.        format required.
  118.  
  119.      * Each time you open a new directory Browser will search for a
  120.        control.dat file, and if found it will display the users name at
  121.        the top of the screen. This is mainly an indicator that a
  122.        control.dat exists. If it does exist, when you read .DAT type
  123.        files you will be given the option to use the control.dat or not.
  124.        Selecting NO will give the fastest method of reading the file, but
  125.        only the area NUMBERS will be used. Selecting YES will show the
  126.        area NAMES, plus it will also highlight any messages to or from
  127.        the user.
  128.        
  129.      * Each area name is only 'read' once. The speed difference is then
  130.        negligable. Ramlink users will never notice the speed difference
  131.        anyway.
  132.        
  133.      * C128 BASIC files can still be RUN from Browser (highlight the
  134.        file, and press 'r'), but it will no longer even attempt to run
  135.        C64 BASIC programs.This is generally a good thing since most C64
  136.        programs will crash the computer - However, there are some
  137.        programs, such as CMD's Fcopy and Mcopy that will run in both
  138.        C64/128 modes. Unfortunately, Browser will often 'see' these as
  139.        C64 BASIC files and won't attempt to run them..If this is the
  140.        case, the easiest solution is to load the program (in C128 mode)
  141.        as you normally would, then resave the file back to disk. This
  142.        causes the load address to be reset and Browser will then 'see'
  143.        them as C128 runnable programs. (They can still be Loaded/Run from
  144.        64 mode as normal).
  145.        
  146.      * Pressing the SHIFT 'i' key will display information found in the
  147.        control.dat file, if a control.dat is in the directory.
  148.        
  149.    
  150.      -----------------------------------------------------------------
  151.    
  152.    September 24th Notes
  153.    
  154.      * Browser has new character sets! After a lot of work... Gaelyne has
  155.        put together a collection of over 30 character sets for use with
  156.        Browser - all with the correct C= Graphics. And... she's also
  157.        updated the same character sets using full ASCII graphics too. The
  158.        fullset character sets can be used in Desterm too, instead of the
  159.        des.ibmfullset file. For those of you into FTPing, other Desterm
  160.        compatible character sets (for each terminal emulation type) can
  161.        be found at hal9000.apana.org.au in the /cbm/desterm directory, or
  162.        at ccnga.uwaterloo.ca /pub/cbm/INCOMING/telecomm and eventually in
  163.        the /pub/cbm/telecomm directory.
  164.      * Fidonet users can get these from 221b Baker Street BBS. 1:366/221,
  165.        but the filenames begin with a 'des' so users know they are for
  166.        use with Desterm.
  167.        
  168.        
  169.        
  170.    The files and their descriptions:
  171.    
  172.      * browchrs.sfx on 221B Baker Street BBS = cbmchrs.sfx - Browser cbm
  173.        graphic character sets
  174.        
  175.        
  176.      * desful.sfx = fullset.sfx - Desterm ibmfullset character sets. Can
  177.        also be used with Browser.
  178.  
  179.      * desibm.sfx = ibmset.sfx - Desterm ibmset character sets
  180.      * desami.sfx = amiset.sfx - Desterm amigaset character sets
  181.      * descbm.sfx = cbmset.sfx - Desterm cbmset character sets
  182.      * descg.sfx = cbmcgset.sfx - Desterm cbmcgset character sets
  183.      * desvt52.sfx = vt52set.sfx - Desterm vt52set character sets
  184.      * desvt102.sfx = vt102set.sfx - Desterm vt102set character sets
  185.        
  186.        
  187.        
  188.    September 25th Notes
  189.    
  190.    
  191.      -----------------------------------------------------------------
  192.    
  193.      DELETE any old indexes!! (those made with a version of browser dated
  194.      24rd Sept, or before). They are not compatible with later updates
  195.      and WILL cause problems!
  196.      
  197.      (Sorry - but you'll appreciate the new indexes).
  198.  
  199.    
  200.      -----------------------------------------------------------------
  201.    
  202.    
  203.    
  204.      * Browser has a new look. It uses an internal Pet ASCII set allowing
  205.        you to see disk directories and BASIC file listings with the
  206.        correct CBM graphic characters. The internal pet character set has
  207.        a few graphic characters altered to get the windows right - if
  208.        these are 'noticeable' (displaying where you wouldn't expect
  209.        them), please let us know.
  210.        
  211.      * The internal IBM-ASCII set has been maintained from the previous
  212.        versions for reading .DAT and ANSI files.
  213.        
  214.      * CTRL-0 (zero) and CTRL-1 toggles between the two internal
  215.        character sets. You can use this while viewing files.
  216.        
  217.      * If you have 64K VDC, you can load up to 8 additional character
  218.        sets which are accessible to you with the CTRL and number keys
  219.        2-9.
  220.        
  221.      * If you only have 16K VDC, other sets can be loaded and used, but
  222.        they will be lost if one of the internal ones are accessed through
  223.        the CTRL 0 and 1 keys.
  224.        
  225.      * Avoid the actual loading of character sets while reading text,
  226.        do this beforehand.
  227.        
  228.      * Under the 'Display defaults' window, there is a new option for
  229.        charset usage. The choices are 'PET, ASCII, AUTO and User'. AUTO
  230.        will automatically choose between the internal character sets when
  231.        you view files (ie, the ASCII set is used for ASCII type files,
  232.        and the PET set is used for PETscii text files or when listing a
  233.        BASIC file). Pet always uses the pet set, ASCII always uses the
  234.        ASCII set, and the User set will use what you load, if none are
  235.        loaded it defaults to the internal ASCII set.
  236.        
  237.      * The Options menu can now be accessed from within files, and it
  238.        allows you to change colours and how the text is viewed (CR,LF,
  239.        LF+CR, TAB, etc).
  240.        
  241.      * It bears repeating... Delete any old indexes! - They are not
  242.        compatible with this update and WILL cause problems.
  243.        
  244.      * When you save an INDEX for a file the colour, screen size, LFs,
  245.        CR, TAB, etc information is saved in the index. This makes it
  246.        possible to have several different 'default' settings for Browser,
  247.        depending on your needs/desires. If there is no index file, the
  248.        last used colours and other settings are used.
  249.        
  250.    
  251.      -----------------------------------------------------------------
  252.    
  253.    October 2nd Notes
  254.    
  255.      * Screen sizing can now be changed while reading files.
  256.        
  257.      * Border colours are now correctly updated when changed while
  258.        reading a file.
  259.        
  260.      * The colour selection menu is now in colour :-)
  261.        
  262.      * Character sets can now be loaded while reading files, but to
  263.        prevent crashing you must ensure that you are back on the same
  264.        drive and directory when you exit the character set menu that you
  265.        were when you entered it.
  266.        
  267.      * To/From/Subj lines are now displayed with the user selected
  268.        character set, rather than the internal ASCII set.
  269.        
  270.    
  271.      -----------------------------------------------------------------
  272.    
  273.    October 13th Notes
  274.    
  275.      * Browser will now load and run C64 programs. This doesn't work with
  276.        some versions of RAMLink (even if trying to load a program from
  277.        another disk device). Both Rod and I have Ramlinks, and this works
  278.        just great on his system, but not on mine. Feedback on this would
  279.        be welcome. Don't forget to switch your monitor to 40 col mode.
  280.        
  281.      * If a ':' appears in the first 11 characters of a .DAT file,
  282.        anything after the colon is colourised. Currently, it's the same
  283.        colour as quoted text, but this may change in the future. This
  284.        serves a couple different purposes: first, it makes it easier to
  285.        read Internet style replies where a colon has been used as a quote
  286.        symbol. Second, it helps to make the Internet style headers on
  287.        messages look a little better.
  288.        
  289.    October 22nd Notes
  290.    
  291.      * The problem with Browser not loading and running 64 mode programs
  292.        from certain Ramlink's has been solved. It's new drawback is that
  293.        it resets the Ramlink to it's default partition/directory, so if
  294.        what you want to load is on the Ramlink in a different partition
  295.        from your default, it doesn't work. It works fine for loading C64
  296.        files from any other device, however.
  297.        
  298.    October 26th Notes
  299.    
  300.      * Fixed file identifier problem. It now recognises CAM-MAIL QWK
  301.        packets as a .DAT file.
  302.        
  303.      * Fixed control.dat problem. It now displays the conference mames
  304.        when reading QWK packets from Cam-mail.
  305.  
  306.    November 27th Notes
  307.  
  308.      * Fixed bug with printing via parallel cable
  309.      * Fixed bug with writing files to disk
  310.  
  311.    December 11th Notes
  312.  
  313.    Browser is still unreliable when used with non-jiffyDos'd 1581's.
  314.  
  315.      * Browser now auto-detects the type of file (Pet, ASCII, DAT, PKT,
  316.        etc) and displays it as detected instead of showing the additional
  317.        menu. If the file does not display correctly, exit the file, then
  318.        when the cursor is over the filename, press the key corresponding
  319.        to the way you wish to view the file. IE, if it's an ASCII text
  320.        file, press the letter 'a'.
  321.  
  322.  Jan 7th Notes
  323.  
  324.      * Fixed a bug that caused crashing with .DAT files padded with
  325.        nulls (ASCII#0).
  326.  
  327.      * Minor changes to user interface and updated menu bar options.
  328.  
  329.      * To see the auto-detected filetype hold your keypress and the
  330.        filetype will be displayed on the menu bar.
  331.  
  332.          -------------------------------------------------------------
  333.  
  334.      NOTE!
  335.  
  336.      If you do have any problems or run into anything interesting, please
  337.      let us know about it. When you do, for our information and
  338.      reference, please note the date shown when you quit the program.
  339.  
  340.      -----------------------------------------------------------------
  341.  
  342.      * Email Gaelyne Moranec with questions, comments, bug reports, etc.
  343.        (Preferred)
  344.      * Email Rod Gasson with questions, comments, bug reports, etc. (May
  345.        take a few days for a reply).
  346.        
  347.     Gaelyne Moranec / moranec@hal9000.apana.org.au
  348.  
  349.