Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/372.lha/Az_v1.50/AZ_English/Manual/History

Text File | 1990-05-05 | 27KB | 471 lines

/*==========================================================================
 * \__________/ Copyright 1988-90 Jean-Michel Forgeas & The Software Winery.
 *  \°   °   /  All Rights Reserved. This program may not be distributed
 *   \ °   °/   without the permission of the author:
 *    \  ° /         Jean-Michel Forgeas
 *     \ °/          4 rue du Général Leclerc
 *      ||           95210 Saint-Gratien   FRANCE
 *      ||      Contact The Software Winery at :
 *      ||           BBS     : [phone]  (V23 Videotex)
 *      ||           MAIL    : c/o Alain DIDIERJEAN 69 rue Dunois
 *      ||                     75646 Paris cedex 13 FRANCE
 *    «====»         INTERNET: [e-mail] or [e-mail]
 *==========================================================================
 */


 ==========================================================================
||                                                                        ||
||      AZ : History                                                      ||
||                                  -version # : 1.50 (06-Feb-90)-        ||
 ==========================================================================




v1.0  / circa 15-Aug-88
        - AZ beginnings as public domain.

v1.01   - bug fixed when Requester opening followed by a quick RETURN
        - good: when iconifying a window which contents have been modified,
        colors are inversed in the icon. (token from Dillon´s DME)
        - parameter -t added for tabulation
        - ENTER key change. Equivalent to RETURN followed by SHIFT TAB.
        Useful for back-indentation
        - BACKSPACE pressed at beginning of line now appends to the
        preceding line.
        - double-click activates block-line mode. In this mode, blocks are
        made of entire lines.

v1.02   - if menu Save selected when file is Untitled, SaveAs is run instead
        - AZ windows open to full screen

v1.10   - refresh of simple Requesters fixed when resize of a window occurs
        (fixed with the help of Gauthier Groult)
        - fixed bug of repeated tabs that leaved black traces
        - block-line mode works like a switch (more intuitive)
        - first window opens to full screen, others are smaller
        - fixed bug of repeated keys that inserted unwanted characters
        (with Amiga-keys)
        - fixed bug of pointer remaining in ZZ (note that the click-point
        in this image is left-top, and you may also type RETURN to make
        a requester disappear)
        - fixed bug of PASTE at the end of a long line
        - fixed bug on Cut (on multiple lines, it failed to cut some
        characters)
        - after a Paste or Replace, the cursor is now placed after the
        inserted string.
        - Find and Replace now have menu short-cuts
        - NEW ! Topaz fonts (8, 9 , 11) or others may now be used when
        running AZ, using option -f (see above)
        If no font is given with option -f, the default font (the one from
        Preferences is chosen).
        - That´s all for now ! Quite a difference from version 1.02
        isn´t it ?

