home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / dfa122.lha / Documentation / dfa_english.doc next >
Text File  |  1993-04-23  |  75KB  |  2,283 lines
  1. DFA(ddress), the Address utility for the Amiga and OS 2.0
  2.  
  3.    Copyright (C) 1992, 1993 Dirk Federlein
  4.  
  5.    GUI created using Gadtoolsbox (C) 1992 Jan van den Baard.
  6.  
  7.    AREXX interface created using Arexxbox (C) 1992 Michael Balzer.
  8.  
  9.    Registered trademarks are *not* marked separately.  Therefore the
  10. missing of it doesn't mean that they are free.
  11.  
  12.  
  13. DFA
  14. ****
  15.  
  16. This manual describes the installation and usage of `DFA' V1.2. Here
  17. you'll find the explanation of all the AREXX commands as well. If you
  18. use a localized Workbench (Workbench V2.1 and better) and have set it
  19. to a language other than English, please notice that I'll refer to the
  20. English program texts in this documentation!
  21.  
  22.  
  23. General
  24. ********
  25.  
  26.  
  27. Copyright
  28. ==========
  29.  
  30. `DFAddress' (`DFA' for short) is *shareware*!  You may copy and
  31. distribute verbatim copies of the program's executable code as you
  32. receive it.  You must not give away your keyfile or copy it (except for
  33. your own use!).  I keep the copyright over the whole package!  You may
  34. not sell this programm for more money than to cover just the costs of
  35. copying!  In any case you may not charge more than Fred Fish claims for
  36. one of his "Library Disks"!  Besides the program itself, the
  37. documentation and all add--ons are also copyrighted by myself.
  38.  
  39. You may distribute only the whole (shareware)package!  You may not
  40. change  anything without my written permission.  Using crunchers on it
  41. is permitted.
  42.  
  43.  
  44. Warranty
  45. =========
  46.  
  47. I can and will not be held responsible for any damages which are caused
  48. directly or indirectly by `DFA'.  I don't guaranty that `DFA' works in
  49. the expected way.  If you find any bugs I please you to send me a bug
  50. report.  *Note Bug Reports::.
  51.  
  52.  
  53. What the hell is DFA?
  54. ======================
  55.  
  56. `DFA' is *not* just another address programm.  You can look up the
  57. addresses quite fast; support for email addresses is given as well. Of
  58. course - there are already some similar pieces of software which do
  59. nearly the same - well *nearly*!
  60.  
  61. `DFA' was programmed under version 2.0 of the latest *AMIGA* operation
  62. system!  This means you need *OS2.0* to use the programm.  If you only
  63. have OS1.3 (or below) you won't get anything but a message, saying that
  64. the needed system libraries (version 37 and up) could not be opened --
  65. sorry.  All I can say to users, which don't use OS2.0 up to now is: 
  66. Upgrade at once!
  67.  
  68. `DFA'  is  using  OS2.0.  This implements that you can use all the  new
  69. features that the *AMIGA* is supporting now.  You not only get an
  70. application icon, the typical 2.0 look and feel but better, you can do
  71. all operations with the keyboard!  `DFA' is a commodity, so you can pop
  72. it up by holding down the "hotkey".  Since Version V1.1 `DFA' offers an
  73. AREXX Port, which means that you can direct `DFA' from within other
  74. programms.  Coming with version 1.2 there is LOCALE-Support as well. 
  75. Notice that you *need* *AMIGA*OS V2.1 or V3.0 (or even better) to take
  76. advantage of this feature.  If you are still using V2.0x, `DFA' takes
  77. the english texts.
  78.  
  79. The best idea is to copy `DFA' to the `WBStartup'-drawer, for you can
  80. use it at once after startup.
  81.  
  82.  
  83. History
  84. ========
  85.  
  86. In Spring of 1992 I was looking for an address utility, which took
  87. advantage of the new features of OS2.0, but I didn't find one!  So I
  88. began to program one by myself.  The complementation of `DFA' took more
  89. time than I expected, because I'm first a student and second a
  90. programmer. Moreover I often found possibilities to improve `DFA',
  91. which sometimes lead to a complete rewriting of large parts of the
  92. code.  This took place for example when a friend of mine convinced me
  93. that `DFA' should be fontsensitive (thanks Kai!).
  94.  
  95. When the program was "finished", I decided to make it "shareware", so
  96. it should not disappear in a drawer like so many other things I had
  97. programmed before.  This decision made it necessary to put even more
  98. time in this project, because a manual had to be written.  This manual
  99. was written using TeX; the ASCII manual was done using DVI2TTY.
  100.  
  101. A few bugfixes later it became clear that `DFA' should get some
  102. significant improvements, e.g. additional address fields, an AREXX
  103. Port, ...
  104.  
  105. While programming the AREXX Port of `DFA' I got to know the `TeXInfo'
  106. package and I liked it at once!  So I translated the complete manual to
  107. the `TeXInfo' format.  Huge expansions were made due to the
  108. improvements of `DFA'.  The english manual got a complete redesign and
  109. was written using `TeXInfo' as well.
  110.  
  111. The advantage the user can take out of the manual written in `TeXInfo'
  112. can be explained shortly:  It is *easily* possible to create ASCII and
  113. AMIGAGUIDE manuals out of a file written in `TeXInfo' (besides the TeX
  114. manual of course).  However, only registered users will get the TeX
  115. documentation.
  116.  
  117. When the implementation of the AREXX--Port was nearly done, the SAS-C
  118. 6.0 compiler arrived. Because I used the AZTEC-C compiler before, some
  119. adaptions had to be done. When Kickstart/Workbench 2.1 (and 3.0) became
  120. available, it was quite a natural step to localize `DFA', which has
  121. been the biggest difference between `DFA' V1.1 and V1.2.
  122.  
  123. Please remember, however, that I refer to the English program texts
  124. within this manual!
  125.  
  126.  
  127. Installation
  128. *************
  129.  
  130.  
  131. Using the Installer Program
  132. ============================
  133.  
  134. If you got the installer executable together with *another* piece of
  135. software, you may install `DFA' using the provided installer script
  136. `Install-DFA'. Make sure that the installer programm resists in the
  137. proper directory, then double click the `Install-DFA' icon. The install
  138. script is loaded and you may install `DFA'.
  139.  
  140. Please notice that I may *not* include the installer executable within
  141. my shareware package, because it is a copyrighted piece of software
  142. ((C) Commodore) and I had to pay a contribution to Commodore to do so.
  143.  
  144.  
  145. Installation by Hand
  146. =====================
  147.  
  148. If you have to install `DFA' by hand please copy the needed files to
  149. their correct places:
  150.  
  151.    * *DFA, DFA.info*
  152.  
  153.      Should  be copied into a directory of your search path, e.g. `c:'.
  154.        If you want `DFA' to be started automatically during the booting
  155.        phase,   you   can   copy   both  files  into  the
  156.      `SYS:WBStartup' drawer.
  157.  
  158.    * *DFA.key*
  159.  
  160.      Please copy this file to your `s:'--directory; it is recognized
  161.      only there. It activates all the functions, which are disabled in
  162.      the public version. Only registered users get such a key file.
  163.      *Note Registration::.
  164.  
  165.    * *adr.file*
  166.  
  167.      This file contains one (my) address.  If you want, copy it into the
  168.      `s:' drawer and it will be loaded, while `DFA' is starting up. You
  169.      may change the name of the address file (incl.  its path) in the
  170.      preferences window.  If you don't supply any address file, the
  171.      list of addresses will be empty in the beginning.
  172.  
  173.    * *The documentation*
  174.  
  175.      The English documentation can be found within the drawer
  176.      `documentation', the German documentation within the drawer
  177.      `Anleitung'. As the TeX documentation itself is about 200 KB each,
  178.      I decided to put it on disk in a crunched format. You can extract
  179.      it using the `LHA' programm ((C) Stefan Boberg).
  180.  
  181.      Example:
  182.  
  183.           copy DFAddress_V1.2:Documentation/Documentation.lha ram:
  184.           
  185.           cd ram:
  186.           
  187.           DFAddress_V1.2:c/lha x Documentation.lha
  188.  
  189.      The unregistered version only has the ASCII and the GUIDE
  190.      documentation included.  These are *not* crunched and can be used
  191.      at once.  You can use `more' or similar text displayers to read
  192.      the ASCII documentation, `Amigaguide' or `Multiview' for the
  193.      AMIGAGUIDE documentation.
  194.  
  195.    * *Arexx scripts*
  196.  
  197.      In the `rexx' drawer you'll find some little AREXX scripts, which
  198.      you may find useful.  The description of every script is located
  199.      in the beginning of every file.  All scripts either have the
  200.      extension `.DFA', which shows that they contain `DFA' AREXX
  201.      commands or `.CED' which shows that these scripts are done to work
  202.      together with `DFA' and `Cygnus-Ed' (by ASDG). Copy all scripts to
  203.      the `rexx:' directory, so you can use them at once.
  204.  
  205.    * *Catalogs*
  206.  
  207.      To support the different languages, `DFA' uses socalled catalog
  208.      files that contain all the texts in the specified language. Please
  209.      copy the wanted catalog file(s) to the corresponding directory/ies.
  210.      (`Locale:Catalogs/<language>/').
  211.  
  212. Well - that's it.  Now you can use either the shell to start `DFA'
  213. manually by typing `DFA' or `run DFA >NIL: <NIL:', or you double click
  214. on it from the Workbench.
  215.  
  216. You may give an alternative address file to DFA by selecting the wanted
  217. address file, holding down the `SHIFT' key and starting `DFA' by a
  218. "double click". This method is called "multiselect" and is described in
  219. your manual to the Amiga Workbench.
  220.  
  221. As mentioned above, if you copied `DFA' to the `WBStartup' drawer it
  222. will start automatically while booting.
  223.  
  224.  
  225. Quick Start
  226. ************
  227.  
  228. When `DFA' comes up the first time, it opens its window and you can
  229. immediately use it.  If you don't want `DFA' to open its window every
  230. time it starts up you have to change the tool types as described below,
  231. *Note Settings::.  The application icon will appear on the Workbench as
  232. long as you don't switch it off in the preferences window of `DFA'. 
  233. For details see *Note Settings::.
  234.  
  235. The application icon has two features: First you can let `DFA' open its
  236. main window (if it's not open yet) and second you can drag an address
  237. file over this application icon and release it. DFA pops up (if it is
  238. not open yet) and the address file is loaded.
  239.  
  240. `DFA' can be used as default tool as well. If `DFA' is already running
  241. and you double click on an address file icon, the already running `DFA'
  242. will load this address file. If `DFA' is *not* running, it will come up
  243. and load the address file.
  244.  
  245. As `DFA' tries to follow the "User Interface Style Guide" as tight as
  246. possible, it should be no problem (at least for advanced users) to
  247. figure out all the functions of `DFA' according to "trial and error". 
  248. If you don't want to get bad (?) surprises, just continue reading...
  249.  
  250.  
  251. Usage of DFA
  252. *************
  253.  
  254. You can control `DFA' by mouse as usual as well as *completely* by
  255. keyboard.
  256.  
  257. Some notes to the usage of the keyboard:
  258.  
  259.    * *Button Gadgets*
  260.  
  261.      All Gadgets have a corresponing text.  In this text you'll find one
  262.      character *underlined*.  This character is the "shortcut" to the
  263.      gadget.  To use this shortcut just push the corresponding key.  You
  264.      don't have to push any qualifier like `CONTROL' or `ALT'.  To
  265.      simple buttons it doesn't matter if you push the "normal" or the
  266.      capital letter.  To other gadgets it can make a difference (see
  267.      below for details).
  268.  
  269.    * *Listviews*
  270.  
  271.      At the moment `DFA' only has one listview -- the address list in
  272.      the main window. The usage is als follows:
  273.  
  274.             Shortcut
  275.               or             The list rolls *up*.
  276.            Cursor Down
  277.           $*
  278.           SHIFT+Cursor down  The list rolls one page *up*.
  279.           $*
  280.           Shift Shortcut
  281.               or             The list rolls *down*.
  282.             Cursor up
  283.           $*
  284.           SHIFT+Cursor up    The list rolls one page *down*.
  285.           $*
  286.               Space          The  current entry is selected. To mark the selected
  287.                              entry it gets a `>' in the first column.
  288.  
  289.    * *Cycle Gadgets*
  290.  
  291.      In front of a cycle gadget there is short text, which describes the
  292.      function of the gadget. Again there is one charakter underlined.
  293.      However, here it does matter if you use the capital letter or not.
  294.      The "normal" letter cycles foreward, the capital letter backward.
  295.  
  296.    * *Radio Buttons*
  297.  
  298.      Only one of the buttons that belong together can be activated at
  299.      once. You can select an entry by pushing the proper shortcut.  The
  300.      case of the shortcut is not important.
  301.  
  302.    * *Check Boxes*
  303.  
  304.      A check box can be selected (shown by a tick) or deselected
  305.      ("blank"). You can switch the current state by pushing the
  306.      corresponding hotkey.
  307.  
  308.    * *String Gadgets*
  309.  
  310.      The string gadgets have the same functions as the "original" string
  311.      gadgets.  However, I added some features, which should make them
  312.      easier to use:
  313.  
  314.         - Hit `RETURN' to end the input to the current gadget and go to
  315.           the next string or integer gadget. You may use the `ENTER'
  316.           alternatively.
  317.  
  318.         - Hit `SHIFT' `RETURN' to end the input to the current gadget
  319.           and go to the *previous* gadget.
  320.  
  321.         - `CURSOR UP' or `CURSOR DOWN' brings the cursor to the
  322.           previous or next string gadget respectively.
  323.  
  324.         - Hit `ESCAPE' to finish the input completely.  The window
  325.           which contains the gadget is closed and all previous input is
  326.           discarded.
  327.  
  328.         - If the cursor stands within a string gadget, the shortcuts can
  329.           be reached by hitting `LEFT AMIGA'--`letter'.  If there is a
  330.           shortcut that has the same letter as an original edit
  331.           function (like `LAMIGA Q' or `LAMIGA X'), you reach the
  332.           shortcut by pushing `SHIFT' additionally.
  333.  
  334.         - *Online Help*
  335.  
  336.           Since version 1.2 has been finished, `DFA' supports an *Online
  337.           Help* feature. To invoke it, just hit the `Help' key and the
  338.           help window pops up. Please remember that you need the `DFA'
  339.           guide file, if you want to use this feature! Make sure that
  340.           the name of the guide file is entered correctly using the
  341.           correspinding tooltype (see *Note Changing the Tool Types::
  342.           for details).
  343.  
  344.      You can activate a string gadget by hitting the corresponding
  345.      shortcut.  This is not case sensitive again.
  346.  
  347.  
  348. Settings
  349. *********
  350.  
  351. There are two possibilities to configure `DFA':  First you can change
  352. the tool types and second you can use the built--in `DFA' preferences.
  353. You need both ways for a complete configuration!
  354.  
  355.  
  356. Changing the Tool Types
  357. ========================
  358.  
  359. On the Workbench click *once* at the `DFA' icon and select the
  360. information tool from the icons menu.  A window opens, where you can
  361. change the following tool types:
  362.  
  363.    * *`DONOTWAIT'*
  364.  
  365.      This is a system tooltype, which forces the Workbench not to wait
  366.      for `DFA' ending.  You should *not* remove this tool type.
  367.  
  368.    * *`CX_Priority'*
  369.  
  370.      With this tool type you can change the Priority of `DFA'.  The
  371.      default setting of `CX_Priority=0' usually doesn't need to be
  372.      changed.
  373.  
  374.    * *`CX_POPUP'*
  375.  
  376.      If you set `CX_POPUP=YES', you make `DFA' pop up immediately after
  377.      startup.  Set `CX_POPUP=NO' to keep `DFA' "quiet" until you pop it
  378.      up by hitting the hotkey or clicking on the application icon.
  379.  
  380.    * *`CX_Popkey'*
  381.  
  382.      The default setting of the `DFA' hotkey is `LCOMMAND F5', which is
  383.      done by `CX_Popkey=LCOMMAND F5'.  This means that `DFA' pops up as
  384.      soon as you push `LEFT AMIGA F5'. You can change this hotkey using
  385.      the following keywords:
  386.  
  387.           LSHIFT      left shift key
  388.           RSHIFT      right shift key
  389.           CAPSLOCK    caps lock key
  390.           CONTROL     control key
  391.           LALT        left alt key
  392.           RALT        right alt key
  393.           LCOMMAND    left AMIGA key
  394.           RCOMMAND    right AMIGA key
  395.           NUMERICPAD  numeric pad
  396.           MIDBUTTON   middle mouse button
  397.           RBUTTON     right mouse button
  398.           LEFTBUTTON  left mouse button
  399.           F1-F10      function keys 1 to 10
  400.           UP          cursor up
  401.           DOWN        cursor down
  402.           LEFT        cursor left
  403.           RIGHT       cursor right
  404.           HELP        help key
  405.           DEL         del key
  406.           RETURN      return key
  407.           ENTER       enter key on the numeric pad; notice that you have
  408.                       to set `NUMERICPAD' as well!
  409.           BACKSPACE   backspace key
  410.           ESC         escape key
  411.           SPACE       space key
  412.           COMMA       komma key
  413.           UPSTROKE    upstroke key
  414.           A..Z, a..z  "usual" keys
  415.           0..9, etc.
  416.  
  417.      You can "mix" these keys, for example:
  418.  
  419.         - LSHIFT CONTROL F1
  420.  
  421.         - LALT CONTROL D
  422.  
  423.         - CONTROL NUMERICPAD ENTER
  424.  
  425.         - RCOMMAND RSHIFT A
  426.  
  427.         - etc.
  428.  
  429.    * *`GUIDEFILE'*
  430.  
  431.      You can give the name (incl. path) of the `DFA' guide file which
  432.      will be loaded by the guide reader as soon as you hit the `Help'
  433.      key.  The default setting is `Guide:DFA.guide' (see *Note Usage of
  434.      DFA::).
  435.  
  436.    * *`PORTNAME'*
  437.  
  438.      `DFA' uses `DFA' for the portname.  If there is another program
  439.      with the same portname, `DFA' attaches numbers (`DFA.1', `DFA.2',
  440.      etc.) until a definite name is found. However, if you want your
  441.      "own" portname, you can set it using the tool type `PORTNAME'
  442.      (e.g.  `PORTNAME=DFAddress').  Please remember that you have to
  443.      adapt all example AREXX scripts, if you change the portname!
  444.  
  445.    * *`PUBSCREEN'*
  446.  
  447.      Using this tooltype you can change the public screen on which
  448.      `DFA' is opened. You can do this by giving the name of the desired
  449.      public screen like this:
  450.  
  451.  
  452.               PUBSCREEN=TERM
  453.  
  454.      If the given screen exists, `DFA' opens on it, otherwise the
  455.      default public screen (usually the Workbench) is used.
  456.  
  457.    * *`UPPERPUBSCREEN'*
  458.  
  459.      If you use `UPPERPUBSCREEN=YES', `DFA' tries to open on the
  460.      frontmost screen, if it is an public screen.  If this isn't the
  461.      case, `DFA' tries to open on the public screen given using the
  462.      `PUBSCREEN' tooltype.  It this screen can't be found, `DFA' opens
  463.      on the default public screen.
  464.  
  465.  
  466. Start from Shell
  467. =================
  468.  
  469. If you'll start `DFA' from Workbench the tooltypes described above are
  470. used. When you start `DFA' from Shell, these tooltypes are set as well,
  471. as long as the correct `.info'-File is present. You can give some
  472. parameters to `DFA' that overwrite the previous settings (within the
  473. .info file). The possible arguments are described below:
  474.  
  475.    * *`CX_POPKEY'*
  476.  
  477.      The hotkey of `DFA' can be changed by giving `CX_POPKEY=<Hotkey>'.
  478.      To define the hotkey you may use the same keywords as described
  479.      above in *Note Changing the Tool Types::.
  480.  
  481.      Example:
  482.  
  483.  
  484.           DFA CX_POPKEY="LCOMMAND F1"
  485.  
  486.    * *`CX_PRIORITY'*
  487.  
  488.      To change the priority of the DFA-Broker you may use this argument:
  489.  
  490.  
  491.           DFA CX_PRIORITY=5
  492.  
  493.      Usually you should *not* change the priority, because the default
  494.      value is sufficient in most cases.
  495.  
  496.    * *`CX_POPUP'*
  497.  
  498.      If you give `CX_POPUP=NO', `DFA' does not pop up during startup.
  499.  
  500.      Example:
  501.  
  502.  
  503.           DFA CX_POPUP=NO
  504.  
  505.    * *`GUIDEFILE'*
  506.  
  507.      You can give the name (incl.  path) of the `DFA' guide file which
  508.      will be loaded by the guide reader.  See *Note Changing the Tool
  509.      Types::.
  510.  
  511.    * *`PORTNAME'*
  512.  
  513.      If you would like to use another portname than `DFA', you may use
  514.      this keyword. Please notice that you have to change all scripts
  515.      according to the new portname, if you'll change it.
  516.  
  517.      Example:
  518.  
  519.  
  520.           DFA PORTNAME DFA_RXPORT
  521.  
  522.    * *`PUBSCREEN'*
  523.  
  524.      If you want to make `DFA' open its window on another screen than
  525.      the Workbench, you can give the desired public screen name, e.g.
  526.  
  527.  
  528.           DFA PUBSCREEN Term.1
  529.  
  530.    * *`UPPERPUBSCREEN'*
  531.  
  532.      If you use `UPPERPUBSCREEN=YES', `DFA' tries to open on the
  533.      visible (i.e. frontmost) screen, if it is a public screen! If it
  534.      isn't, `DFA' uses the public screen name given using the
  535.      `PUBSCREEN' keyword or the Workbench.
  536.  
  537.  
  538. Changing the DFA Preferences
  539. =============================
  540.  
  541. Select the `preferences' item in the project menu of `DFA'. Another
  542. window opens where you can change the following settings:
  543.  
  544.    * *Address file*
  545.  
  546.      Here you can enter the name of the file (incl.  path), which
  547.      contains the addresses (default:  `s:adr.file').
  548.  
  549.    * *Get*
  550.  
  551.      When you hit `Get', you can use a file requester for selecting the
  552.      address file.  The name of the file appears in the field `Address
  553.      file'.
  554.  
  555.    * *XPos*
  556.  
  557.      In this field you can enter the x-coordinate of the application
  558.      icon, which means the distance from the left edge of the Screen to
  559.      the left edge of the application icon.
  560.  
  561.    * *YPos*
  562.  
  563.      In this field you can enter the y-coordinate of the application
  564.      icon, which means the distance from the top edge of the Screen to
  565.      the top edge of the application icon.
  566.  
  567.    * *Show Appicon*
  568.  
  569.      By using this gadget you can decide if you wish to have an
  570.      application icon on your Workbench screen or not.
  571.  
  572.    * *Baud*
  573.  
  574.      This cycle gadget allows you to select the baud rate of the serial
  575.      port. Notice that it nearly doesn't matter which number you select,
  576.      because all `DFA' does is to dial; no real data are transfered! The
  577.      only thing you should make sure is that the baud rate you select is
  578.      not higher than that of your modem (default: `1200').
  579.  
  580.    * *Init String*
  581.  
  582.      The string that you enter here will be sent to modem for
  583.      initialisation. If you have a Hayes compatible modem, this will
  584.      usually be `ATZ' (default: `ATZ').
  585.  
  586.    * *Predial String*
  587.  
  588.      This string will be sent to the modem just in front of the
  589.      telephone number itself!
  590.  
  591.      Some examples for Hayes compatible modems:
  592.  
  593.              ATDP            pulse dial (default)
  594.              ATDT            tone dial
  595.              ATDP#W          Makes the modem wait for a dialtone after
  596.                              sending a number (`#'). So it is possible
  597.                              to call from a extension.
  598.                              Just substitute `#' by the number you would
  599.                              usually enter to get a dialtone.
  600.  
  601.    * *Serial device*
  602.  
  603.      You may enter the name of a serial device here. Usually this is the
  604.      Commodore `serial.device', which is the default.  If you have an
  605.      interface card with (an) additional serial interface(s), you can
  606.      insert the new serial device here.
  607.  
  608.    * *Select device*
  609.  
  610.      Instead of typing the name of the serial device you can comfortably
  611.      select it from a file requester. The selected device is inserted to
  612.      the `Serial device' field.
  613.  
  614.    * *Device unit*
  615.  
  616.      You may enter the number of the serial device here. Usually this is
  617.      `0'. However, if you have an interface card with more than one
  618.      serial interface, they are distinguishable by their numbers (`0'
  619.      and `1' for example).
  620.  
  621.    * *Save*
  622.  
  623.      `Save' saves the actual preferences.  Notice that besides the
  624.      settings discribed above, the window positions are saved as well. 
  625.      The saving of window positions is done relative to the main
  626.      window.  If you move the preferences window exactly under the
  627.      title bar of the main window and close it, move the main window
  628.      and reopen the preferences window, it opens not on the same place
  629.      as before, but just below the title bar of the main window again.
  630.      The size of the main window is save as well as the Arexx scripts
  631.      that can be linked to every function key, vgl. *Note
  632.      ArexxCommands::.
  633.  
  634.    * *Use*
  635.  
  636.      All setting are used, but *not* saved.  This means, if you reboot,
  637.      you'll get the settings saved previously.
  638.  
  639.    * *Cancel*
  640.  
  641.      If you leave the preferences window by hitting `Cancel', the
  642.      changes you made are not used.
  643.  
  644.  
  645. DFA Step by Step
  646. *****************
  647.  
  648.  
  649. The Main Window
  650. ================
  651.  
  652. The main window can be enlarged and made smaller (down to a minimum
  653. size) by using the sizing gadget. The contents of the window (e.g.
  654. gadgets) is adjusted automatically.
  655.  
  656. As the main window is a socalled application window it is possible to
  657. drag an address file onto this window and corresponding file is loaded.
  658.  
  659. In the main window of `DFA' there are the following possibilities:
  660.  
  661.    * *The Listview*
  662.  
  663.      The address list is displayed in the listview, as soon as you have
  664.      entered some addresses (see below for details). You can scroll the
  665.      list and select entries using the mouse or the keyboard (see *Note
  666.      Usage of DFA::.  Hit `a' to select (*not* mark) the next entry,
  667.      hit `A' to select the previous one.  The listview scrolls
  668.      automatically.  To mark the selected entry use `SPACE' (or double
  669.      click with the mouse).  If you push `RETURN', it will have the
  670.      same function as if you selected `Full', which means that a window
  671.      opens and the full address is shown.  *Note Full::.
  672.  
  673.    * *The text fields*
  674.  
  675.      Below the listview you see four text gadgets. They show the
  676.      telephone number and up to three email addresses of the current
  677.      entry.
  678.  
  679.    * *The Gadget Panel, Right to the Listview*
  680.  
  681.      Right to the listview you see some gadgets, whose functions are
  682.      described now:
  683.  
  684.         - *Full*
  685.  
  686.           Shows the current entry in another window; further
  687.           information is shown here, such as street, city, and so on...
  688.           for details see *Note Full::.
  689.  
  690.         - *Edit*
  691.  
  692.           If a current entry exists, you can edit it by pushing `Edit'.
  693.           If no address is selected, none can be edited obviously.
  694.           *Note Edit::.
  695.  
  696.         - *New*
  697.  
  698.           If you hit `New', you can enter a *new* address. The
  699.           functions within the window that pops up are the same as in
  700.           the `Edit' window. *Note New::.
  701.  
  702.         - *Kill*
  703.  
  704.           You can delete the current entry (if one exists) by selecting
  705.           `Kill'.  There is a safety requester that makes sure that no
  706.           address is deleted by a mistake.
  707.  
  708.         - *Search*
  709.  
  710.           Another window pops up, which allows you to enter some search
  711.           criteria.  *Note Search::.
  712.  
  713.         - *Search Next*
  714.  
  715.           `Search Next' can be selected only, if you entered a search
  716.           criteria before (see `Search' above). If you did so, the next
  717.           entry that corresponds to is selected (*not* marked).
  718.  
  719.         - *Print*
  720.  
  721.           Another window pops up; in this window you have some
  722.           possibilities to print the managed addresses. *Note Print::.
  723.  
  724.         - *Sort*
  725.  
  726.           Select `Sort' to sort the complete address list by name, first
  727.           name and city (in *this* order).
  728.  
  729.         - *Dial*
  730.  
  731.           For owners of modems only!
  732.  
  733.           If you have a modem connected to your computer, it will be
  734.           possible to let the computer dial the phone number(s).  If
  735.           you have entered more than one number, it is *stricly*
  736.           recommended that you seperate them by a `pipe' sign (`|'). 
  737.           When you start dialing (hit `Dial'), a requester pops up that
  738.           displays who is called.  You can cancel the dialing at every
  739.           time (`Cancel') or skip the current number (`Skip').  The
  740.           modem settings can be changed in the `DFA' preferences. 
  741.           *Note Settings::.
  742.  
  743.      Just below the listview are four gadgets which can be used to
  744.      select the entries within the listview:
  745.  
  746.         - *All*
  747.  
  748.           Selects all addresses.
  749.  
  750.         - *By name*
  751.  
  752.           A small window is opened.  Here you can enter a search
  753.           pattern (search is *not* case sensitive).  After selecting
  754.           `Ok' (or hit `RETURN') all matching entries will be *marked*.
  755.            The difference to the `Search' function is 1st that you
  756.           cannot select casesensitive search and 2nd that only those
  757.           parts of the address are searched through that can be seen in
  758.           the listview (name, first name and city).  Furthermore all
  759.           matching entries are *marked* (compare:  `Search' *jumps to*
  760.           the first matching entry); the first marked entry is selected.
  761.  
  762.         - *Clear*
  763.  
  764.           All entries are deselected.
  765.  
  766.         - *Jump to*
  767.  
  768.           The next selected entry becomes the current one. If there is
  769.           no next entry, the very first entry is shown.
  770.  
  771.    * At the bottom of the main window there are the two gadgets `Hide'
  772.      and `Quit'.
  773.  
  774.      `Hide' closes the window. The application icon stays on the
  775.      Workbench (if you have not deselected the application icon in the
  776.      preferences window). `DFA' can be brought to front quickly by
  777.      double clicking the application icon or by using the "hotkey"
  778.      (default: `Left Amiga F5'. How you can change the hotkey can be
  779.      looked up under *Note Settings::.
  780.  
  781.      If you hit `Quit', changes are saved and `DFA' is terminated.
  782.  
  783.  
  784. Full
  785. =====
  786.  
  787. `Full' can only be selected, if there is an "active" address.  In this
  788. case another window pops up (title:  `Full address...'), in which the
  789. current address is displayed in more detail.
  790.  
  791. Below the address fields there is a gadget panel, which makes it
  792. possible to move through the complete address list:
  793.  
  794.    * *First*
  795.  
  796.      The first address of the list is shown.  The shortcut is the
  797.      underlined letter or `Cursor Up'.
  798.  
  799.    * *Last*
  800.  
  801.      The last address of the list is shown. The shortcut is the
  802.      underlined letter or `Cursor Down'.
  803.  
  804.    * *Prev. Sel.*
  805.  
  806.      If a *marked* address exists in front of the current one, it will
  807.      be shown.
  808.  
  809.    * *Next Sel.*
  810.  
  811.      If a *marked* address exists behind the current one, it will be
  812.      shown.
  813.  
  814.    * *Prev.*
  815.  
  816.      The previous address is shown. The shortcut is the underlined
  817.      letter or `Cursor Left'.
  818.  
  819.    * *Next*
  820.  
  821.      The next address is shown. The shortcut is the underlined letter
  822.      or `Cursor Right'.
  823.  
  824. If you hit `Ok', the window is closed and you return to the main
  825. window; if you hit `Edit', you will get the familiar `Edit' window. 
  826. *Note Edit::.
  827.  
  828.  
  829. Edit
  830. =====
  831.  
  832. If there is a current address, a new window opens that lets you change
  833. all parts of the address. Compared to the original string gadget
  834. functions, there are additional features: *Note Usage of DFA::.
  835.  
  836. There exist the following fields:
  837.  
  838.      Address         Address
  839.      First           First name
  840.      Name            Name
  841.      Street          Street/No.
  842.      Zip             Zip
  843.      City            City
  844.      Country         Country
  845.      Birthday        Birthday
  846.      Phone           Telphone number
  847.      Email1          email address # 1
  848.      Email2          email address # 2
  849.      Email3          email address # 3
  850.      Fax             Telefax number
  851.      Comment         Comment
  852.  
  853. Hit `Ok' to confirm the changes or hit `Cancel' to abort.
  854.  
  855.  
  856. New
  857. ====
  858.  
  859. Hit `New' to open a window, which is exactly the same as the `Edit'
  860. window.  The template entries have already been copied to the
  861. corresponding fields, *Note EditTemplate::. Now you can enter a *new*
  862. address. All functions are the same as in the `Edit' window. (*Note
  863. Edit::.
  864.  
  865.  
  866. Search
  867. =======
  868.  
  869. In this window you can enter the search pattern and more:
  870.  
  871.    * *Search for*
  872.  
  873.      Here you enter the search pattern, for which the usual *AMIGA*
  874.      patterns may be used.  You have to add a `#?' (or `*') in front of
  875.      and behind the search string if you want to search for a partial
  876.      string. If you want to look for a name that starts with `Jo' and
  877.      ends up in anything, you should use `Jo#?'. If you are looking for
  878.      towns that end up with `town' and start with anything, use
  879.      `#?town'.
  880.  
  881.      Supported patterns and their meaning:
  882.  
  883.  
  884.               ?       Matches a single character.
  885.               #       Matches the following expression 0 or more times.
  886.               (ab|cd) Matches anyone of the items seperated by `|'.
  887.               ~       Negates the following expression.  It matches all
  888.                       strings that do not match the expression
  889.                       (aka `~(foo)' matches all strings that are not
  890.                       exactly `foo').
  891.               [abc]   Character class: matches any of the characters in the
  892.                        class.
  893.               [~bc]   Character class: matches any of the characters not in
  894.                       the class.
  895.               a-z     Character range (only within character classes).
  896.               %       Matches 0 characters always (useful in `(foo|bar|%)').
  897.               *       Synonym for `#?'.
  898.  
  899.      "Expression" in the above table means either a single character
  900.      (ex: `#?'), or an alternation (ex: `#(ab|cd|ef)'), or a character
  901.      class (ex: `#[a-zA-Z]').
  902.  
  903.    * *Ignore case*
  904.  
  905.      If the box is "checked", the search will not be case sensitive. If
  906.      the box is empty however, case will be noticed.
  907.  
  908.    * *Fields to search*
  909.  
  910.      You can choose, which fields are to be searched:  `All fields' or
  911.      special parts of it.
  912.  
  913.    * *Search*
  914.  
  915.      `Search' starts the search. If a matching entry is found, the list
  916.      will scroll to the entry and the address will become the active
  917.      one (it will *not* be marked).
  918.  
  919.    * *Cancel*
  920.  
  921.      `Cancel' cancels the search. The listview is updated, which means
  922.      that the former selected entry scrolls to the first line of the
  923.      list.
  924.  
  925.  
  926. Print
  927. ======
  928.  
  929. In this window all functions are collected that print the addresses
  930. managed by `DFA'.
  931.  
  932.    * *Print*
  933.  
  934.      You can choose between all (`All'), the marked (`Selected') and
  935.      the active address (`Active').  If there is an active item, it
  936.      will be shown in the `Active Item' field.
  937.  
  938.    * *Print to*
  939.  
  940.      You can either print to the printer (`PRT:') or to a file
  941.      (`File'). If you print your addresses to a file, the settings
  942.      below don't take effect.  Notice that there are always written all
  943.      parts of an address!
  944.  
  945.    * *Print style*
  946.  
  947.      You may choose, whether the addresses are to be printed in `NLQ' or
  948.      `Condensed' style.
  949.  
  950.      If you select `Formfeed', a formfeed is performed after the very
  951.      *last* printed address entry.  To switch this off will be useful,
  952.      if you want to print a few address labels only and you don't want
  953.      to waste these sheets.  Please notice that the AREXX command
  954.      `Print' doesn't take care of *this* setting (see *Note Arexx
  955.      function PRINT::.
  956.  
  957.    * *Print form*
  958.  
  959.      There are five different forms, between which you may choose:
  960.  
  961.         - Short address list
  962.  
  963.         - Full address list
  964.  
  965.         - Phonelist (fixed columns)
  966.  
  967.         - Mailing labels (70mm x 46mm)
  968.  
  969.         - Address cards
  970.  
  971.    * *Print*
  972.  
  973.      If you did select `File' for output, a file requester will be
  974.      opened, which allows you to enter the filename.  Be careful!  This
  975.      output file is *not* compatible to the internal address file
  976.      format; so don't overwrite this (these) file(s).  To write the
  977.      addresses to a file may be useful if you want to export addresses,
  978.      but don't wan't to use AREXX.
  979.  
  980.      If you send your addresses to the printer (`PRT:'), another window
  981.      is opened that displays the progress of printing. You may stop the
  982.      output after every complete address (`Cancel'). If only the active
  983.      item is printed, no progress indicator is shown.
  984.  
  985.    * *Cancel*
  986.  
  987.      `Cancel' terminates the complete printing process.
  988.  
  989.  
  990. The Menus of DFA
  991. *****************
  992.  
  993. You already got to know one menu item when you changed the `DFA'
  994. preferences, now you will learn something about the others:
  995.  
  996.  
  997. About (Shortcut ?)
  998. ===================
  999.  
  1000. In the `About' window you'll find something useful about the program
  1001. itself and the author:
  1002.  
  1003.    * The version number as well as a notice, if you are a registered
  1004.      user.
  1005.  
  1006.    * The copyright notice and the address of the author (incl.  email
  1007.      address(es)).
  1008.  
  1009.    * Your name, address and the serial number if you are a registered
  1010.      user.
  1011.  
  1012.    * The notice that the graphical user interface (GUI) is done using
  1013.      the GadToolsBox by Jan van den Baard.
  1014.  
  1015.  
  1016. Info (Shortcut I)
  1017. ==================
  1018.  
  1019. The window which pops up as soon as you select the `Info' menu item
  1020. gives you some useful informations:
  1021.  
  1022.    * *Arexx Port*
  1023.  
  1024.      In this field you can look up the name of `DFA''s AREXX port.
  1025.      Usually this is `DFA'. However, you can change the portname by
  1026.      changing the `PORTNAME' tooltype. *Note Settings::.
  1027.  
  1028.      If you have already started a program that uses the portname
  1029.      `DFA', `DFA' adapts the portname by appending "numbers" (e.g.
  1030.      `DFA.1', `DFA.2',...) until a clear portname is found.
  1031.  
  1032.    * *Addresses* The number of addresses which are loaded are shown in
  1033.      this field.
  1034.  
  1035.    * *Memory  Condition*
  1036.  
  1037.      The three fields give a quite detailed report about the current
  1038.      memory condition.
  1039.  
  1040.  
  1041. Load (Shortcut L)
  1042. ==================
  1043.  
  1044. Use `Load' to load another address file. The currently loaded addresses
  1045. are lost! After you selected `Load', a file requester pops up, which
  1046. lets you enter the address file. Notice that only files can be loaded,
  1047. which have the proper format -- files that have been created by `DFA'
  1048. before!  Files with the wrong format can't be loaded by `DFA', the
  1049. previously loaded addresses are lost in every case.
  1050.  
  1051.  
  1052. Append (Shortcut A)
  1053. ====================
  1054.  
  1055. `Append' allows you to append further addresses to the existing ones.
  1056. The already loaded addresses are *not* discarded. Be careful! If you
  1057. append two identical address lists, every entry will appear twice,
  1058. which is usually not desired.
  1059.  
  1060.  
  1061. Save (Shortcut S)
  1062. ==================
  1063.  
  1064. `Save' saves the addresses under the current name. The current name is
  1065. either the one you entered in the preferences (default: `s:adr.file')
  1066. or the one you selected before when loading an address file.
  1067.  
  1068.  
  1069. Save as... (Shortcut V)
  1070. ========================
  1071.  
  1072. `Save as' saves the address as well. However, you are able to select a
  1073. filename before (a file requester pops up). This may be useful, if you
  1074. have several address files for different purposes.
  1075.  
  1076.  
  1077. Save as default (Shortcut D)
  1078. =============================
  1079.  
  1080. The addresses will be saved under the name specified in the preferences
  1081. (default: `s:adr.file'), if you select `Save as default', even if you
  1082. loaded another file before.
  1083.  
  1084. If you did not genertate an icon for your `DFA' address file up to now,
  1085. `DFA' creates one for you that uses `DFA' as default tool.
  1086.  
  1087.  
  1088. Quit (Shortcut Q)
  1089. ==================
  1090.  
  1091. `Quit' terminates DFA.  If you did some changes to the address list
  1092. before, they will be saved.
  1093.  
  1094.  
  1095. Preferences (Shortcut P)
  1096. =========================
  1097.  
  1098. The preferences window has already been discussed before. *Note
  1099. Settings::.
  1100.  
  1101.  
  1102. Edit Template (Shortcut T)
  1103. ===========================
  1104.  
  1105. A window pops up that is known from the *Note Edit:: and *Note New::
  1106. window. Here you can enter socalled templates that will be copied to the
  1107. corresponding fields, if you select `New'. These entries will be saved
  1108. together with the other *addresses* and *not* together with the
  1109. preferences. This makes it possible to have different templates for
  1110. every address file.
  1111.  
  1112.  
  1113. Arexx Commands (Shortcut C)
  1114. ============================
  1115.  
  1116. A window pops up and you can enter one Arexx command for every function
  1117. key.  If you don't want to type in the name of every Arexx script file,
  1118. you can push the according `Get'--gadget, an file requester pops up and
  1119. you can select the desired Arexx script file. Hit `Ok' to use the
  1120. settings or `Cancel' to discard them. The Arexx commands are saved
  1121. together with the preferences, see *Note Changing the DFA Preferences::
  1122. for details.
  1123.  
  1124.  
  1125. The Arexx Port
  1126. ***************
  1127.  
  1128. Since version 1.1 of `DFA' has been finished, there is an AREXX port. 
  1129. Because *AMIGA*OS 2.0 includes AREXX, everyone has the chance to
  1130. control `DFA' by AREXX scripts now.  This will be very useful, if you
  1131. want to export or import some addresses to or from another program for
  1132. example.
  1133.  
  1134.  
  1135. Basics
  1136. =======
  1137.  
  1138. `DFA' will accept AREXX commands, if the main window is open or if
  1139. `DFA' is "sleeping", which means that only the application icon (or not
  1140. even that) can be seen.  If you are just within another window (e.g. 
  1141. in the `Edit' window), `DFA' will not receive any AREXX command!  This
  1142. may be considered to be useful, because it would be very confusing if
  1143. an AREXX script deletes the address that you are just editing for
  1144. example.  As soon as you return to the main window AREXX commands can
  1145. be received.
  1146.  
  1147. The basics of the AREXX language can be looked up in the *AMIGA* OS 2.0
  1148. manual or in the "AREXX User's Reference Manual"(1).
  1149.  
  1150. The name of the AREXX port of `DFA' is `DFA', as long as you don't
  1151. change the portname using the `PORTNAME' tooltype as described in *Note
  1152. Settings::.  This should only be done, if you have another program
  1153. running that uses the portname `DFA' as well and you don't want to use
  1154. `DFA''s feature to choose its own clear portname.
  1155.  
  1156. When you find `ADDRESS/M' as a return value, this means that the wanted
  1157. address is returned in the given variable (or `RESULTS'). For this
  1158. reason `DFA' supports the AREXX keywords `STEM' and `VAR'.
  1159.  
  1160. Example:
  1161.          /* Outputs the first address of the list */
  1162.          ADDRESS "DFA"
  1163.          OPTION RESULTS
  1164.          FIRST STEM TEST.
  1165.          SAY TEST.ADDRESS.1
  1166.          EXIT
  1167. This (very) short example outputs the name of the the first entry of
  1168. the address list.
  1169.  
  1170. The `STEM' keyword returns the address in the form of a *list* (or
  1171. *array*); this means that the elements of the address are kept in
  1172. `TEST.ADDRESS.0' to `TEST.ADDRESS.13'. The number of entries is stored
  1173. in `TEST.ADDRESS.COUNT' (see the example above).  The `VAR' keyword
  1174. returns the *complete* address as well; however, the whole list is
  1175. stored in *one* variable, separated by spaces.  Please consult your
  1176. AREXX manual for details.
  1177.  
  1178. The address fields correspond to the following list numbers:
  1179. 0
  1180.      Address (ADDRESS)
  1181.  
  1182. 1
  1183.      Name (NAME)
  1184.  
  1185. 2
  1186.      First name (FIRST)
  1187.  
  1188. 3
  1189.      Street (STREET)
  1190.  
  1191. 4
  1192.      ZIP (ZIP)
  1193.  
  1194. 5
  1195.      City (CITY)
  1196.  
  1197. 6
  1198.      Country (COUNTRY)
  1199.  
  1200. 7
  1201.      Birthday (BIRTHDAY)
  1202.  
  1203. 8
  1204.      Telephone (PHONE)
  1205.  
  1206. 9
  1207.      Email 1 (EMAIL1)
  1208.  
  1209. 10
  1210.      EMail 2 (EMAIL2)
  1211.  
  1212. 11
  1213.      Email 3 (EMAIL3)
  1214.  
  1215. 12
  1216.      Fax (FAX)
  1217.  
  1218. 13
  1219.      Comment (COMMENT)
  1220.  
  1221. 14
  1222.      Selection flag (SELECT)
  1223.  
  1224. A further remark on the `Load', `Append', and `Save as' commands:
  1225.  
  1226. When you give a filename, you always should give the full pathname,
  1227. because this is the only way to make sure that the file can be found by
  1228. `DFA'. It wouldn't make much sense to refer to the home directory of
  1229. `DFA' or to the `Rexx:' drawer, because 1st `DFA' will often be kept in
  1230. another directory than the address files and 2nd `DFA' remembers the
  1231. last entered (or the default) pathname and uses it for loading and
  1232. saving.
  1233.  
  1234. Beyond the item `Syntax' the possible paramters are listed.  The
  1235. description of the parameters follows the known style given by
  1236. Commodore.  E.g.  `FORM/K' can be one out of `FORM=ALL',
  1237. `FORM=SELECTED' or `FORM=ACTIVE'.  You may leave out the `=' sign.  The
  1238. exact syntax to every command can be found below, *Note The Arexx
  1239. Commands::.
  1240.  
  1241. The AREXX interface of `DFA' gives you a powerful instrument to
  1242. manipulate the stored addresses. A wider range of functionality however
  1243. implements more ways of loosing your data! This could happen not only
  1244. by a malfunction of `DFA' but also by a inproper used function or
  1245. parameter.  Therefore I encourage you to make regular copies of your
  1246. databases to keep the potential damage as small as possible.
  1247.  
  1248. ---------- Footnotes ----------
  1249.  
  1250. (1)  AREXX User's Reference Manual, William S. Hawes, P.O.  Box 308,
  1251. Maynard, MA 01754
  1252.  
  1253.  
  1254. The Arexx Commands
  1255. ===================
  1256.  
  1257. Below you'll find all the AREXX commands of `DFA' in alphabetical order:
  1258.  
  1259.  
  1260. ABOUT
  1261. ------
  1262.  
  1263. Syntax:
  1264.      ABOUT
  1265.  
  1266. Return value:
  1267.      Error code in RC
  1268.  
  1269. Function:
  1270.      The `About' window pops up.
  1271.  
  1272.  
  1273. APPEND
  1274. -------
  1275.  
  1276. Syntax:
  1277.      APPEND FILENAME/A, FORCE/S
  1278.  
  1279. Return value:
  1280.      Error code in RC
  1281.  
  1282. Function:
  1283.      Addresses are appended to the existing ones. If the existing
  1284.      addresses have been changed before, the new list will *not* be
  1285.      appended. If you give the keyword `FORCE', however, the new
  1286.      addresses are appended in every case!
  1287.  
  1288.  
  1289. CLEARALL
  1290. ---------
  1291.  
  1292. Syntax:
  1293.      CLEARALL
  1294.  
  1295. Return value:
  1296.      Error code in RC
  1297.  
  1298. Function:
  1299.      All entries of the address list are deselected.
  1300.  
  1301.  
  1302. DESELECT
  1303. ---------
  1304.  
  1305. Syntax:
  1306.      DESELECT
  1307.  
  1308. Return value:
  1309.      Error code in RC
  1310.  
  1311. Function:
  1312.      The current entry (if there is one) is deselected.
  1313.  
  1314.  
  1315. DIAL
  1316. -----
  1317.  
  1318. Syntax:
  1319.      DIAL
  1320.  
  1321. Return value:
  1322.      Error code in RC
  1323.  
  1324. Function:
  1325.      The current address (if there is one) is dialed.
  1326.  
  1327.  
  1328. EDIT
  1329. -----
  1330.  
  1331. Syntax:
  1332.      EDIT  ADDRESS/K,  FIRST/K, NAME/K, STREET/K, ZIP/K, CITY/K,
  1333.      COUNTRY/K, BIRTHDAY/K,  PHONE/K,  EMAIL1/K, EMAIL2/K, EMAIL3/K,
  1334.      FAX/K, COMMENT/K, SELECT/S
  1335.           ADDRESS         Address
  1336.           FIRST           First name
  1337.           NAME            Name
  1338.           STREET          Street/No.
  1339.           ZIP             Zip
  1340.           CITY            City
  1341.           COUNTRY         Country
  1342.           BIRTHDAY        Birthday
  1343.           PHONE           Telphone number
  1344.           EMAIL1          email address # 1
  1345.           EMAIL2          email address # 2
  1346.           EMAIL3          email address # 3
  1347.           FAX             Telefax number
  1348.           COMMENT         Comment
  1349.           SELECT          `1' if the entry is selected, `0' if it isn't.
  1350.  
  1351. Return value:
  1352.      Error code in RC
  1353.  
  1354. Function:
  1355.      The current address (if there is one) is changed in the given
  1356.      fields. The former contents of the specified fields are deleted.
  1357.      Fields that are not given are not changed and not deleted. Please
  1358.      notice that parameters that contain spaces, have to be set in
  1359.      inverted commas twice!
  1360.  
  1361.      Example:
  1362.               EDIT 'COMMENT="A test with spaces"'
  1363.  
  1364.      Please remember to use `'' for the outer and `"' for the inner
  1365.      quotation marks!
  1366.  
  1367.  
  1368. FIRST
  1369. ------
  1370.  
  1371. Syntax:
  1372.      FIRST
  1373.  
  1374. Return value:
  1375.         * Error code in RC
  1376.  
  1377.         * ADDRESS/M
  1378.  
  1379. Function:
  1380.      The first address of the list gets the current one.  This address
  1381.      will be returned in `ADDRESS'.
  1382.  
  1383.  
  1384. GETCURRENT
  1385. -----------
  1386.  
  1387. Syntax:
  1388.      GETCURRENT
  1389.  
  1390. Return value:
  1391.         * Error code in RC
  1392.  
  1393.         * ADDRESS/M
  1394.  
  1395. Function:
  1396.      The current entry (if there ist one) is returned in `ADDRESS'.
  1397.  
  1398.  
  1399. ICONIFY
  1400. --------
  1401.  
  1402. Syntax:
  1403.      ICONIFY
  1404.  
  1405. Return value:
  1406.      Error code in RC
  1407.  
  1408. Function:
  1409.      If the main window of `DFA' is open, it will be closed. `DFA' is
  1410.      *not* terminated.
  1411.  
  1412.  
  1413. KILL
  1414. -----
  1415.  
  1416. Syntax:
  1417.      KILL
  1418.  
  1419. Return value:
  1420.      Error code in RC
  1421.  
  1422. Function:
  1423.      The current entry (if there ist one) is discarded. Be careful!
  1424.      There is no safety requester. The address will be deleted, even if
  1425.      you did some changes before.
  1426.  
  1427.  
  1428. LAST
  1429. -----
  1430.  
  1431. Syntax:
  1432.      LAST
  1433.  
  1434. Return value:
  1435.         * Error code in RC
  1436.  
  1437.         * ADDRESS/M
  1438.  
  1439. Function:
  1440.      The last address of the list becomes the current one. This address
  1441.      is returned in `ADDRESS'.
  1442.  
  1443.  
  1444. LOAD
  1445. -----
  1446.  
  1447. Syntax:
  1448.      LOAD FILENAME/A,FORCE/S
  1449.  
  1450. Return value:
  1451.      Error code in RC
  1452.  
  1453. Function:
  1454.      The given address file is loaded, if you did no changes before. In
  1455.      such a case use `FORCE' to load the file.
  1456.  
  1457.  
  1458. NEW
  1459. ----
  1460.  
  1461. Syntax:
  1462.      NEW  ADDRESS/K,  FIRST/K,  NAME/K, STREET/K, ZIP/K, CITY/K,
  1463.      COUNTRY/K, BIRTHDAY/K,  PHONE/K,  EMAIL1/K, EMAIL2/K, EMAIL3/K,
  1464.      FAX/K, COMMENT/K, SELECT/S
  1465.           ADDRESS         Address
  1466.           FIRST           First name
  1467.           NAME            Name
  1468.           STREET          Street/No.
  1469.           ZIP             Zip
  1470.           CITY            City
  1471.           COUNTRY         Country
  1472.           BIRTHDAY        Birthday
  1473.           PHONE           Telphone number
  1474.           EMAIL1          Email address # 1
  1475.           EMAIL2          Email address # 2
  1476.           EMAIL3          Email address # 3
  1477.           FAX             Telefax number
  1478.           COMMENT         Comment
  1479.           SELECT          `1' if the entry is selected, `0' if it isn't.
  1480.  
  1481. Return value:
  1482.      Error code in RC
  1483.  
  1484. Function:
  1485.      A new address entry is created, which contains the data given.
  1486.  
  1487.  
  1488. NEXT
  1489. -----
  1490.  
  1491. Syntax:
  1492.      NEXT
  1493.  
  1494. Return value:
  1495.         * Error code in RC
  1496.  
  1497.         * ADDRESS/M
  1498.  
  1499. Function:
  1500.      The next address is selected and returned in `ADDRESS'.
  1501.  
  1502.  
  1503. NEXTSEL
  1504. --------
  1505.  
  1506. Syntax:
  1507.      NEXTSEL
  1508.  
  1509. Return value:
  1510.         * Error code in RC
  1511.  
  1512.         * ADDRESS/M
  1513.  
  1514. Function:
  1515.      The next selected address becomes the current one and is returned
  1516.      in `ADDRESS'.
  1517.  
  1518.  
  1519. POPUP
  1520. ------
  1521.  
  1522. Syntax:
  1523.      POPUP
  1524.  
  1525. Return value:
  1526.      Error code in RC
  1527.  
  1528. Function:
  1529.      If `DFA' is sleeping (no window is open), the main window will be
  1530.      opened; otherwise an error code will be returned (`10').
  1531.  
  1532.  
  1533. PREV
  1534. -----
  1535.  
  1536. Syntax:
  1537.      PREV
  1538.  
  1539. Return value:
  1540.         * Error code in RC
  1541.  
  1542.         * ADDRESS/M
  1543.  
  1544. Function:
  1545.      The previous address becomes the current one and is returned in
  1546.      `ADDRESS'.
  1547.  
  1548.  
  1549. PREVSEL
  1550. --------
  1551.  
  1552. Syntax:
  1553.      PREVSEL
  1554.  
  1555. Return value:
  1556.         * Error code in RC
  1557.  
  1558.         * ADDRESS/M
  1559.  
  1560. Function:
  1561.      The previous address that is selected becomes the current one and
  1562.      is returned in `ADDRESS'.
  1563.  
  1564.  
  1565. PRINT
  1566. ------
  1567.  
  1568. Syntax:
  1569.      PRINT WHICH/K, FILE/K, NLQ/S, CONDENSED/S, FORMFEED/S, FORM/N
  1570.           WHICH         `WHICH' can get the following assignments:
  1571.           
  1572.                         ALL       All addresses are printed
  1573.                         SELECTED  Only the marked addresses are printed
  1574.                         ACTIVE    The active item (if there is one) is
  1575.                                   printed
  1576.           
  1577.           FILE          If you give `FILE' together with a filename
  1578.                         the addresses are not printed to the printer, but
  1579.                         to the file.
  1580.           NLQ           The addresses are printed in `N'ear `L'etter `Q'uality.
  1581.           CONDENSED     The addresses are printed in condensed mode
  1582.           FORMFEED      Afted the last address printed a formfeed is performed.
  1583.                         Notice that the setting from the print window is 
  1584.                         *not* used here!
  1585.           FORM          `Form' can be assigned to the numbers `0' to `4'.
  1586.                         These numbers are (nearly) the same as in the `Print' window.
  1587.                         The difference is that here the first number is `0'
  1588.                         instead of `1':
  1589.           
  1590.                         0:    Short address list
  1591.                         1:    Long address list
  1592.                         2:    Phone list
  1593.                         3:    Mailing labels
  1594.                         4:    Address cards
  1595.  
  1596.  
  1597. Return value:
  1598.      Error code in RC
  1599.  
  1600. Function:
  1601.      The desired addresses are printed.
  1602.  
  1603.  
  1604. SAVE
  1605. -----
  1606.  
  1607. Syntax:
  1608.      SAVE
  1609.  
  1610. Return value:
  1611.      Error code in RC
  1612.  
  1613. Function:
  1614.      The address list is saved using the current name.
  1615.  
  1616.  
  1617. SAVEAS
  1618. -------
  1619.  
  1620. Syntax:
  1621.      SAVEAS FILENAME/A, FORCE/S
  1622.  
  1623. Return value:
  1624.      Error code in RC
  1625.  
  1626. Function:
  1627.      The address list is saved using the given filename.
  1628.  
  1629.  
  1630. SAVEASDEFAULT
  1631. --------------
  1632.  
  1633. Syntax:
  1634.      SAVEASDEFAULT
  1635.  
  1636. Return value:
  1637.      Error code in RC
  1638.  
  1639. Function:
  1640.      The address list is saved using the default filename that is set in
  1641.      the `DFA' preferences (default: `s:adr.file').
  1642.  
  1643.  
  1644. SEARCH
  1645. -------
  1646.  
  1647. Syntax:
  1648.      SEARCH PATTERN/A, IGNORECASE/S, FIELDS/K
  1649.           PATTERN     A search pattern that follows the rules given by
  1650.                       Commodore
  1651.           IGNORECASE  `IGNORECASE' makes the search caseinsensitive.
  1652.           FIELDS      You may assign the `FIELDS' keyword to the
  1653.                       following values:
  1654.           
  1655.                       ALL       All fields are searched through.
  1656.                       FIRST     Only the `first name' fields are scanned.
  1657.                       NAME      Only the `name fields' are scanned.
  1658.                       ZIP       Only the `zip' fields are scanned.
  1659.                       CITY      Only the `city' fields are scanned.
  1660.                       COUNTRY   Only the `country' fields are scanned.
  1661.                       BIRTHDAY  Only the `birthday' fields are scanned.
  1662.                       PHONE     Only the `phone' fields are scanned.
  1663.                       EMAIL     Only the three `email' fields are scanned.
  1664.                       COMMENT   Only the `comment' fields are scanned.
  1665.  
  1666.  
  1667. Return value:
  1668.         * Error code in RC
  1669.  
  1670.         * ADDRESS/M
  1671.  
  1672. Function:
  1673.      It is searched for the given search pattern.  If a matching item
  1674.      is found it will be returned in `ADDRESS'.  If the main window of
  1675.      DFA is open, the address list is updated occordingly.
  1676.  
  1677.  
  1678. SEARCHNEXT
  1679. -----------
  1680.  
  1681. Syntax:
  1682.      SEARCHNEXT
  1683.  
  1684. Return value:
  1685.         * Error code in RC
  1686.  
  1687.         * ADDRESS/M
  1688.  
  1689. Function:
  1690.      The next appearance of the search pattern given in `SEARCH' is
  1691.      searched for.  If there is a matching item, the entry will be
  1692.      returned in `ADDRESS'.  If the main window of DFA is open, the
  1693.      address list is updated occordingly.
  1694.  
  1695.  
  1696. SELALL
  1697. -------
  1698.  
  1699. Syntax:
  1700.      SELALL
  1701.  
  1702. Return value:
  1703.      Error code in RC
  1704.  
  1705. Function:
  1706.      All addresses of the list are selected.
  1707.  
  1708.  
  1709. SELBYNAME
  1710. ----------
  1711.  
  1712. Syntax:
  1713.      SELBYNAME PATTERN/A
  1714.  
  1715. Return value:
  1716.      Error code in RC
  1717.  
  1718. Function:
  1719.      All addresses in the listview which contain the given pattern are
  1720.      *marked*.
  1721.  
  1722.  
  1723. SELECT
  1724. -------
  1725.  
  1726. Syntax:
  1727.      SELECT QUERY/S
  1728.  
  1729. Return value:
  1730.         * Error code in RC
  1731.  
  1732.         * SELECTED/N
  1733.  
  1734. Function:
  1735.      The current entry (if there is one) is selected. If you select
  1736.      `QUERY', the current address is *not* selected, but the existing
  1737.      selection status is returned (`0' or `1').
  1738.  
  1739.  
  1740. SORT
  1741. -----
  1742.  
  1743. Syntax:
  1744.      SORT
  1745.  
  1746. Return value:
  1747.      Error code in RC
  1748.  
  1749. Function:
  1750.      The address list is sorted by name, first name and city (in `this'
  1751.      order).
  1752.  
  1753.  
  1754. The Error Codes
  1755. ================
  1756.  
  1757. The error code are the same as given by the AREXX manual:
  1758.      0:   No error
  1759.      5:   Warning
  1760.      10:  Error
  1761.      20:  Severe error
  1762.  
  1763. If something goes wrong while working on a command, `DFA' returns `10'
  1764. (`RC_ERROR') in RC! If there is a syntax error, the AREXX command
  1765. parser returns `20'.
  1766.  
  1767.  
  1768. Table of Arexx commands
  1769. ========================
  1770.  
  1771.      Command name      Syntax                            Return Code(s)
  1772.      $*
  1773.      ABOUT.............ABOUT.............................Error code in RC
  1774.      APPEND............APPEND FILENAME/A, FORCE/S........Error code in RC
  1775.      CLEARALL..........CLEARALL..........................Error code in RC
  1776.      DESELECT..........DESELECT..........................Error code in RC
  1777.      DIAL..............DIAL..............................Error code in RC
  1778.      EDIT..............EDIT ADDRESS/K, FIRST/K,
  1779.                        NAME/K, STREET/K, ZIP/K, CITY/K,
  1780.                        COUNTRY/K, BIRTHDAY/K, PHONE/K,
  1781.                        EMAIL1/K, EMAIL2/K, EMAIL3/K,
  1782.                        FAX/K, COMMENT/K, SELECT/S........Error code in RC
  1783.      FIRST.............FIRST.............................Error code in RC
  1784.                                                          ADDRESS/M
  1785.      GETCURRENT........GETCURRENT........................Error code in RC
  1786.                                                          ADDRESS/M
  1787.      ICONIFY...........ICONIFY...........................Error code in RC
  1788.      KILL..............KILL..............................Error code in RC
  1789.      LAST..............LAST..............................Error code in RC
  1790.                                                          ADDRESS/M
  1791.      LOAD..............LOAD FILENAME/A,FORCE/S...........Error code in RC
  1792.      NEW...............NEW ADDRESS/K, FIRST/K, NAME/K,
  1793.                        STREET/K, ZIP/K, CITY/K,
  1794.                        COUNTRY/K, BIRTHDAY/K, PHONE/K,
  1795.                        EMAIL1/K, EMAIL2/K, EMAIL3/K,
  1796.                        FAX/K, COMMENT/K, SELECT/S........Error code in RC
  1797.      NEXT..............NEXT..............................Error code in RC
  1798.                                                          ADDRESS/M
  1799.      NEXTSEL...........NEXTSEL...........................Error code in RC
  1800.                                                          ADDRESS/M
  1801.      POPUP.............POPUP.............................Error code in RC
  1802.      PREV..............PREV..............................Error code in RC
  1803.                                                          ADDRESS/M
  1804.      PREVSEL...........PREVSEL...........................Error code in RC
  1805.                                                          ADDRESS/M
  1806.      PRINT.............PRINT WHICH/K, FILE/K, NLQ/S,
  1807.                        CONDENSED/S, FORMFEED/S, FORM/N...Error code in RC
  1808.      SAVE..............SAVE..............................Error code in RC
  1809.      SAVEAS............SAVEAS FILENAME/A,FORCE/S.........Error code in RC
  1810.      SAVEASDEFAULT.....SAVEASDEFAULT.....................Error code in RC
  1811.      SEARCH............SEARCH PATTERN/A, IGNORECASE/S,
  1812.                        FIELDS/K..........................Error code in RC
  1813.                                                          ADDRESS/M
  1814.      SEARCHNEXT........SEARCHNEXT........................Error code in RC
  1815.                                                          ADDRESS/M
  1816.      SELALL............SELALL............................Error code in RC
  1817.      SELBYNAME.........SELBYNAME PATTERN/A...............Error code in RC
  1818.      SELECT............SELECT QUERY/S....................Error code in RC
  1819.                                                          SELECTED/N
  1820.      SORT..............SORT..............................Error code in RC
  1821.  
  1822.  
  1823. Miscellaneous
  1824. **************
  1825.  
  1826.    * *`DFA' is fontsensitiv*
  1827.  
  1828.      `DFA'  adapts  itself  completely to the fonts you selected in the
  1829.       font  preferences program of the Workbench!  This means that  the
  1830.       window  will  become bigger, if you select a font larger  than  8
  1831.       points!  If the window becomes too large to fit into the screen,
  1832.      `DFA' uses the default topaz 8 point font.
  1833.  
  1834.    * *More than one `DFA' simultaneously?*
  1835.  
  1836.      It  is  not possible to run more than one `DFA' application at the
  1837.      same time!  If you try, the `DFA', which is already running pops
  1838.      up and comes to front.
  1839.  
  1840.    * *Window Positions*
  1841.  
  1842.      `DFA' remembers the positions of all its windows.  This means that
  1843.      the windows reopen on the same place you closed them!  Saving of
  1844.      the window positions takes place when saving the preferences.
  1845.      Remember that you have to register to be able to do this.  The
  1846.      window positions are stored relatively to the `DFA' main window! 
  1847.      This means, if you move the main window, the subwindows reopen at
  1848.      the same place as before considering the space between the main
  1849.      window and the subwindow.
  1850.  
  1851.    * *The Application Icon*
  1852.  
  1853.      The application icon can only be created, if the corresponding
  1854.      `.info' file exists.  This means that even if you start `DFA' only
  1855.      from the CLI, you should not delete this file!
  1856.  
  1857.    * *The Keyfile*
  1858.  
  1859.      On the disk that *registered* users get, there is a so called
  1860.      keyfile. You never should change anything within this file, because
  1861.      `DFA' will not recognize it if you do so!
  1862.  
  1863.  
  1864. Hints and Tips
  1865. ***************
  1866.  
  1867.    * *Export of addresses to other programs*
  1868.  
  1869.      Since version 1.1 of `DFA' has been finished, the export of
  1870.      addresses to other programms can easily be done by using the AREXX
  1871.      interface.  If the other programm doesn't have an AREXX port, you
  1872.      can at least use `DFA''s AREXX port to bring the addresses to a
  1873.      format understood by the other program.
  1874.  
  1875.    * *Import of existing address databases into `DFA'*
  1876.  
  1877.      The import of addresses can also be done using the AREXX port of
  1878.      `DFA' (command:  `NEW').
  1879.  
  1880.    * *The format of a `DFA' address file*
  1881.  
  1882.      The address file of `DFA' is organized by the line.  The very
  1883.      first line contains the recognition header of `DFA', which makes
  1884.      sure that only correct databases are loaded.  The header is
  1885.      `DFAddress1.1'.  Behind this header come all the addresses.  One
  1886.      address has the format following:
  1887.  
  1888.         - Name
  1889.  
  1890.         - First name
  1891.  
  1892.         - Street/No.
  1893.  
  1894.         - Zip
  1895.  
  1896.         - Town
  1897.  
  1898.         - Country
  1899.  
  1900.         - Birthday
  1901.  
  1902.         - Phone number
  1903.  
  1904.         - Email address # 1
  1905.  
  1906.         - Email address # 2
  1907.  
  1908.         - Email address # 3
  1909.  
  1910.         - Comment
  1911.  
  1912.         - [ Status flag ]
  1913.  
  1914.         - Address
  1915.  
  1916.         - Telefax number
  1917.  
  1918.      If the status flag is set (`1') the address is selected, otherwise
  1919.      (`0') it isn't.
  1920.  
  1921.      The street number is saved in the same line as the street name.
  1922.  
  1923.      `Address' und `Telefax' are positioned in the end, because these
  1924.      entries didn't exist in version 1.0 and in this way it has been
  1925.      easier to give the version 1.1 the possibility to read V1.0 address
  1926.      files.
  1927.  
  1928.  
  1929. Registration
  1930. *************
  1931.  
  1932. Registered users may skip the section; all others should read it
  1933. *attentively*:
  1934.  
  1935. Before you register, you have the opportunity to test `DFA' in great
  1936. detail.  However, when using the unregistered version you can't save
  1937. the preferences (this feature is disabled).  So you have to use the
  1938. defaults.  The tooltypes can be changed of course.
  1939.  
  1940. As long as you don't register, the address file is always `s:adr.file'
  1941. in `DFA''s home directory. You always have an application icon on your
  1942. Workbench that can't be put to a different place on the screen. The
  1943. modem parameters can't be changed. The window positions are remembered
  1944. (during a `DFA' session), but not saved.
  1945.  
  1946. In spite of all this restrictions it should be possible to see if `DFA'
  1947. is what you expect. As soon as you use `DFA' regularly, please do
  1948. register!
  1949.  
  1950. The shareware fee amounts to German DM 20,- (US $ 15,-)
  1951.  
  1952. Additional payment for postage will be needed, if you live not in
  1953. Europa, to cover the air mail costs (see `Orderform' for details).
  1954.  
  1955. You'll get your personal keyfile that enables the features mentioned
  1956. above and a TeX manual (in German *and* English), a AmigaGuide manual
  1957. (German *and* English) and an ASCII manual (German *and* English
  1958. again). All manual files are on the disk only and *not* printed!
  1959.  
  1960. In this case people who have TeX and a printer are able to print the
  1961. documentation by themselves!
  1962.  
  1963. The current version of `DFA' is included on the disk as well of course!
  1964.  
  1965. Add another DM/US$ 10,- if you would like to get a printed manual.
  1966. Please mark on the registration form as appropriate.
  1967.  
  1968. As the manual makes about 50 pages up to now, it makes up a good part of
  1969. the whole weight. If I will have to send it via air mail, this means
  1970. that the postage by itself soon can be as much as the shareware fee. So,
  1971. please send me an additional amount of money to cover these costs, if
  1972. you live outside of Europa (see the `orderform' for details).
  1973.  
  1974. If you did already register, you'll notice that I rised the shareware
  1975. fee a bit. I didn't do this to earn more money, but to cover the
  1976. increasing costs that `DFA' causes.
  1977.  
  1978. Please allow about two weeks for delivery. Thanks.
  1979.  
  1980. You'll find my address below, *Note Bug Reports::.
  1981.  
  1982.  
  1983. Updates
  1984. ********
  1985.  
  1986. I'm continuously working on `DFA' and I'll publish updates from time to
  1987. time. These updates will be fed into the following electronic nets:
  1988.  
  1989.    * ADS Net
  1990.  
  1991.    * FRAS Net
  1992.  
  1993.    * AmiNet--FTP Server
  1994.  
  1995. If you have access to such a electronic net, you can get the latest
  1996. version of `DFA' quick and cheap.
  1997.  
  1998. I do prefer this kind of update by myself because it saves me a lot of
  1999. time (and money).
  2000.  
  2001. However, connection to electronic services it not availble to everyone.
  2002. For this reason you can get your update directly from me:
  2003.  
  2004.    * Send DM 10,- (Outside Europa: DM 15,- or US$ 10,-) and you'll get
  2005.      the latest version of `DFA' as soon as it is available. Please
  2006.      notice that this can last a few month from one version to the
  2007.      other, depending on how much time I'll find to work on `DFA'.
  2008.  
  2009.    * Alternatively you can send an stamped and selfaddressed envelope
  2010.      containing an empty disk.  I'll send the latest version of `DFA'
  2011.      to you as soon as it will become available.  Please notice that you
  2012.      have to use German or international stamps!
  2013.  
  2014. Feel free to pay more than requested, I don't mind...
  2015.  
  2016. Fred Fish will get `DFA' to include it in his library. However, it will
  2017. last a few weeks until `DFA' finds its was on these disks.
  2018.  
  2019. Please notice that all registered users, even if they only get a public
  2020. release (e.g. on a Fish disk), can use it without any restrictions, as
  2021. long as they did install their keyfile before.
  2022.  
  2023.  
  2024. Bug Reports
  2025. ************
  2026.  
  2027. The development of `DFA' already took quite a lot of time to do.
  2028. Furthermore Kai Iske has done his part to make `DFA' what it is today.
  2029. He got lots of my alpha and beta versions to test them.  Well -- it was
  2030. not always fun:-) He also pushed me to include commodity support and
  2031. the edit hooks, thus to be implemented in the version 1.0 already.
  2032.  
  2033. Since version 1.0 has been published, there have been many enhancements
  2034. and bug fixes (see history file for details).  All of you who made
  2035. suggestions for improvement of `DFA' or reported bugs I would like to
  2036. say thank you very much.
  2037.  
  2038. Unfortunately all this doesn't mean that `DFA' has no more bugs in it
  2039. (sorry).  Surely there are some of them hidden anywhere in the dephths
  2040. of the program. So I ask you to report any bugs you discover.  If you
  2041. have any ideas what should be improved in the future versions of `DFA',
  2042. please feel free to write, (mail or email, doesn't matter) giving me
  2043. any suggestions.
  2044.  
  2045. Since version V1.2 of `DFA' has been done, DFA has been localized
  2046. (Workbench 2.1 and better needed) and some people have been very busy
  2047. translating the catalog files:
  2048.  
  2049.    * the Finnish translation was done by Tomi Blinnikka
  2050.  
  2051.    * the Dutch translation was done by Rudi Bracke
  2052.  
  2053.    * the Dansk translation was done by Tommy Hansen
  2054.  
  2055.    * the French translation was done by Hans-Juergen Kohrs
  2056.  
  2057.    * the Swedish translation was done by Mathias Korsbaeck
  2058.  
  2059.    * the Italian translation was done by Benoit Mortier
  2060.  
  2061. My address for bug reports *and registration*:
  2062.  
  2063. Home address:
  2064.      Dirk Federlein
  2065.  
  2066.      Brunnengasse 11a
  2067.  
  2068.      8750 Aschaffenburg
  2069.  
  2070.      Germany
  2071.  
  2072.  
  2073. Study address:
  2074.      Dirk Federlein
  2075.  
  2076.      Am Sonnenberg 34
  2077.  
  2078.      8700 Wuerzburg
  2079.  
  2080.      Germany
  2081.  
  2082.  
  2083. E-Mail:
  2084.      UUCP: dirkf@alcmy.franken.de
  2085.  
  2086.      FIDO: 2:249/40.12
  2087.  
  2088.      FIDO: 2:242/14.26
  2089.  
  2090.  
  2091. If  you  want  to  transfer  the  registration  fee via bank transfer, 
  2092. please use the following bank address.  Remember, however,  that
  2093. transfering money between different countries may be quite expensive
  2094. for you *and me*.
  2095.  
  2096. Bank address:
  2097.      Bayerische Vereinsbank Aschaffenburg
  2098.  
  2099.      GERMANY
  2100.  
  2101.      BLZ: 795 200 75
  2102.  
  2103.      No.: 160 6 140
  2104.  
  2105. E-mail reaches me always, no matter to which of the above addresses you
  2106. write, because netmail is rerouted automatically.  If you prefer to
  2107. send "normal" mail to Wuerzburg during the holidays, it may last quite
  2108. a long time until you'll get an answer because during the holidays I'm
  2109. not in Wuerzburg quite often.  If you don't know to which address you
  2110. should write, just send the letter to Aschaffenburg, in which case it
  2111. will reach me surely.
  2112.  
  2113. *I hope you'll enjoy using DFA*
  2114.  
  2115. *Yours.* *Dirk Federlein*
  2116.  
  2117.  
  2118. Index
  2119. ******
  2120.  
  2121. * Menu:
  2122.  
  2123. * ABOUT:                                ArexxTable.
  2124. * ABOUT:                                Arexx function ABOUT.
  2125. * About:                                About.
  2126. * Addresses:                            Info.
  2127. * Append:                               Append.
  2128. * APPEND:                               Arexx function APPEND.
  2129. * APPEND:                               ArexxTable.
  2130. * Arexx Commands:                       ArexxCommands.
  2131. * Arexx commands:                       ArexxTable.
  2132. * Arexx function About:                 Arexx function ABOUT.
  2133. * Arexx function Append:                Arexx function APPEND.
  2134. * Arexx function Clearall:              Arexx function CLEARALL.
  2135. * Arexx function Deselect:              Arexx function Deselect.
  2136. * Arexx function Dial:                  Arexx function DIAL.
  2137. * Arexx function Edit:                  Arexx function Edit.
  2138. * Arexx function First:                 Arexx function FIRST.
  2139. * Arexx function Getcurrent:            Arexx function Getcurrent.
  2140. * Arexx function Iconify:               Arexx function ICONIFY.
  2141. * Arexx function Kill:                  Arexx function KILL.
  2142. * Arexx function Last:                  Arexx function LAST.
  2143. * Arexx function Load:                  Arexx function LOAD.
  2144. * Arexx function New:                   Arexx function New.
  2145. * Arexx function Next:                  Arexx function NEXT.
  2146. * Arexx function Nextsel:               Arexx function NEXTSEL.
  2147. * Arexx function Popup:                 Arexx function POPUP.
  2148. * Arexx function Prev:                  Arexx function PREV.
  2149. * Arexx function Prevsel:               Arexx function PREVSEL.
  2150. * Arexx function Print:                 Arexx function PRINT.
  2151. * Arexx function Save:                  Arexx function SAVE.
  2152. * Arexx function Saveas:                Arexx function SAVEAS.
  2153. * Arexx function Saveasdefault:         Arexx function SAVEASDEFAULT.
  2154. * Arexx function Search:                Arexx function SEARCH.
  2155. * Arexx function Searchnext:            Arexx function SEARCHNEXT.
  2156. * Arexx function Selall:                Arexx function SELALL.
  2157. * Arexx function Selbyname:             Arexx function SELBYNAME.
  2158. * Arexx function Select:                Arexx function SELECT.
  2159. * Arexx function Sort:                  Arexx function SORT.
  2160. * Arexx Port:                           Info.
  2161. * Arexx-Skripts:                        ByHand.
  2162. * Basics:                               Basics.
  2163. * Bug Reports:                          Bug Reports.
  2164. * Catalog files:                        ByHand.
  2165. * Changing the DFA Preferences:         Changing the DFA Preferences.
  2166. * Changing the Tool Types:              Changing the Tool Types.
  2167. * Check Boxes:                          Usage of DFA.
  2168. * CLEARALL:                             ArexxTable.
  2169. * CLEARALL:                             Arexx function CLEARALL.
  2170. * Copyright:                            Copyright.
  2171. * CX_POPKEY:                            Start from Shell.
  2172. * CX_POPUP:                             Start from Shell.
  2173. * CX_PRIORITY:                          Start from Shell.
  2174. * Cycle Gadget:                         Usage of DFA.
  2175. * default tool:                         Quick Start.
  2176. * DESELECT:                             Arexx function Deselect.
  2177. * DESELECT:                             ArexxTable.
  2178. * DFA Step by Step:                     DFA Step by Step.
  2179. * DIAL:                                 ArexxTable.
  2180. * DIAL:                                 Arexx function DIAL.
  2181. * documentation:                        ByHand.
  2182. * EDIT:                                 ArexxTable.
  2183. * Edit:                                 Edit.
  2184. * EDIT:                                 Arexx function Edit.
  2185. * Edit Template:                        EditTemplate.
  2186. * FIRST:                                ArexxTable.
  2187. * FIRST:                                Arexx function FIRST.
  2188. * Full:                                 Full.
  2189. * General:                              General.
  2190. * GETCURRENT:                           Arexx function Getcurrent.
  2191. * GETCURRENT:                           ArexxTable.
  2192. * GUIDEFILE:                            Changing the Tool Types.
  2193. * GUIDEFILE:                            Start from Shell.
  2194. * Hints and Tips:                       Hints and Tips.
  2195. * History:                              History.
  2196. * ICONIFY:                              Arexx function ICONIFY.
  2197. * ICONIFY:                              ArexxTable.
  2198. * Info:                                 Info.
  2199. * Installation:                         Installation.
  2200. * Installation by Hand:                 ByHand.
  2201. * Installer:                            Installer.
  2202. * keyfile:                              ByHand.
  2203. * KILL:                                 Arexx function KILL.
  2204. * KILL:                                 ArexxTable.
  2205. * LAST:                                 Arexx function LAST.
  2206. * LAST:                                 ArexxTable.
  2207. * Listview:                             Usage of DFA.
  2208. * LOAD:                                 Arexx function LOAD.
  2209. * Load:                                 Load.
  2210. * LOAD:                                 ArexxTable.
  2211. * Memory  Condition:                    Info.
  2212. * Miscellaneous:                        Miscellaneous.
  2213. * New:                                  New.
  2214. * NEW:                                  Arexx function New.
  2215. * NEW:                                  ArexxTable.
  2216. * NEXT:                                 Arexx function NEXT.
  2217. * NEXT:                                 ArexxTable.
  2218. * NEXTSEL:                              ArexxTable.
  2219. * NEXTSEL:                              Arexx function NEXTSEL.
  2220. * Online Help:                          Usage of DFA.
  2221. * POPUP:                                Arexx function POPUP.
  2222. * POPUP:                                ArexxTable.
  2223. * PORTNAME:                             Start from Shell.
  2224. * Preferences:                          Preferences.
  2225. * PREV:                                 ArexxTable.
  2226. * PREV:                                 Arexx function PREV.
  2227. * PREVSEL:                              ArexxTable.
  2228. * PREVSEL:                              Arexx function PREVSEL.
  2229. * Print:                                Print.
  2230. * PRINT:                                Arexx function PRINT.
  2231. * PRINT:                                ArexxTable.
  2232. * public screen:                        Changing the Tool Types.
  2233. * PUBSCREEN:                            Changing the Tool Types.
  2234. * PUBSCREEN:                            Start from Shell.
  2235. * Quick Start:                          Quick Start.
  2236. * Quit:                                 Quit.
  2237. * Radio Button:                         Usage of DFA.
  2238. * Registration:                         Registration.
  2239. * Rexx: directory:                      ByHand.
  2240. * Save:                                 Save.
  2241. * SAVE:                                 ArexxTable.
  2242. * SAVE:                                 Arexx function SAVE.
  2243. * Save as default:                      Saveasdefault.
  2244. * Save as...:                           Saveas.
  2245. * SAVEAS:                               Arexx function SAVEAS.
  2246. * SAVEAS:                               ArexxTable.
  2247. * SAVEASDEFAULT:                        ArexxTable.
  2248. * SAVEASDEFAULT:                        Arexx function SAVEASDEFAULT.
  2249. * SEARCH:                               Arexx function SEARCH.
  2250. * Search:                               Search.
  2251. * SEARCH:                               ArexxTable.
  2252. * SEARCHNEXT:                           ArexxTable.
  2253. * SEARCHNEXT:                           Arexx function SEARCHNEXT.
  2254. * SELALL:                               Arexx function SELALL.
  2255. * SELALL:                               ArexxTable.
  2256. * SELBYNAME:                            ArexxTable.
  2257. * SELBYNAME:                            Arexx function SELBYNAME.
  2258. * SELECT:                               Arexx function SELECT.
  2259. * SELECT:                               ArexxTable.
  2260. * Settings:                             Settings.
  2261. * shareware fee:                        Registration.
  2262. * Shellstart:                           Start from Shell.
  2263. * SORT:                                 ArexxTable.
  2264. * SORT:                                 Arexx function SORT.
  2265. * Start from Shell:                     Start from Shell.
  2266. * String Gadget:                        Usage of DFA.
  2267. * Table of Arexx commands:              ArexxTable.
  2268. * Table of Arexx commands:              ArexxTable.
  2269. * The Arexx Commands:                   The Arexx Commands.
  2270. * The Arexx Port:                       The Arexx Port.
  2271. * The directory Rexx::                  ByHand.
  2272. * The Error Codes:                      The Error Codes.
  2273. * The Main Window:                      MainWindow.
  2274. * The Menus of DFA:                     The Menus of DFA.
  2275. * Updates:                              Updates.
  2276. * UPPERPUBSCREEN:                       Changing the Tool Types.
  2277. * UPPERPUBSCREEN:                       Start from Shell.
  2278. * Usage of DFA:                         Usage of DFA.
  2279. * Using the Installer Programm:         Installer.
  2280. * Warranty:                             Warranty.
  2281. * What the hell is DFA?:                What the hell is DFA?.
  2282.  
  2283.