home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / bazy / amigadex / addendum.doc next >
Text File  |  1992-04-15  |  42KB  |  775 lines
  1.  
  2.  
  3.                              --------------------
  4.                               Amigadex Addendums
  5.                              --------------------
  6.  
  7.  
  8. Copyright © 1992 Ray Lambert
  9.  
  10.     This file contains information about new features that have been added to
  11. Amigadex since the original (and only) public release, version 1.0.  The
  12. items in this file are organized by the version that they first appeared in.
  13. This information is not contained in the main documentation.  For the next
  14. major release of Amigadex (coming sometime in 1992) the documentation will be
  15. completely re-written to include this information, as well as other new info.
  16.  
  17.     Note that the ONLY public release of Amigadex prior to 1.6 was Version
  18. 1.0.  The newer versions mentioned below were made available to registered
  19. users ONLY, with the exception of this latest release, Version 1.6.
  20.  
  21.     Amigadex is ShareWare.  Please read the legal notices and ShareWare
  22. information in the main documentation.
  23.  
  24.     Amigadex is ShareWare.  Please read the legal notices and ShareWare
  25. information in the main documentation.  (Am I repeating myself?)
  26.  
  27.  
  28.  
  29.  
  30.   -----------------------------------------------------------------------
  31.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  32.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  33.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  34.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  35.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  36.       Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5 Amigadex 1.5
  37.   -----------------------------------------------------------------------
  38.  
  39.     This was the first major update of Amigadex following the original
  40. version, 1.0, and was only available to registered users.  Being a major
  41. release, many new features were added...
  42.  
  43.  
  44. Import Mode
  45.  
  46.     Amigadex now includes an Import mode which will allow the user to insert
  47. information from other programs into their various card files.  The program
  48. where the information is coming from must have the ability to write to a
  49. standard ASCII text file.  Note that there are certain "tricks" to get
  50. programs which don't directly do this to do it anyway.  The most useful is
  51. the new "CMD" command included with AmigaDOS release 1.3.  CMD causes output
  52. normally intended for the "PRT:" Preferences printer device to instead be
  53. placed into a standard ASCII text file.  If the program you wish to import
  54. from does not support writing to text files, but does support writing to
  55. printers, you may use CMD to redirect its printer output to a file, which in
  56. turn can be edited (if necessary) and then imported into Amigadex.
  57.  
  58.     Amigadex's Import function is accessed via a menu item entitled: "Import
  59. Data".  Selection of this item will cause a new window to appear which is
  60. very similar to both the Printer Set-up and Config Windows.  The "Import
  61. Set-up Window", as it is called, contains a single string gadget for entering
  62. the name of the text file to import from, and a series of toggle gadgets in
  63. the left column.  These toggle gadgets are each associated with a field whose
  64. name appears beside it.  When one of these is toggled on, Amigadex will
  65. expect to find a line of text in the import file for that field.  Fields
  66. which are toggled off will always be left blank.  This rather flexible "field
  67. selection" mechanism allows you to configure the import operation to the data
  68. that you have available.  The "Import Set-up Window" also contains two card
  69. gadgets, "Okay" and "Cancel", which are used to (respectively) begin the
  70. import operation or cancel it and return to the main menu.
  71.  
  72.     For example, let's suppose that you wish to import some names and
  73. addresses from a database program which only has a name field and three
  74. address fields.  Remember that Amigadex is capable of storing a name field,
  75. four address fields, a phone number and a comment field; seven fields per
  76. card.  However, your data only has four fields per record.  In this scenario,
  77. you would turn on the name field and address fields one through three by
  78. clicking on their associated toggle gadgets.  You would also leave address
  79. field four, the phone number field and the comment field turned off.  Now
  80. Amigadex will expect four lines of text from the file for each card it
  81. imports, and the imported data will be placed into the name field and the
  82. first three address fields.
  83.  
  84.     Now, let's pretend that your database also has a phone number field, but
  85. it still has only three address fields.  In addition to what we did above,
  86. you would now turn the phone number field on, leaving address field four and
  87. the comment field off.  Amigadex will now expect five fields from your data
  88. for each card.  The first four lines it reads will be placed into the name
  89. field and address fields one through three.  The fifth line that it reads
  90. however, will be placed into the phone number field.  Address field four and
  91. the comment field will be left blank.
  92.  
  93.     To commence with your importing you must first generate a text file
  94. containing the information to be imported and edit that file if necessary.
  95. Note that you cannot have more than seven fields per card in Amigadex, and
  96. therefore, no more than seven lines per record in your import file.  Select
  97. "Import Data" from the Amigadex pull-down menus, configure the fields to
  98. import as described above, enter the name of the import file into the string
  99. gadget and click on the "Okay" card gadget.  If you have made an error in
  100. your setup, Amigadex will tell you and allow you to fix it or abort the whole
  101. operation, otherwise, the "Import Set-up Window" will go away and importing
  102. will begin.
  103.  
  104.     While importing, the card window will be set-up similar to the Browse and
  105. Normal Print modes.  Amigadex will read the first record from the import file
  106. into a temporary card and display it on the screen in the normal manner.
  107. Four card gadgets will be accessible offering the following options to
  108. manipulate the currently displayed temporary card:
  109.  
  110.       Add:  This option will save the currently displayed card in the current
  111.         card file; it "adds" it to the card file.  After adding the card the
  112.         next one will be read from the import file and displayed.  Note that
  113.         the number displayed as "Card Number" is an empty or new card in your
  114.         cardfile, and is the card number that will be assigned to the new
  115.         card when you add it.
  116.  
  117.       Next:  This option throws-out the currently displayed card and reads
  118.         the next one from the import file.  This allows you to filter out
  119.         records from the import file which you do not really want to import.
  120.  
  121.       Edit:  This option allows you to edit the currently displayed card in
  122.         "Edit Mode" as described above with one important difference: if you
  123.         select "File" (which has been changed to "Okay" in this release --
  124.         see below) the card is not saved.  A temporary card in Import Mode is
  125.         only added to the card file when you select "Add".  "Edit" is useful
  126.         if you wish to further edit the data before adding it to the card
  127.         file.
  128.  
  129.       Done:  Ends Import Mode and returns to the main menu.
  130.  
  131.     In addition to these options, the arrow gadgets which are found in the
  132. left border of the card window during Import Mode are available.  These are
  133. described in the main documentation in the section entitled "Browse Mode".
  134.  
  135.     As a last note on the new import feature, Import Mode is a perfect
  136. complement to Print Mode.  This combination makes it relatively easy to
  137. transfer cards from one card file to another.  To do this, run two copies of
  138. Amigadex setting the first to use the source card file and the second to use
  139. the destination card file.  Using the first, enter Print Mode and print the
  140. cards you wish to transfer to a temporary file (for example, "RAM:TEMP").
  141. Next, using the second copy of Amigadex, enter Import Mode and use it to
  142. import from the temporary file which you just printed to.  When printing, set
  143. the "Media Height" variable to the number of fields you have selected to
  144. print, then, when importing, configure the import fields exactly the same as
  145. the Print Flags were when you printed.  Note that you can also do this with
  146. only one copy of Amigadex by switching back and forth between card files and
  147. the Print and Import Modes.
  148.  
  149.  
  150. Gadget Label Changes
  151.  
  152.     When in Edit Mode, two card gadgets are available which allow the user to
  153. either accept the new input or to cancel it.  In Version 1.0, these two
  154. gadgets where labeled with "File" ("okay, save the new input") and "Toss"
  155. ("naw, toss these changes").  In Version 1.5, the labels on these two gadgets
  156. have been changed.  They now say "Okay" ("okay, accept the new input") and
  157. "Cancel" ("naw, toss these changes").  The main reason for this change is
  158. that, in this new release, selecting "Okay" (formally "File") does not always
  159. save the new input to the card file.  Edit Mode from within "Add" and "Browse
  160. Mode-Edit" will save the data upon selecting "Okay", as always.  However,
  161. Edit Mode from within Import Mode will NOT save the changes upon selecting
  162. "Okay".  Selecting "Okay" from "Import Mode-Edit" will simply return you to
  163. the Import menu.  This is because the card data which gets edited in Import
  164. Mode is really in a "temporary" card -- the card does not actually exist in
  165. the card file yet.  To save the changes you make here, you must select "Okay"
  166. to exit Edit Mode, then "Add" to save the displayed temporary card into your
  167. card file.
  168.  
  169.     In Browse Mode, the gadget which was formerly labeled "Last" has been
  170. changed to "Prev" (short for "previous"), which should avoid some confusion
  171. about this gadget's function.
  172.  
  173.  
  174. Keyboard Shortcuts For Gadgets
  175.  
  176.     Nearly all of the gadgets found in Amigadex can now be accessed through
  177. keyboard shortcuts.  The goal of this modification was to allow Amigadex to
  178. be operated completely from the keyboard without any mouse input at all.
  179. This goal has been realized.  Only system gadgets such as the Depth and Drag
  180. gadgets have no keyboard equivalents.  Most of the keyboard shortcuts use the
  181. CTRL key (qualifier) in conjunction with some other key, and some work
  182. without any qualifier at all.  Most of the keys used are obvious.  Here are
  183. the rules and exceptions for determining the proper keyboard shortcuts:
  184.  
  185.       (1) All card gadgets are activated with CTRL plus the first letter of 
  186.         the label on the gadget.  For instance, from the main menu, the "Add"
  187.         gadget is activated with CTRL+A, the "Browse" gadget is activated
  188.         with CTRL+B, the "Print" gadget is activated with CTRL+P, and the
  189.         "Config" gadget is activated with CTRL+C.  There is only one
  190.         exception to this rule: any card gadget which is labeled with "Done"
  191.         or "Quit" is activated with the Esc key.  In windows which do not
  192.         contain any string gadgets (where text may be entered) the CTRL key
  193.         qualifier may be left off.  For instance, the main menu does not
  194.         contain any string gadgets and therefore the gadgets there can be
  195.         selected simply by pressing the first letter of each gadget label.
  196.         "Browse" can be selected by pressing "B", "Print" can be selected by
  197.         pressing "P", etc.
  198.  
  199.       (2) In the Config Window, the Print Set-up Window and the Import Set-up
  200.         Window, the seven toggle gadgets which are stacked in the left column
  201.         may be toggled (activated) by pressing CTRL+1 through CTRL+7.  CTRL+1
  202.         corresponds to the "Name" field toggle gadget, CTRL+2 corresponds to
  203.         the "Address 1" field toggle gadget, CTRL+3 corresponds to the
  204.         "Address 2" field toggle gadget, etc.
  205.  
  206.       (3) In Edit Mode, the seven string gadgets which are used to enter/edit
  207.         the seven fields of a card can be activated with CTRL+1 through
  208.         CTRL+7 -- similar to the toggle gadgets as described in rule #2.
  209.         Note that activation of a string gadget causes it to be selected as
  210.         the active string gadget, meaning that the text cursor is position
  211.         within it so you may type into it.
  212.  
  213.       (4) Most other gadgets are activated by pressing CTRL plus the first
  214.         letter of the label which is associated with the gadget, except where
  215.         that keypress interferes with a previous rule.  Whenever this
  216.         exception occurs, the first letter in the second word of the label is
  217.         used.  For example, in the Print Set-up Window, the "Card Number"
  218.         string gadget is activated with CTRL+C, the "Search String" gadget is
  219.         activated with CTRL+S, the "Height" gadget is activated with CTRL+H,
  220.         and the "Width" gadget is activated with CTRL+W.  However, the
  221.         "Output Device" string gadget is activated with CTRL+D ("Device")
  222.         because the use of CTRL+O ("Output") would interfere with CTRL+O as
  223.         is used for the "Okay" card gadget.  Likewise, the "Continuous Mode"
  224.         toggle gadget is activated with CTRL+M ("Mode") because CTRL+C
  225.         ("Continuous") would interfere with the use of CTRL+C for the "Card
  226.         Number" string gadget.
  227.  
  228.       (5) The following list contains gadgets whose keyboard shortcuts could
  229.         not be determined by any of the above rules:
  230.  
  231.           - The invisible "New Card Number" gadget which is available in both
  232.             Browse Mode and Normal Print Mode is activated with CTRL+C, or,
  233.             in accordance with rule #1, just "C".
  234.  
  235.           - The arrow gadgets which are available in Browse Mode, Normal
  236.             Print Mode and Import Mode are activated with "," and ".".  Note
  237.             that these two characters are on the same keys as the "<" and ">"
  238.             characters.  If you think of the "lesser than" and "greater than"
  239.             characters as arrows, you should easily remember this.  The
  240.             direction in which the "lesser than" and "greater than" char-
  241.             acters point corresponds to the arrow gadget that they activate,
  242.             and, therefore, the direction in which the text will be scrolled.
  243.             Also note that these short cut keys should be pressed in-
  244.             dependently from any other keys; that is to say that you do not
  245.             need to press the CTRL key in combination with these.
  246.  
  247.           - The "Iconify" gadget from the main menu is activated with CTRL+I,
  248.              or, in accordance with rule #1, just "I".
  249.  
  250.            - The Amigadex Icon which appears after you "Iconify" Amigadex
  251.             also has a keyboard shortcut.  To bring Amigadex back after
  252.             "Iconifying" simply press CTRL+LeftAlt+A.  This combination of
  253.             three keys works as a "hot key" which brings Amigadex back at any
  254.             time no matter what program you are working in.  If the Workbench
  255.             screen is not the foremost screen at the time you press this "hot
  256.             key," it will be brought to the front and activated for you.
  257.  
  258.           - The "Next" and "Prev" gadgets in various modes will respond to
  259.             the cursor keys.  Cursor right and down correspond to "Next"
  260.             while cursor left and up correspond to "Prev".  In addition,
  261.             cursor left and right may be used in "Quick Scan Mode" (see
  262.             below).
  263.  
  264.     One additional new keyboard feature that should be mentioned here is
  265. this: in any Amigadex Window which contains more than one string gadget, the
  266. cursor up and cursor down keys will move the cursor from the currently
  267. activated string gadget to the next (cursor down) or the previous (cursor
  268. up).  This capability is especially useful in Edit Mode where you can now
  269. cursor through all the fields of a card and you never have to touch the
  270. mouse.  It is also quite helpful in the Print Set-up Window which contains
  271. five different string gadgets which may all have to be updated for certain
  272. printing jobs.  Also note that the TAB key corresponds to the cursor down key
  273. and SHIFT+TAB corresponds to the cursor up key.  Also, the RETURN key stills
  274. works as in Version 1.0 -- its function corresponds to that of the cursor
  275. down key.  When you press any of these keys (excluding the RETURN key), if no
  276. string gadgets are currently activated, either the first one in the window or
  277. the last one will become activated -- depending on the function of the key
  278. you press.  This means that you no longer have to use the mouse to make the
  279. cursor reappear should it disappear for any reason.
  280.  
  281.  
  282. More on the Amigadex Icon
  283.  
  284.     Besides the "hoy key" capability described above, the Amigadex Icon has a
  285. few other new features.  First, when the Icon is placed on the screen, it
  286. will be placed underneath all other Intuition windows.  The icon is actually
  287. a small Intuition window itself so it can be positioned above or below other
  288. windows on the screen.  Placing it below all other windows makes it act more
  289. like a Workbench icon and seems to be preferred.
  290.  
  291.     The initial positioning of the icon has been improved.  The default
  292. starting location for the icon is now calculated based on the size of your
  293. Workbench screen and is placed in the lower-most, right-hand corner of the
  294. screen.  Note that if you are using a utility such as Vscreen (Virtual
  295. Screen) the default position of the icon may actually be off of the currently
  296. visible portion of the screen.  Moving your pointer to the lower-most,
  297. right-hand corner of the screen will reveal the Icon's position.  You can
  298. then drag it to wherever you like and it will remain there for the remainder
  299. of your Amigadex session.  Version 1.0 always placed the icon at the same
  300. location on the screen (upper right corner).  The user was allowed to drag it
  301. elsewhere, however, if the user double-clicked on the icon to bring Amigadex
  302. back, and then Iconified again, the icon would not be placed back where the
  303. user had last positioned it.  This is no longer true; the location of the
  304. icon is "sticky" -- it is remembered by Amigadex so that it will return to
  305. the same location where the user last positioned it.  Of course, Amigadex
  306. only remembers the icon's location until you press the "Quit" gadget or turn
  307. your computer off.
  308.  
  309.     A change was made to the box which appears when you drag the Icon.  I
  310. suppose it's a little gaudy, but hey!  Why not??  (You'll have to see it to
  311. know what I mean :)
  312.  
  313.     Another enhancement causes Amigadex to perform a LockLayers() before
  314. writing the icon's drag box into the Workbench screen's RastPort.  Doing this
  315. prohibits other programs from writing into the RastPort at the same time,
  316. thereby avoiding the possibility of placing garbage on the screen.  It was
  317. not possible to do this before because of various conflicts with Intuition.
  318. Basically, the icon code was relying on Intuition for input events and at
  319. certain times Intuition would attempt to lock the layers itself.  Since
  320. Amigadex already had the layers locked, Intuition's call to LockLayers()
  321. caused it to be placed into Exec's Waiting task queue.  So Intuition would be
  322. sleeping, waiting for Amigadex to unlock the layers, and Amigadex would be
  323. sleeping, waiting for Intuition to send it events.  A reset was the only way
  324. to end this deadlock.  To get around this problem Amigadex now uses its
  325. custom input handler to get mouse events, rather than relying on Intuition.
  326.  
  327.     One last feature that was added to the icon enables the right-mouse
  328. button as a cancel when dragging the icon.  This particular combination of
  329. mouse button presses is also used by another popular ShareWare program called
  330. "DMouse".  A conflict will arise between DMouse and the Amigadex icon if this
  331. combination of mouse clicks occurs while dragging the Amigadex icon around
  332. the screen, AND DMouse's handler priority is set above Amigadex's, which is
  333. now set at 60.  Version 1.10 of DMouse sets its handler priority at 51.  It
  334. is extremely important to note that if you set DMouse's handler priority at
  335. or above 60 while using Amigadex in iconified mode that a deadlock may
  336. result!  I know of no reason that you would _need_ to do this, but beware if
  337. you do...
  338.  
  339.  
  340. Undelete
  341.  
  342.     If you accidently delete a card from your card file you can now attempt
  343. to get it back with the "Undelete" routine.  The current version of Undelete
  344. is fairly simple and requires that you know the number of the card in order
  345. to undelete it.  Any deleted card is recoverable unless a new card has
  346. written over it.  The Undelete function is accessed through a pull-down menu
  347. available from Amigadex's main menu.  Note that the Quick-Scan Mode
  348. (described below) may be most useful for locating deleted cards.
  349.  
  350.  
  351. Using Multiple Card Files
  352.  
  353.     It has always been possible to maintain multiple card files with
  354. Amigadex, however, it has come to my attention that this was not very
  355. obvious.  The card file name which you specify to Amigadex when you start it
  356. up (either on the CLI command line, in the Amigadex.Config file or from
  357. within Amigadex's Workbench icon) is only your default STARTUP card file.
  358. You are not locked into using this file and this file only.  To change the
  359. card file you are working with, simply click on the "Config" gadget from the
  360. main menu to enter the Config Window, type a new card file name into the
  361. "Card File" string gadget, and click on "Use".  Amigadex will not try to
  362. create an "Amigadex.Config" file when you do this, but it will begin using
  363. the new card file that you specified.  If Amigadex cannot access the new card
  364. file for any reason, including because it does not exist yet, Amigadex will
  365. ask you if you wish to create the file (this is how to create new card
  366. files), or correct the name and try again.
  367.  
  368.     Version 1.5 has a couple new features to simplify this procedure.  When
  369. you first start Amigadex Version 1.0, it displays a requester informing you
  370. of what card file it is currently set up to use.  In Version 1.5, the
  371. requester has been changed so that it now asks you if you wish to begin with
  372. the default card file.  Clicking on the "Yes" gadget in this requester will
  373. cause Amigadex to proceed as normal.  However, clicking on the "No" gadget
  374. will cause another requester to appear which allows you to enter the name of
  375. another card file to use.  This is useful because you may have your default
  376. card file identified in Amigadex's Workbench icon or in an Amigadex.Config
  377. file.  If you are working with multiple card files, you may at one time or
  378. another wish to start with a card file other than the default.  This new
  379. feature will allow you change the default card file easily without modifying
  380. the Workbench icon or the "Amigadex.Config" file, or entering the Config
  381. Window.
  382.  
  383.     In addition, a new item has been added to the pull-down menu which is
  384. available at Amigadex's main menu.  It is labeled "New File".  Selecting it
  385. will cause a file requester to appear allowing you to enter the name of the
  386. new card file to use.
  387.  
  388.  
  389. The ARP File Requester
  390.  
  391.     Version 1.5 now supports the ARP File Requester if "arp.library" is
  392. available when Amigadex is first run.  "arp.library" should have been
  393. included with Amigadex.  If not, ask around.  ARP is available from many
  394. places such as public bulletin board systems and the ARP Authors themselves
  395. (See "About ARP" below for more information about ARP).  If you are working
  396. with multiple card files, the ARP File Requester will make switching between
  397. them much less painful.
  398.  
  399.  
  400. Adding multiple new cards
  401.  
  402.     If you have more than one new cards to add to a card file all at one
  403. time, a new feature to the "Add" routine will help speed things along.  After
  404. the addition of a new card, rather than returning to the main menu such as
  405. Version 1.0 does, a requester will appear asking if you wish to add another
  406. card.  Selecting "No" will send you back to the main menu as before, but
  407. selecting "Yes" will cause Amigadex to attempt to add a new card to the file
  408. immediately.  The time savings involved here comes from the fact that
  409. Amigadex has to search through the card file for an empty record every time
  410. you click on the "Add" gadget.  This search always starts at the beginning of
  411. the card file (Card #1).  With a large card file on floppy disk this can be a
  412. little time consuming.  The time it takes to perform the search is not too
  413. bad if you're only adding one or two cards, but if you have ten or twenty or
  414. even more to add, sitting through this search for each one can become a bit
  415. annoying.  Copying your card file to "RAM:" or "RAD:" can help significantly,
  416. but this is also dangerous in case another program decides to GURU, or if you
  417. simply forget to copy the updated file back to floppy disk and then turn your
  418. computer off (ouch!).  The new feature will cause Amigadex to begin all
  419. subsequent searches where it last left off thereby avoiding this annoying
  420. delay between each new card you add.
  421.  
  422.  
  423. Imagery
  424.  
  425.     Some of the custom imagery in Amigadex has been re-worked a little and
  426. cleaned up.  Notice the slightly different imagery used for the card gadgets.
  427.  
  428.  
  429. About
  430.  
  431.     The About pull-down menu item has been changed slightly.  Rather than
  432. opening a special window, which constituted considerable overhead both in
  433. program size and in memory used at run-time, the Author information will be
  434. presented right on the card window as tough it were a card in some card file.
  435. Try it!  :^)
  436.  
  437.  
  438. Custom Mouse Pointer
  439.  
  440.     Amigadex's windows now have a custom mouse pointer.  The main reason for
  441. this is to aid in determining if the Amigadex window is active or not.
  442. Normally a user can distinguish this by checking if a window's title bar is
  443. "ghosted" or not.  This does not work for Amigadex however, because
  444. Amigadex's window does not have a normal title bar, and it never becomes
  445. ghosted.  The Amigadex window looks the same whether it is active or not.
  446. With the addition of the custom mouse pointer, whenever Amigadex's window is
  447. active its custom mouse pointer will be visible.  When it is not active, the
  448. user's normal mouse pointer will be visible.
  449.  
  450.  
  451. Support for Project Icons
  452.  
  453.     Amigadex data files may now have project type Workbench icons.  If set-up
  454. properly (default tool etc.) double clicking on a project icon from Workbench
  455. will start Amigadex using the card file associated with the project icon.  In
  456. addition, when Amigadex creates a new card file, it will give the user the
  457. option to create a project icon for the new card file.  Amigadex has a
  458. default icon compiled into its executable file and will write a copy of it to
  459. disk using the same name as the new card file (plus the ".info" file
  460. extension of course).  Amigadex will also allow the user to edit the default
  461. tool for the new icon before it is written to disk.  Amigadex will make its
  462. best guess as to what the default tool should be.
  463.  
  464.  
  465. Quick Scan Mode
  466.  
  467.     QSM is accessed from the pull-down menu at Amigadex's main menu.  It uses
  468. a slider and two arrow gadgets to allow the user to quickly scan through a
  469. card file.  The search string capability of Amigadex is bypassed in this
  470. mode.  All cards (including deleted ones) may be displayed, however no
  471. editing, deleting or printing may be performed from this mode -- it is a
  472. view-only mode.  Deleted cards only show the word "Deleted" in the data
  473. window.  Full keyboard operation has been implemented in QSM, keeping it
  474. consistant with the rest of the program.
  475.  
  476.  
  477. Context-sensitive Help
  478.  
  479.     Help is offered on a variety of subjects specific to Amigadex and in
  480. particular to the gadgets and menus found in various windows.  Help is
  481. context-sensitive when accessed with the HELP key on the keyboard, and may be
  482. accessed from virtually anywhere at virtually anytime.  In addition, Help can
  483. be accessed from the pull-down menu in Amigadex's main menu window.  Once in
  484. Help, help text is displayed in a scrollable window.  Help is separated into
  485. "chapters", each specific to a particular portion of Amigadex, including
  486. "Help on Help".  The chapter which gets displayed first when entering Help
  487. mode depends on what section of Amigadex the user is in when he/she presses
  488. HELP.  A "Help Index" is also available once in Help mode which allows the
  489. user to access any or all of the "Help chapters".  The "Help Index" is
  490. implemented through an Intuition pull-down menu.  Full keyboard operation has
  491. been implemented in Help mode, keeping it consistent with the rest of the
  492. program.  Cursor up and down may be used to scroll text in the Help window
  493. and ESC may be used to exit help.  For more information about Help, see "Help
  494. on Help" available from the index in Help Mode.
  495.  
  496.  
  497. About ARP
  498.  
  499.     ARP (the AmigaDOS Replacement Project) is a set of AmigaDOS commands
  500. which have been developed by a group of ShareWare authors to replace those
  501. currently included with AmigaDOS.  Among these commands are DIR, COPY, LIST,
  502. TYPE, etc., etc.  If you never use the CLI then you may not be familiar with
  503. these.  The ARP commands provide more features, a common interface, small
  504. code size and fast execution.
  505.  
  506.     Central to the development of ARP is the "arp.library".  The library
  507. consists of a collection of small programs (or functions) which do specific
  508. tasks.  Specially written programs can make use of these functions.  The
  509. functions contained in the library do not have to be included in each program
  510. that uses them, making the size of these programs smaller.  This concept also
  511. makes the programs that use it more consistent as they are all doing specific
  512. tasks in the same manner through the use of the same functions.
  513.  
  514.     One example of a function from "arp.library" is the ARP File Requester.
  515. This is an excellent file requester which is very powerful for both the
  516. programmer and the user.  Those of you who currently use TxEd Plus by
  517. Microsmiths will already be familiar with it.  The ARP file requester was
  518. written by Charlie Heath.
  519.  
  520.     ARP is user-supported software (a close relative to ShareWare) and can be
  521. obtained on most large BBS systems or from the Arp Authors themselves.
  522. "arp.library" is Copyright 1987, 1988 by Arp Authors.  It is freely
  523. redistributable on diskette and BBSs.  Modules in "arp.library" may not be
  524. extracted for use in independent code.  You may contact the Arp Authors at
  525. this address:
  526.  
  527.           Arp Support
  528.           c/o Microsmiths, Inc
  529.           PO Box 561
  530.           Cambridge, MA 02140
  531.  
  532.     Amigadex will make use of the ARP File Requester if "arp.library" is
  533. available when Amigadex is run.  For those of you who do not use ARP
  534. currently, "arp.library" version 39.1, from ARP release 1.3, should have been
  535. included with Amigadex.  Please note that you do not have to place the full
  536. ARP command set on your disks to allow Amigadex to use ARP.  You only need to
  537. place "arp.library" in your system's "LIBS:" directory, nothing else.
  538.  
  539.  
  540.  
  541.  
  542.   -----------------------------------------------------------------------
  543.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  544.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  545.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  546.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  547.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  548.    Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51 Amigadex 1.51
  549.   -----------------------------------------------------------------------
  550.  
  551.     The following new features were added to Amigadex Version 1.51...
  552.  
  553.  
  554.     All string gadgets in Amigadex 1.51 support a cut and paste feature.  The
  555. following keystrokes are used by this feature:
  556.  
  557.     Alt-C  : Copy
  558.     Alt-X  : Cut
  559.     Alt-I  : Insert (paste)
  560.  
  561.     Amigadex 1.51 maintains a private internal clipboard which is capable of
  562. holding one line of text from any string gadget used by the program.  This
  563. clipboard is used by the copy, cut and paste commands in specific ways.  The
  564. commands work as follows:
  565.  
  566.     The "copy" command copies the entire contents of the currently active
  567. string gadget (the one in which the cursor is) to the clipboard without
  568. altering the contents of the string gadget it copies from.
  569.  
  570.     The "cut" command performs the same operation as "copy" except that it
  571. also erases the entire contents of the string gadget that it copies from.
  572.  
  573.     The "paste" command inserts the current contents of the clipboard into
  574. the currently active string gadget at the position of the cursor.  If you
  575. wish to completely replace the contents of the target string gadget you must
  576. first use the Right-Amiga-X command, which deletes the entire contents of the
  577. active string gadget, and then use the "paste" command.  (The Right-Amiga-X
  578. command should not be confused with the "cut" command -- Right-Amiga-X does
  579. not alter the Amigadex clipboard.)
  580.  
  581.  
  582.     Limitations:  The current version of this feature has a couple of
  583. limitations...
  584.  
  585.         - String gadgets which accept only numbers (known as "integer
  586.     gadgets") will not accept input from the paste command.  Or, to put it
  587.     differently, the "paste" command does not function on integer gadgets.
  588.     ("Copy" and "cut" do function normally on integer gadgets however).  The
  589.     reason for this limitation is the lack of a numeric filter on the paste
  590.     command.  This may be implemented in a future version.  On the other
  591.     hand, it does not seem that pasting into integer gadgets would be
  592.     altogether useful anyway, so this limitation may never be removed.
  593.  
  594.       - The second limitation is not really a limitation of the cut/paste
  595.     feature, but rather a rule of string gadgets which must be adhered to.
  596.     Each string gadget has a maximum number of characters that it can hold.
  597.     If a paste operation would result in this limit being surpassed, only the
  598.     number of characters from the clipboard which can fit in the string
  599.     gadget without overflowing it will be pasted.
  600.  
  601.  
  602.     Notes:  The main use behind the cut/paste feature is to move card
  603. data-field contents from one field to another, or from one card to another.
  604. For example, if you need to insert a line in the address portion of a card
  605. which is already filled-in, you can use cut and paste to move the fields that
  606. you need to move in order to insert the line.  Previously, you were forced to
  607. re-type any lines which needed to be moved.  Here is an example:
  608.  
  609.     Imagine that a card contains the following address fields:
  610.  
  611.     Name    : Fred Derf
  612.     Address1: 123 Foo Road
  613.     Address2: SomeTown, SomeState, 01234
  614.     Address3:
  615.     Address4:
  616.  
  617.     And now you would like to insert "c/o Fred's Company" at "Address1", as
  618.     such:
  619.  
  620.     Name    : Fred Derf
  621.     Address1: c/o Fred's Company
  622.     Address2: 123 Foo Road
  623.     Address3: SomeTown, SomeState, 01234
  624.     Address4:
  625.  
  626.     Before cut/paste you would have had to re-type "Address2" into
  627.     "Address3", delete the contents of "Address2", re-type "Address1" into
  628.     "Address2", delete the contents of "Address1", and finally type the new
  629.     line into "Address1".
  630.  
  631.     I thought that this was too much work...
  632.  
  633.     So now you can use cut/paste in the following manner:
  634.  
  635.         cut "Address2", paste into "Address3", cut "Address1", paste into
  636.         "Address2", type the new line into "Address1".
  637.  
  638.     This is quite a bit more convenient as all re-typing has been eliminated.
  639.  
  640.  
  641.  
  642.  
  643.   -----------------------------------------------------------------------
  644.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  645.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  646.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  647.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  648.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  649.    Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52 Amigadex 1.52
  650.   -----------------------------------------------------------------------
  651.  
  652.     No new features were added for this update.  Some internal changes were
  653. made, and some of the messages that Amigadex displays were changed slightly.
  654.  
  655.  
  656.  
  657.  
  658.   -----------------------------------------------------------------------
  659.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  660.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  661.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  662.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  663.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  664.    Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53 Amigadex 1.53
  665.   -----------------------------------------------------------------------
  666.  
  667.     This update was meant to fix a few minor bugs that appeared with
  668. Kickstart 2.0.  Some new features were also added:
  669.  
  670.     - Keyboard shortcuts now work properly under AmigaDOS 2.0 when using a
  671.       virtual (large, scrollable) Workbench screen.
  672.  
  673.     - 'Add' function will no longer ask if you wish to enter another card
  674.       after you have selected 'Cancel'.
  675.  
  676.     - Author's phone number updated in 'About' display.
  677.  
  678.     - All windows are now properly centered in visible area of virtual
  679.       screens under all OS versions.
  680.  
  681.     - New 3d imagery for 'card buttons' added.
  682.  
  683.  
  684.  
  685.  
  686.   -----------------------------------------------------------------------
  687.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  688.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  689.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  690.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  691.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  692.       Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6 Amigadex 1.6
  693.   -----------------------------------------------------------------------
  694.  
  695.     This update added a few new features for Kickstart 2.0 users, and fixed a
  696. few minor 'annoyances'.  This is also the 2nd OFFICIAL public release.
  697.  
  698.     - Under AmigaDOS 2.0, the ASL file requester will now be used rather
  699.       than ARP.
  700.  
  701.     - Under AmigaDOS 2.0, there is now only 1 depth gadget, in keeping with
  702.       the new window rules.  The other depth gadget didn't behave properly
  703.       under 2.0 anyway.
  704.  
  705.     - Amigadex help text has now been placed into an external file, called
  706.       "Amigadex.Help", reducing the size of the Amigadex executable by 30k.
  707.       Amigadex looks for the help data file in three places (and checks in
  708.       this order): 1) the current directory, 2) the "Amigadex:" logical
  709.       directory, 3) the "S:" logical directory.  Note that the current
  710.       directory can actually be one of two possible places, depending on how
  711.       Amigadex was run: A) if run from the CLI, the help file must be in the
  712.       current directory at the time Amigadex was run; B) if run from
  713.       Workbench, the help file must be in the same directory as the Amigadex
  714.       icon.  If Amigadex cannot find the help file, context-sensitive help
  715.       will not be available, and Amigadex will inform you of this when the
  716.       'Help' key is pressed.  Amigadex does not attempt to load the help
  717.       file until 'Help' is pressed, thereby saving memory.  When 'Help' is
  718.       pressed, Amigadex loads the whole file into memory (if there is
  719.       enough) and keeps it there in case the user needs more help later in
  720.       the session.  Amigadex will look for the help file each time the
  721.       'Help' key is pressed if it has not yet loaded, thereby allowing the
  722.       user to modify the environment so that Amigadex CAN find the help
  723.       file after an initial failure.
  724.  
  725.     - Under AmigaDOS 2.0, the old iconify routine is replaced by a Workbench
  726.       'AppIcon'.  It is similar to the old iconify routine except Workbench
  727.       now chooses the initial position for the icon, and the icon behaves
  728.       in general more like a Workbench icon (because, of course, it is!).
  729.       Also, Workbench refuses to tell Amigadex where the user left the icon
  730.       so the icon's position can no longer be 'sticky'.  This 'AppIcon'
  731.       supports double-clicking only.
  732.  
  733.     - Amigadex now features a 'sleep' pointer to indicate which of its
  734.       windows are inactive when more than one window is open.  The 'sleep'
  735.       pointer is a copy of the Workbench 2.0 'sleep' pointer which resembles
  736.       a stopwatch (even under WB 1.3).
  737.  
  738.     - Amigadex will now use the default font for windows and menus, but ONLY
  739.       IF that font is 8 by 8 pixels and non-proportional.  Otherwise Amigadex
  740.       will use topaz-8.
  741.  
  742.  
  743.  
  744.  
  745.   -----------------------------------------------------------------------
  746.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  747.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  748.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  749.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  750.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  751.    Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61 Amigadex 1.61
  752.   -----------------------------------------------------------------------
  753.  
  754.     This update fixes a few bugs that were found in version 1.6.
  755.  
  756.     - Fixed bug which caused the 'sleep pointer' to be active during print
  757.       mode, import mode and while initializing a new cardfile.
  758.  
  759.     - Fixed broken 'Save' button on Config screen which failed only under
  760.       Kickstart 2.0.
  761.  
  762.     - Fixed bug which caused Amigadex to fail to write the user-supplied
  763.       default tool with an icon that was created for a new cardfile.
  764.  
  765.     - The icon that Amigadex creates for a new cardfile was 'Snapshotted'
  766.       when it should not have been.  Fixed.
  767.  
  768.     - Fixed bug in hot-key code under Kickstat 1.3 and added hot-key support
  769.       for iconify mode under Kickstart 2.0.  Amigadex Version 1.6 did not
  770.       support the LeftAlt+Ctrl+A hot-key to bring Amigadex back from iconify
  771.       mode under Kickstart 2.0.  1.61 now does.
  772.  
  773.     - Fixed a bug which caused Enforcer hits when attempting to cursor beyond
  774.       the last string gadget on a screen.
  775.