home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Fred Fish Collection 1.5
/
ffcollection-1-5-1992-11.iso
/
ff_disks
/
300-399
/
ff346.lzh
/
Az
/
AZ_English
/
Manual
/
History
< prev
next >
Wrap
Text File
|
1990-04-15
|
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 : +33 (1) 39 55 84 59 (V23 Videotex)
* || MAIL : c/o Alain DIDIERJEAN 69 rue Dunois
* || 75646 Paris cedex 13 FRANCE
* «====» INTERNET: rouaix@inria.inria.fr or groult@ibp.fr
*==========================================================================
*/
==========================================================================
|| ||
|| 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