v1.11   - in Find menu, Replace has been changed to ´Exchange´
        - in Find menu, new item Exchange All
        - in Find menu, two new items: Find selected and Exchange Selected.
        The current selected block (if any, it´s highlighted) is now copied
        into the search StringGadget. (would you prefer the CLipboard instead ?)
        - in menu Find, the buffer used by Find is now different from the
        buffer used by Exchange
        - fixed small bug on title of iconified window
        - the last line (sometimes hidden partially, is now uncovered
        when the cursor moves to it
        - other minor enhancements.

v1.2    - scrolling is now faster (ClipBlit() instead of ScrollRastPort()).
        - memory management has been modified -> faster display.
        - accumulation of RAWKEY messages (caused by repeating of up and
        down arrows) has been removed by a scan of messages. Memory is
        spared because Intuition no longer allocates more messages when
        you have a fast repetition factor in Preferences.
        - this scanning allows also an immediate stop of the scrolling
        when you stop pressing these arrow keys.

v1.21   - insertion of a character over a block after a Find now
        works properly.

v1.22   - bug on too long lines fixed.
        - !!! FileRequester has been fixed by Gauthier H. Groult.
        new functions have been added, such as wildcards, PARENT , SCAN
        and STOP gadgets, interruption on arrows. Design has also been
        fixed (much nicer now). And more, it is now REENTRANT ! You can
        open a requester in every window of AZ.
        By the way, Gauthier has put this FileRequester as well as other
        useful functions in a library (to which I gave some modest
        contribution), with docs from programmers and everything you need.
        Its name is isup.lib, and AZ uses it with luck.
        Gauthier is looking for beta-testers.

v1.23   - one time out of a thousand, a small requester locked out
        and stayed white. This is over.
        - Find on a single character would not skip to the next occurrence.
        This has been fixed.
        - Scanning has been added, so that scrolling ceases as soon as
        you stop pressing left or right arrow. Handy when you select
        a block. and then scroll laterally with these two arrows.

v1.24   - put back the original File Requester, because AZ didn´t seem
        too well. Test version only. I´m looking for bugs.

v1.25   - Major cleaning of the code. Some internal bugs found (and fixed !)
        - SHIFT TAB now deletes spaces (before cursor).
        - New: ALT TAB places the cursor on the first printable character
        of the line. To use with SHIFT-TAB for a back-tab.
        - New : SHIFT ENTER (not SHIFT RETURN) splits a line, with
        back-indentation on the new (second) line.
        - after clicking two times (in block-line mode), Find wouldn´t
        show found block anymore. I found the bug this time !
        - Characters strings are no more null-terminated. This allows
        you to insert 00 characters in the text (using menu Insert Hexa)
        - FileRequester modified to have ´OK´ gadget on the left and
        ´CANCEL´ gadget on the right. There was also a non-reentrant
        requester, and I fixed it.
        - All Requester may now use CHIP memory, so that AZ works on
        512K machines.
        - New: ´Clone Line´ duplicates the current line.

v1.26   - You now may insert a carriage return (0x0d) with Ctrl-M.
        Before this fix, you could only use the ´Insert Hexa´ menu for
        this purpose.
        - Bug: Guru visits on quitting AZ, depending on your environment
        (not mine, so I couldn´t see that bug). Fixed.
        - Deleting a block on the last line of the file would leave an
        entire line. Fixed.
        - Exchange sometimes left extra characters, or deleted some...
        - Some character-display bugs found. Nothing better to fix bug
        for adding new ones !

v1.27   - Shortcuts '=' and ';' for 'Exchange All' and 'Print Selected'
        - Fixed bug in clipboard managing: when trying a read (Paste) on
        a file that is not IFF text, the clipboard was not freed. This solves
        the problems with TextCraft and Excellence!
        - HELP now pops up a requester with the use of function keys
        - NEW !!! (while waiting for cut by rectangles) it is possible
        to indent or back-indent by block:
        double-click and highlight a block in 'block-line' mode, then press
        TAB to indent or SHIFT+TAB to back-indent.
        'Select All' does not provide this feature because it is not part
        of the 'block-line' mode.
        - when launching AZ with a non-existant file name as parameter,
        the FileRequester does not appear any more. There is only a small
        requester, and you get rid of it by pressing RETURN. The title
        of the window will be the same as the parameter.
        - the default for TAB is now 4

v1.28   - recompiled with Lattice 5.02, and the new version of isup.lib

v1.29   - AZ now supports keymaps that send multiple characters on a key
        - In 'block-line' mode, pressing left or right arrow allows
        indentation by one character
        - faster memory management (work with Gauthier Groult)
        - fixed bug introduced in v1.27 when running AZ on a non-existant
        file
        - 'Exchange Selected' now fills both zones with the selected text
        - minor bugs fixed
        - scanning of Intuition messages is now done on all keys, and also
        faster : you will never insert or delete characters by mistake.
        - 'Print Selected' does a form feed every 64 lines.
        - NEW!!! option 'Send Selected': send the selected text to SER:
        with the possibility to end each line by CR, LF, CRLF, SUITE (minitel)
        or nothing (ASIS). This option may be used with minitels or modems.
        Parameters for the serial port are token from Preferences, so don't
        forget to set them properly. For a minitel:
        BAUD=1200 READ=WRITE=7 STOP=1 PARITY=EVEN HANDSHAKE=NONE
        Beware of accentuation ! no translation is done !

v1.30   - Bug on the hex code displayed in the title bar fixed.

v1.31   - Added TAB as a separator for arguments. There may now be multiple
        spaces or TABs between filenames on the command line.
        (hmm...)  you may now use all 6 options when running AZ...
        (hmm...)

v1.32   - New option in menu 'Tools': 'Switch Case' to switch a character
        from lowercase to uppercase and back. Works also on blocks.
        Switch Case is defined only for characters from 'A' to 'Z' and
        'a' to 'z'.
        - New option in menu 'Tools': 'To Front Screen' to move an
        AZ window from a background screen to the foreground screen.

v1.33  / 09-May-89
       - Added LockLayer() and UnlockLayer() before and after modifying
         the ClipRects of the Layer of a window.
         Yes... it's cleaner... I believe the Guru was there...
       - Fixed: when the full pathname of the edited file was too long,
         the requester "Can't Create this file" was truncating it.
       - Added: test OpenFont() before OpenDiskFont(): even after loading
         a font, every byte of memory is released.
       - Modification of use in 'Exchange Next/Back':
         If a block is already selected, then it is replaced immediately.
         Else, this option first 'Find's then replacing is done after.
         (this is verification for interactive replace)
       - Doc Bug: I never said that CANCEL of simple requesters may be
         done from keyboard, but it works: it's ESCAPE (Esc).
         Let me remind you: the validation gadget (OK, OPEN, ...) that is
         on the left of those requesters is completed by the RETURN key.
       - NEW!: block selection from keyboard. CTRL-Space simulates click
         and double-click of the mouse. CTRL-arrow simulates move of the
         mouse. CTRL-arrow works together with SHIFT and ALT, same way
         as arrow alone, but selecting blocks continuously.
       - Number of lines is no more limited to 32000, but to several
         billions.

v1.34 / 14-May-89
       - Bug in 'Paste': when memory was lacking, ClipBoard was not closed.
       - Modifications in block-insertion.
       - Added option -cNN to set the maximum number of columns in a line.
       - in 'Copy', added a test for available memory before writing to
         ClipBoard, in order to avoid errors with ClipBoard.device.
         Two days of testing convinced me that I couldn't do better without
         more docs on the clipboard, or that device is bugged...
         Anyway, ClipBoard is more robust when CLIPS: is assigned in RAM:
         (as proposed in WB1.3 startup-sequence), otherwise DoIO()
         might be blocked when accessing drives.
       - When writing in the ClipBoard of a file, and a line is exactly
         of the maximum length, new line is NOT inserted. This avoids
         adding empty lines when reading the file/clip back.
       - NEW!: 'Load Binary'  loads a file without changing tabs to spaces.
         You may now edit an executable file: change error messages to your
         language (french for example). Do NOT change the length of the
         strings !
       - Bug fixed when RETURN or SHIFT-DEL near the lower border of
         the window (GURU).
       - Bug fixed when clicking on CloseWindow gadgets (I hope)
       - Scrollbars (lifts) now show 5 lines more after the end of the text,
         and one column more on the right of the last column.
       - Modification of 'Exchange': the search string is copied into
         the 'Find' search string. This allows full interactive exchange.
         Choose 'Exchange Next' (or AMIGA-R) to replace, or (AMIGA-N) to
         skip to next occurrence. This time it's handy.
       - Keymap management has been revised. AZ now handles keymaps
         completely. This means that using a keymap editor (like KeymapEd
         by Tim Priest, available on a BBS near you and on a Fish disk),
         you may assign to a key (such as ALT-F1) a sequence of codes
         (such as SHIFT-TAB or arrows), or simply a sequence of characters.
         Kind of mini-macros.
       - Patterns on file names used in the File Requester may be
         specified on the command line using option -p, example: -p*.c
         for all file names ending with '.c'. Default is '*'.
       - Note: to save to a device (SER:, PRT:) using the File Requester,
         just fill the filename zone with the device name (SER: for example).
         But you may as well use the menus 'Print Selected' and 'Send Selected'.

v1.40 / 16-May-89
      - First release of AZ send to Fred Fish for inclusion in his library.
        (via Francois Rouaix and USENET).
        To celebrate, we skip directly to version 1.40 !

v1.41 / 22-June-89
      - If the number of characters to be written is odd, AZ adds a null
        character in the clipboard.
      - Bug found at the end of code, most probably responsible for calling
        of GURU 0000004 sometimes when Quitting AZ.
      - TABs are now expanded as 8 spaces, which avoids much indented source
        files containing TABs getting out of shape. (DME compatible, thanks
        to Gauthier Groult, without whom I would never have found where the
        problem lied).
      - AZ does not swallow the last line, if empty, any more when saving.
      - A double CTRL+SPACE sets the block-line on (like a double click).
      - A SHIFT+Click draws a block from the cursor position to the mouse
        pointer position.
      - NEW : AZ reads the protection bits when loading a file and restores
        them when saving, except for the 'archived' bit.
      - NEW : line parameters AND filenames can be passed to AZ using its
        icon : select AZ's icon then the info item in the WorkBench menu,
        click ADD in Tool Types and type something like :
                PARM=-b -t3 file1 RAM:file2
        PARM= has to be typed, no space between PARM and =, otherwise
        parameters would never reach AZ.
      - NEW : if AZ is called with a directory name instead of a filename
        as a parameter, this directory becomes AZ's current directory, and
        the FileRequester displays its content.  Very useful when calling
        AZ from a SHELL.
      - NEW : the 'Send Selected & SUITE' menu option expects you to send
        text to a Videotex BBS (SgtFLam?, Khéops?), so it translates Amiga
        accentuated characters into Minitel accentuated characters.
        To get 'OE' or 'oe' stuck together on the Minitel screen, you'll
        have to type Æ or æ in AZ (Insert Hexa: C6 and E6).
        Connexion procedures to BBS can be made using this option. For that
        purpose, you have to know how the Minitel function keys work. They
        send 2 codes : CTRL-S, then a letter from A to I :
        ENVOI: A, RETOUR: B, REPETITION: C, GUIDE: D,
        ANNULATION: E, SOMMAIRE: F, CORRECTION: G,
        SUITE: H, CONNEXION/FIN: I
      - NEW : a 'Cur Dir' menu item in the 'Project' menu allows you to
        change the current directory of an AZ window.
      - NEW : filenames including spaces can be surrounded by double
        quotes : AZ "Ram Disk:x x x".
      - (hum...) again, CTRL-M can be inserted using the keyboard...
      - NEW : 'Project' 'Erase' to delete a file.
      - NEW : a new FileRequester, by Alex LIVSHITS; that implies removal
        of command line options -s (simple requester) and -p (pattern
        requester). The new requester has no pattern matching feature, and
        a filename can be entered without using the mouse.
        USE : No StringGadget activated when the FileRequester is opened.
            Right-AMIGA-X  clears the 'Path' StringGadget and activates it,
            Up-Arrow  activates the 'Path' StringGadget,
            Down-Arrow  activates the 'File' StringGadget,
            ESC  if no StringGadget is activated, works like the 'CANCEL'
                Gadget at the bottom right,
            RETURN  if a StringGadget is activated, works like the 'OK'
                Gadget at the bottom left.
        The Disk Icon shows the list of the available devices. To get
        back to the window current directory, just activate the 'Path'
        StringGadget then hit RETURN.
        To sort a list, click on the 'abc' Gadget.
        The whole filename (path+filename that is) can be typed into the
        'Path' StringGadget.
      - Advice : if you 'Assign AZ: directory/AZ' and use AZ: as the DEFAULT
        TOOL in a textfile.info, the textfile will find AZ wherever it is.

v1.42 / 09-Jul-89
      - The AZ-guruing-when-leaving bug fixed once more. Could work this
        time (thanks to François Rouaix).
        What happened : the last AZ Process ended like this:
        Forbid - UnLoadSeg - move.l #0,d0 - rts. The GURU #0004 meaning that
        the move and rts instructions didn't exist any more, because of the
        UnLoadSeg, notwithstanding the Forbid. Almost solved (when loaded
        from CLI) in v1.41a where a jmp would replace the former
        jsr _LVOUnLoadSeg(a6), so the last executed rts is the one in ROM,
        and gone are the GURU #0004. A François Rouaix' idea. François
        Rouaix does more : he runs a Hot-Line on his BBS Sgt FLAM, where
        developers' difficult unanswered questions are routed to UseNet
        (thus giving access to an excellent level technical support, as
        Amiga engineers provide answers on UseNet). That's how he trapped
        the second bug : during initialization, I called Forbid(), followed
        by two calls to Permit(). The two functions are "nested", which
        means that Forbid() increments a counter that Permit() decrements,
        in such a way that the second call to Permit() made the call to
        Forbid() (just before calling UnLoadSeg() ) quite ineffective.
        Thank you François for all the good technical support you provide
        on your BBS Sgt FLAM.
      - 'Past to file' copies now the protection bits. It wasn't forgotten,
        it's just that it works the other way around what I have understood.
      - 'New Window' opens a window almost as high as the screen, in order
        to get a higher FileRequester.

v1.43 / 01-Sep-89
      -  CTRL-Up-Arrow marked the upper line as a block. It now marks the
        block from the start position.
      - While reading a file, the spaces at the end of the line are removed,
        avoiding the file to be considered as 'modified' as soon as the
        cursor would reach a line with spaces at the end. It's because AZ
        removes the spaces at the end of it's line-buffer, as soon as the
        cursor is moved, then compares the buffer with the original :
        -> 'modified'.


v1.50 / 06-Feb-90
      - IT'S BACK : Gauthier Groult's FileRequester, and even more user
        friendly. Gauthier has written a doc which, from now on, has to be
        distributed along with AZ and AZ.doc.
        AGAIN : the command line can be set with the -p option to get the
        FileRequester to show only the filenames matching the pattern.
        Like -p*.c to list only the files ending with '.c'. Default is '*'.
      - NEW : 'TOOLS/Execute Block' executes scripts written in AZ' window
        What's returned shows at the bottom of the same window.
        Warning : returns from commands like cd, path, alias,...is known
        by AZ only while the block is executing.
        Ex : this
            CD XXX
            DIR
        returns the content of XXX, while
            CD XXX
        and later
            DIR
        returns the content of SYS:
      - BUG : corrected.  AZ adds a '\0' if an odd number of characters is
        written into the ClipBoard. Thank you Dominique Lorre.
      - NEW : an improved management of the ClipBoard when reading : AZ
        can now paste text in its window that comes from Excellence! or
        TextCraft ... because it doesn't take IFF headers into account
        until CHRS. Not perfect yet, as IFF sequences embedded into text
        will still be considered as text. Anyway, it's better than it used
        to be and perfection will come later...
      - NEW : new windows initial position has been moved down and left.
      - NEW : option -a to switch the titlebar colors depending of the
        window being active or not.
      - NEW : 2 scroll gadgets in each direction. Much more comfortable !
      - NEW : after loading a file using the menu 'Project/Open', the
        current directory of the window becomes the FileRequester one,
        'CurrentDir' updates the 'Open' and 'Save as' FileRequesters.
      - NEW : starting AZ with a filename makes its path the current
        directory.
      - NEW : Gauthier's idea : AZ can now execute a command before opening
        its first window as well as after closing the last one. Option -e
        very useful.
      - NEW : 'block-word' mode; In fact, the mouse action is not standard
        anymore
        - 1 click :     cancels a block and moves the cursor
        - 2 clicks      select the word under the cursor and activate the
                        'block-word' mode
        - 3 clicks      select the line under the cursor and activate the
                        'block-line' mode
      - NEW : menu shortcuts can be accomplished using the left-Amiga key
        as well as the right-Amiga key, except for <left-Amiga><N> which
        is trapped by Intuition (WB to front).
      - NEW : the 'Edit/Select Word' menu option draws a block on the word
        under the cursor. It has a key shortcut along with 'Find/Find
        Selected' and 'Find/Exchange Selected'. Very handy to select a word,
        then find or exchange it:
        <left-Amiga><1>, <left-Amiga><2> or <left-Amiga><3>
      - If AZ fails to properly 'Open' a file, the previous content of the
        window is kept (no more implicit 'New' action).
      - NEW : with option -s, the 'Save As' menu option also modifies the
        title of the window (further 'Save' will use the new filename).
      - NEW : option -k for "keep backup". Before overwriting an existing
        file, AZ keeps a backup of this file in directory T:. Each AZ process
        has now a specific name, composed of "AZ-" followed by its address in
        hexadecimal. The T: directory will now grow with each new opened
        window, because each window is a separate task. You would rather use
        this option only when T: is assigned on a hard drive. When ending
        an AZ session, you can get rid of the backup files with
        "Delete T:AZ#?.bkp"
      - SHIFT+DEL does not copy an empty line in the UnDel buffer anymore,
        so that you can keep the previously deleted (non-empty) line.
      - NEW : option -o on the command line. Selects the character-inserting
        mode, Insert or Replace (Overwrite). This option also sets the default
        mode for child windows. A menu option 'Mode Ins/Repl' allows you to
        change the mode anytime, for a specific window.
      - NEW : option -r to set the indentation of a new line created with
        RETURN or ENTER. This indentation is relative to the last non-empty
        line.
      - NEW : option -i makes all string matching case insensitive by default
        in all windows. Menu option 'Case : Sensitive' changes this mode for
        a specific window. The text of the menu shows the current state of
        the mode, and then changes when the menu is selected.
      - Option 'UnDo' has been renamed 'UnDel Block' since it's not a real undo.
      - NEW : menu option 'Edit/Join Lines'. Appends the line below the current
        line to the current line. Keeps a space character if the cursor was in
        the middle of the line, or joins at the cursor position if the cursor
        is right of the end of the line.
      - NEW : option -l activates 'block-line' mode as soon as one draws a
        block. It is then impossible to draw blocks by character or by word.
      - NEW : option -x modifies the positionning of the cursor after a
        'Paste' or 'UnDel'. The cursor moves to the beginning of the inserted
        block instead of the end.
      - NEW : an 'iconify' gadget has been added in the title bar of windows,
        left to the 'change-size' gadget.
      - NEW : during a 'Copy' or a 'Paste', the active-pointer is replaced
        by the busy-pointer.
      - Removed: Page feed added by AZ. These did not suit some people, and
        besides, there are different utilities available to format text
        for printing.
      - NEW : 'Print Selected' and 'Send Selected' may now be interrupted
        by pressing ESC.
      - NEW : menu 'Match []{}()': if the cursor is on one of the 'open'
        characters, it moves to the corresponding 'close', and conversely.
      - NEW : pressing SHIFT + F8 changes the size of the active window (same
        action as the 'change-size' gadget).
      - NEW : option -m (for Minitel). When sending text through a minitel
        (to a BBS for example), the minitel sends characters at 75 bauds,
        although the Amiga sends them at 1200 bauds. Therefore, to avoid
        an overflow of the buffers of the minitel, option -m inserts a
        delay between each line so that the average rate of emission to
        the minitel is 75 bauds.

                           jmf