home *** CD-ROM | disk | FTP | other *** search
/ AMIGA PD 1 / AMIGA-PD-1.iso / Programme_zum_Heft / Anwendungen / Kurztests / DFA / Documentation / English / Documentation.lha / dfa.guide (.txt) < prev    next >
Amigaguide Document  |  1994-10-03  |  208KB  |  4,210 lines
  1. @database dfa.guide
  2. @Master dfa.texi
  3. @Width 72
  4. This is the AmigaGuide
  5.  file dfa.guide, produced by Makeinfo-1.55 from 
  6. the input file dfa.texi.
  7. @Node Main "dfa.guide"
  8.                             DFA - DFAddress
  9.              the address utility for the Amiga and OS 2.0
  10.                 (C) Copyright 1992-1994 Dirk Federlein
  11.                     *** DFA is an SASG product ***
  12.                              - Shareware -
  13. This manual describes the installation and the usage of @{b}DFA@{ub} version
  14. 2.2. If you use a localized Workbench (Workbench V2.1 and better) and
  15. have set it to a language other than English, please notice that I'll
  16. refer to the English program texts in this documentation!
  17. Introduction...
  18.  @{"          Welcome!            " Link "Welcome"}         
  19.  @{"          Features            " Link "Features"}          
  20.  @{"         Installation         " Link "Installation"}               Before you can use DFA
  21.  @{"          Quick start         " Link "Quick Start"}               If someone just can't wait...
  22. Now the serious bit...
  23.  @{"      The concept of DFA      " Link "Concept"}               Concept? Which concept?
  24.  @{"         Usage of DFA         " Link "UsingDFA"}               Some basics
  25.  @{"   The DFA-Server program     " Link "DFAServer"}               Commodity, AREXX, ...
  26.  @{"   The DFA-Editor program     " Link "DFAEditor"}               Graphical user interface
  27.  @{" The DFA-Preferences program  " Link "DFAPrefs"}               Where you can set (nearly) everything
  28. Miscellaneous...
  29.  @{"         Legal stuff          " Link "Legal"}               Copyright, Status, etc.
  30.  @{"         Registration         " Link "Registration"}               How to register
  31.  @{"           Updates            " Link "Updates"}               New versions and how to get them
  32.  @{"          Bugreports          " Link "Bugreports"}               What shall we do with the bug reports
  33.  @{"     Important addresses      " Link "Addresses"}               The addresses of the author and the
  34.                                                registration sites
  35.  @{"          Internals           " Link "Internal"}          
  36.  @{" Configuration Requirements   " Link "MinConfig"}               Minimum hard- and software requirement
  37.  @{"          Some tips           " Link "Tips"}               What to do, if something doesn't work
  38.  @{"            Thanks            " Link "Thanks"}        
  39. To find things quickly, the...
  40.  @{"            Index             " Link "Index"} 
  41. @EndNode
  42. @Node "Welcome" "dfa.guide/Welcome"
  43. @Toc "Main"
  44. Welcome!
  45. ********
  46. Welcome to the documentation of @{b}DFA@{ub}! You did really manage it and
  47. forced yourself to read this manual! Please, do @{b}not@{ub} stop here, but
  48. continue reading - it will be to your advantage!
  49. Only by reading this manual carefully, can learn everything about the
  50. many different features of @{b}DFA@{ub}! Some of your questions - if not all of
  51. them - which you might have at this time, will be answered here.
  52. Please remember that I put a lot of time and effort (`blood, sweat and
  53. tears') into this manual -- please show your acknowledgement by reading
  54. this documentation (of course, you may feel free to register)!
  55.           @{b}Dirk Federlein@{ub}
  56. @EndNode
  57. @Node "Features" "dfa.guide/Features"
  58. @Toc "Main"
  59. Features
  60. ********
  61. @{b}DFA@{ub} supplies many outstanding features, some of them I'd like to
  62. mention here:
  63.    @{b}*@{ub} OS2.0 "Look and Feel"
  64.    @{b}*@{ub} Locale support (Workbench 2.1 and better needed)
  65.    @{b}*@{ub} OS3.0 is supported, if available
  66.    @{b}*@{ub} Commodity support, i.e. @{b}DFA@{ub} can be reached by hotkey or the
  67.      Exchange utility of the Workbench
  68.    @{b}*@{ub} All operations in @{b}DFA@{ub} are accessable via keyboard
  69.    @{b}*@{ub} The AREXX interface contains more than 30 commands
  70.    @{b}*@{ub} All windows of @{b}DFA@{ub} are font sensitive
  71.    @{b}*@{ub} The @{b}DFA-Editor@{ub} main window is font sensitive and @{b}resizable@{ub}
  72.    @{b}*@{ub} The @{b}DFA-Editor@{ub} main window is an application window
  73.    @{b}*@{ub} The program has been split into the editor, server and preferences
  74.      parts; by this the available memory is optimally used and @{b}DFA@{ub}
  75.      often needs even less memory than in version 1.2x
  76.    @{b}*@{ub} Program parts used by more than one part of @{b}DFA@{ub} have been exported
  77.      into a shared library, the @{b}dfa.library@{ub}
  78.    @{b}*@{ub} Button row, which contains the most important functions
  79.    @{b}*@{ub} Support of external files
  80.    @{b}*@{ub} Up to three EMail addresses per entry
  81.    @{b}*@{ub} Dial function (supports @{b}OwnDevUnit@{ub}) recognizes @{b}BUSY@{ub}, @{b}NO DIALTONE@{ub},
  82.      etc.
  83.    @{b}*@{ub} The addresses can be separated into groups
  84.    @{b}*@{ub} The groups can be named (incl. shortcut)
  85.    @{b}*@{ub} New fields @{b}state@{ub} and @{b}c/o@{ub}
  86.    @{b}*@{ub} Network support
  87.    @{b}*@{ub} Application icon (can be toggled)
  88.    @{b}*@{ub} It is possible to use @{b}DFA@{ub} as default tool
  89.    @{b}*@{ub} New "magic" icons (8 colors) by Martin Huttenloher
  90.    @{b}*@{ub} Icon generation for the address files can be switched off
  91.    @{b}*@{ub} The auto save feature can be configured
  92.    @{b}*@{ub} The format of the address listview can be changed
  93.    @{b}*@{ub} The display part in the main window of the @{b}DFA-Editor@{ub} can be
  94.      configured
  95.    @{b}*@{ub} Addresses can be sorted by any field of the address
  96.    @{b}*@{ub} The fonts for the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} can be changed
  97.    @{b}*@{ub} The utility @{b}NewEdit@{ub} is supported
  98.    @{b}*@{ub} The internal memory management was rewritten from scratch with the
  99.      consequence that the addresses now use much less RAM than in
  100.      version 1.2x
  101.    @{b}*@{ub} The usage of memory pools decreases memory fragmentation
  102.    @{b}*@{ub} The load and save routines have been rewritten from scratch and
  103.      are much faster now
  104. @EndNode
  105. @Node "Installation" "dfa.guide/Installation"
  106. @Toc "Main"
  107. Installation
  108. ************
  109. I strongly recommend use of the supplied install program to install
  110. @{b}DFA@{ub}. It extracts the needed file from their archives and copies
  111. them to the correct places on your harddisk. It sets all needed
  112. tooltypes as well.
  113. After the installation procedure has been completed, there exist the
  114. following files, or according to your installation at least some of
  115. them, on your harddisk:
  116.    @{b}*@{ub}     @{b}@{b}DFA@{ub}, @{b}DFA.info@{ub}@{ub}
  117.      The @{b}DFA-Server@{ub} program; it supplies the AREXX-Port and manages the
  118.      Application icon. Putting it into the @{b}WBStartup@{ub} drawer is a good
  119.      idea.
  120.    @{b}*@{ub}     @{b}@{b}DFAEditor@{ub}, @{b}DFAEditor.info@{ub}@{ub}
  121.      The graphical user interface of @{b}DFA@{ub}. If you want to start this
  122.      program from the Shell, please copy it into a drawer in your
  123.      search path, otherwise in any directory you like, e.g. @{b}DFA:c@{ub},
  124.      which is the default.
  125.    @{b}*@{ub}     @{b}@{b}DFAPrefs@{ub}, @{b}DFAPrefs.info@{ub}@{ub}
  126.      The preferences program for @{b}DFA@{ub}. All settings can be done from
  127.      within this program. A good place for it is the @{b}SYS:Prefs@{ub} or the
  128.      @{b}DFA:Prefs@{ub} directory.
  129.    @{b}*@{ub}     @{b}@{b}dfa.library@{ub}@{ub}
  130.      Must be in @{b}libs:@{ub} or in @{b}DFA:libs@{ub}. This library is needed by all
  131.      other parts of @{b}DFA@{ub}, i.e. the @{b}DFAServer@{ub}, the @{b}DFAEditor@{ub} and the
  132.      @{b}DFAPrefs@{ub} program.
  133.    @{b}*@{ub}     @{b}@{b}Registration@{ub}, @{b}Registration.info@{ub}@{ub}
  134.      This is the new registration program of the @{b}SASG@{ub}. This program
  135.      makes it possible to register or update in a very comfortable and
  136.      fast way. Furthermore it contains detailed information about the
  137.      @{b}SASG@{ub} and the @{b}advantages@{ub} that @{b}you@{ub} may take out of it.
  138.    @{b}*@{ub}     @{b}@{b}DFA.guide@{ub}@{ub}
  139.      The AMIGAGUIDE documentation of @{b}DFA@{ub}. To read the file you need
  140.      e.g. the @{b}AmigaGuide@{ub} or the @{b}Multiview@{ub} program.
  141.    @{b}*@{ub}     @{b}@{b}DFA.dvi@{ub}@{ub}
  142.      The manual in the @{b}DVI@{ub} format. To look at it or print it you need
  143.      TeX (e.g. PasTeX (C) Georg He
  144. mann).
  145.    @{b}*@{ub}     @{b}@{b}DFAEditor.guide@{ub}@{ub}
  146.      The online help for the @{b}DFA-Editor@{ub}; it can be found  in
  147.      @{b}Help:<language>@{ub} or in the drawer you selected during the
  148.      installing procedure.
  149.    @{b}*@{ub}     @{b}@{b}DFAPrefs.guide@{ub}@{ub}
  150.      The online help for the @{b}DFA-Preferences@{ub} program; it can be found
  151.      in @{b}Help:<language>@{ub} or in the drawer you selected during the
  152.      installing procedure.
  153.    @{b}*@{ub}     @{b}@{b}dfa.key@{ub}@{ub}
  154.      If you've got a registered version of @{b}DFA@{ub}, you can find the
  155.      so-called keyfile @{b}dfa.key@{ub} in the @{b}s@{ub} drawer of the distribution.
  156.      To give @{b}DFA@{ub} the chance to find the keyfile you either have to copy
  157.      it to the @{b}s:@{ub} drawer of your boot partition (default) or, if you
  158.      prefer another directory for your keyfile, you will have to set
  159.      the environment variable @{b}KEYPATH@{ub} to this @{b}drawer@{ub}.
  160.           Example:
  161.           
  162.           setenv KEYPATH ENV:DFA
  163.      Usually the install program has already done this for you.
  164.    @{b}*@{ub}     @{b}@{b}s/adr.file@{ub}@{ub}
  165.      The default address file. It contains the address of the program
  166.      author. This can be useful for bug reports and -- most of all --
  167.      when you want to register.
  168.    @{b}*@{ub}     @{b}@{b}rexx/#?.ced@{ub}@{ub}
  169.      AREXX scripts for the CED ((C) 1987-1993 CYGNUSSOFT SOFTWARE)
  170.      working together with @{b}DFA@{ub}. The explanation of each AREXX script
  171.      can be found in the scripts.
  172.    @{b}*@{ub}     @{b}@{b}rexx/#?.dfa@{ub}@{ub}
  173.      AREXX scripts that can be started directly out of the @{b}DFA-Editor@{ub}
  174.      (via the function keys).
  175.    @{b}*@{ub}     @{b}@{b}rexx/#?.rexx@{ub}@{ub}
  176.      AREXX scripts that can be be started out of the shell (using the
  177.      @{b}rx@{ub} command.
  178.    @{b}*@{ub}     @{b}@{b}locale/Catalogs/<language>/#?.catalog@{ub}@{ub}
  179.      In each @{b}language@{ub} directory (e.g. @{b}deutsch@{ub} you can find the catalog
  180.      files that are needed for the locale support (Workbench 2.1 and
  181.      better needed). Usually the installer script has already copied
  182.      the needed files to the correct drawers.
  183. @EndNode
  184. @Node "Quick Start" "dfa.guide/Quick Start"
  185. @Toc "Main"
  186. Quick Start
  187. ***********
  188. After you have installed @{b}DFA@{ub} (see @{"Installation" Link "Installation"}, for more information),
  189. the builtin default settings are used. These settings already allow you
  190. to use @{b}DFA@{ub} and take a lot of advantage out of it. Please notice that
  191. the @{b}huge@{ub} amount of settings, which can be tuned in the @{b}DFA-Preferences@{ub}
  192. program, can only be saved in the @{b}registered@{ub} version (see
  193. @{"The DFA-Preferences program" Link "DFAPrefs"} and @{"Registration" Link "Registration"} for details)!
  194. If you copied the @{b}DFA-Server@{ub} (filename @{b}DFA@{ub}) into the @{b}WBStartup@{ub} drawer,
  195. as it is recommended by the install program, @{b}DFA@{ub} will be started, each
  196. time the computer starts up; futhermore, an application icon for @{b}DFA@{ub} is
  197. supplied on the Workbench screen.
  198. This behaviour of @{b}DFA@{ub} can be changed as described in @{"Tooltypes" Link "ServerTooltypes"} and
  199. @{"The DFA-Preferences program" Link "DFAPrefs"}.
  200. As @{b}DFA@{ub} tries to follow the "User Interface Style Guide" as closely as
  201. possible, it should be no problem (at least for advanced users) to
  202. figure out all the functions of @{b}DFA@{ub} according to "trial and error".  If
  203. you don't want any bad (?) surprises, just continue reading...
  204. @EndNode
  205. @Node "Concept" "dfa.guide/Concept"
  206. @Toc "Main"
  207. The concept of DFA
  208. ******************
  209. Since version 2.0 of @{b}DFA@{ub} has been finished, it is no longer a single
  210. program, but consists of several parts: The @{b}DFA-Server@{ub} (see
  211. @{"The DFA-Server program" Link "DFAServer"}), the @{b}DFA-Editor@{ub} (see @{"The DFA-Editor program" Link "DFAEditor"})
  212. and the @{b}DFA-Preferences@{ub} program (see @{"The DFA-Preferences program" Link "DFAPrefs"}).
  213. Certain functions that are used by more than one of these programs have
  214. been exported into a socalled "shared library", the @{b}dfa.library@{ub}.
  215. By doing so it is possible now that @{b}DFA@{ub} often uses less RAM than in
  216. former versions of @{b}DFA@{ub}, even though it contains many enhancements! If
  217. @{b}DFA@{ub} would still have been one single program it would have been a size
  218. of about 250 KB and nearly noone would have copied it into the
  219. @{b}WBStartup@{ub} drawer.
  220. In spite of splitting the program into several parts, I tried to keep
  221. the known handling of @{b}DFA@{ub}: One should think he works with one single
  222. program. To do so, the @{b}DFA-Server@{ub} calls the @{b}DFA-Editor@{ub} after the user
  223. hits the hotkey; the @{b}DFA-Preferences@{ub} program on the other side can be
  224. reached directly out of the @{b}DFA-Editor@{ub} by selecting the corresponding
  225. menu item.
  226. This new concept will although be useful for people that start @{b}DFA@{ub} on
  227. demand only and therefore don't need the AREXX and the Commodity part
  228. of @{b}DFA@{ub}; these people may start the @{b}DFA-Editor@{ub} directly (from the
  229. Workbench or Shell) and save the memory the @{b}DFA-Server@{ub} would have taken
  230. (about 35 KB).
  231. @EndNode
  232. @Node "UsingDFA" "dfa.guide/UsingDFA"
  233. @Toc "Main"
  234. Usage of DFA
  235. ************
  236. You can control @{b}DFA@{ub} by mouse as usual as well as @{b}completely@{ub} by keyboard.
  237. Some notes to the usage of the keyboard:
  238.    @{b}*@{ub}     @{b}Button Gadgets@{ub}
  239.      All Gadgets have a corresponding text.  In this text you'll find
  240.      one character @{b}underlined@{ub}.  This character is the "shortcut" to the
  241.      gadget.  To use this shortcut, just push the corresponding key.
  242.      You don't have to push any qualifier like @{b}CONTROL@{ub} or @{b}ALT@{ub}.  To
  243.      simple buttons it doesn't matter if you push the "normal" or the
  244.      capital letter.  To other gadgets it can make a difference (see
  245.      below for details).
  246.    @{b}*@{ub}     @{b}Listviews@{ub}
  247.      Listviews are used in the @{b}DFA-Editor@{ub} as well as in the
  248.      @{b}DFA-Preferences@{ub} program. There are two different types of
  249.      listviews: Listviews in which you can select entries (raised
  250.      border), e.g. the address listview in the @{b}DFA-Editor@{ub} main window,
  251.      and listviews that only display information (recessed border), e.g.
  252.      the listview in the @{b}DFA-Editor@{ub} full window.
  253.      If not mentioned otherwise, all listviews can be used as follows:
  254.      @{b}Input listview:@{ub}
  255.             Shortcut         The next entry becomes the active one,
  256.                              the list scrolls accordingly.
  257.           Shift Shortcut     The previous entry becomes the active one,
  258.                              the list scrolls accordingly.
  259.      @{b}Read only listview:@{ub}
  260.             Shortcut         The list scrolls @{b}up@{ub}.
  261.           Shift Shortcut     The list scrolls @{b}down@{ub}.
  262.      Sometimes the listviews can be controlled by the cursor keys or it
  263.      is possible to scroll page by page. If this is the case, the
  264.      enhanced usage of that particular listview is described seperately
  265.      on that place.
  266.    @{b}*@{ub}     @{b}Cycle Gadgets@{ub}
  267.      In front of a cycle gadget there is short text, which describes the
  268.      function of the gadget. Again there is one character underlined.
  269.      However, here it does matter if you use the capital letter or not.
  270.      The "normal" letter cycles foreward, the capital letter backward.
  271.    @{b}*@{ub}     @{b}Radio Buttons@{ub}
  272.      Only one of the buttons that belong together can be activated at
  273.      once.  You can select an entry by pushing the proper shortcut.
  274.      The case of the shortcut is not important.
  275.    @{b}*@{ub}     @{b}Check Boxes@{ub}
  276.      A check box can be selected (shown by a tick) or deselected
  277.      ("blank"). You can switch the current state by pushing the
  278.      corresponding hotkey.
  279.    @{b}*@{ub}     @{b}String Gadgets@{ub}
  280.      The string gadgets have the same functions as the "original" string
  281.      gadgets.  However, I added some features, which should make them
  282.      easier to use:
  283.         - Hit @{b}RETURN@{ub} to end the input to the current gadget and go to
  284.           the next string or integer gadget. You may use the @{b}ENTER@{ub} key
  285.           alternatively.
  286.         - Hit @{b}SHIFT@{ub} @{b}RETURN@{ub} to end the input to the current gadget and
  287.           go to the @{b}previous@{ub} gadget.
  288.         -     @{b}CURSOR UP@{ub} or @{b}CURSOR DOWN@{ub} brings the cursor to the
  289.           previous or next string gadget respectively.
  290.         - Hit @{b}ESCAPE@{ub} to cancel the input completely.  The window which
  291.           contains the gadget is closed and all previous input is
  292.           discarded.
  293.         - If the cursor stands within a string gadget, the shortcuts can
  294.           be reached by hitting @{b}RIGHT AMIGA@{ub}-@{b}<letter>@{ub} and @{b}SHIFT@{ub}.  If you
  295.           don't hit @{b}SHIFT@{ub} additionally, the keyboard shortcut is used
  296.           either by the internal string gadget edit features (like
  297.           @{b}RIGHT AMIGA X@{ub} or @{b}RIGHT AMIGA Q@{ub}) or by additional tools like
  298.           @{b}NewList@{ub}.
  299.      You activate an string gadget by pushing the according shortcut.
  300.      Usually there is no difference if you hit the upper case or the
  301.      lower case character, as long as there is no button gadget behind
  302.      the string gadget. This button gadget that contains a small symbol
  303.      instead of text, activates a requester, which allows a more
  304.      comfortable input in the string gadget infront of it. If there is
  305.      such a button, you activate the string gadget with the lower case
  306.      key and the button gadget behind the string gadget with the upper
  307.      case key.
  308.    @{b}*@{ub}     @{b}Text Gadgets@{ub}
  309.      Usually text gadgets don't have a shortcut, as they only display
  310.      text, but don't allow any input. Some text gadgets however have a
  311.      small button gadget behind them (cf. @{b}DFA-Preferences@{ub}:
  312.      Font-Preferences) After you have hit this gadget a requester pops
  313.      up and you may select an entry which is displayed in the text
  314.      gadget as soon as you've completed the requester. Therefore the
  315.      gadget shortcut doesn't refer to the text gadget itself, but to
  316.      the button gadget behind it.
  317.    @{b}*@{ub}     @{b}Online Help@{ub}
  318.      Since version 1.2 has been finished, @{b}DFA@{ub} supports an @{b}Online Help@{ub}
  319.      feature. To invoke it, just hit the @{b}Help@{ub} key and the help window
  320.      pops up. Please remember that the @{b}GUIDEFILE@{ub} tooltype of the
  321.      @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program have to be set
  322.      correctly. The installer program usually has already done this for
  323.      you.
  324. @EndNode
  325. @Node "DFAServer" "dfa.guide/DFAServer"
  326. @Toc "Main"
  327. The DFA-Server program
  328. **********************
  329. The @{b}DFA-Server@{ub} (filename: @{b}DFA@{ub}) supplies the commodity features (hotkey,
  330. access by the @{b}Exchange@{ub} program) and contains the complete AREXX
  331. interface; furthermore it manages the application icon.
  332.  @{"      Tooltypes      " Link "ServerTooltypes"}                 
  333.  @{"    CLI parameter    " Link "ServerCLIParams"}                 
  334.  @{"      Commodity      " Link "Commodity"}           
  335.  @{"  Application icon   " Link "AppIcon"}         
  336.  @{"   Arexx interface   " Link "Arexx"} 
  337. @EndNode
  338. @Node "ServerTooltypes" "dfa.guide/ServerTooltypes"
  339. @Next "ServerCLIParams"
  340. @Toc "DFAServer"
  341. Tooltypes
  342. =========
  343. If you click on the icon of the @{b}DFA-Server@{ub} program once and activate
  344. the information program from the Workbench menu you may change the
  345. following tooltypes:
  346.    @{b}*@{ub}     @{b}@{b}ADDRESSFILE@{ub}@{ub}
  347.      If you use this tooltype, you can change the name of the address
  348.      file that will be loaded by @{b}DFA@{ub} during startup (e.g.
  349.      @{b}ADDRESSFILE=MyAddresses.dfa@{ub}).  Please notice that in this case the
  350.      file you set in the @{b}DFA-Preferences@{ub} program is not used.
  351.    @{b}*@{ub}     @{b}@{b}CX_POPKEY@{ub}@{ub}
  352.      The preset hotkey is @{b}LCOMMAND F5@{ub}, i.e. you can pop up the
  353.      @{b}DFA-Editor@{ub} by pushing @{b}Left Amiga F5@{ub} (cf. @{b}CX_POPUP@{ub}).
  354.      You can change this hotkey using the following keywords:
  355.           LSHIFT      left shift key
  356.           RSHIFT      right shift key
  357.           CAPSLOCK    caps lock key
  358.           CONTROL     control key
  359.           LALT        left alt key
  360.           RALT        right alt key
  361.           LCOMMAND    left AMIGA key
  362.           RCOMMAND    right AMIGA key
  363.           NUMERICPAD  numeric pad
  364.           MIDBUTTON   middle mouse button
  365.           RBUTTON     right mouse button
  366.           LEFTBUTTON  left mouse button
  367.           F1-F10      function keys 1 to 10
  368.           UP          cursor up
  369.           DOWN        cursor down
  370.           LEFT        cursor left
  371.           RIGHT       cursor right
  372.           HELP        help key
  373.           DEL         del key
  374.           RETURN      return key
  375.           ENTER       enter key on the numeric pad; notice that you have
  376.                       to set @{b}NUMERICPAD@{ub} as well!
  377.           BACKSPACE   backspace key
  378.           ESC         escape key
  379.           SPACE       space key
  380.           COMMA       comma key
  381.           UPSTROKE    upstroke key
  382.           A..Z, a..z  "usual" keys
  383.           0..9, etc.
  384.      You can "mix" these keys, for example:
  385.         -     @{b}LSHIFT CONTROL F1@{ub}
  386.         -     @{b}LALT CONTROL D@{ub}
  387.         -     @{b}CONTROL NUMERICPAD ENTER@{ub}
  388.         -     @{b}RCOMMAND RSHIFT A@{ub}
  389.    @{b}*@{ub}     @{b}@{b}CX_POPUP@{ub}@{ub}
  390.      If you set @{b}CX_POPUP=YES@{ub}, you make the @{b}DFA-Server@{ub} calling the
  391.      @{b}DFA-Editor@{ub} immediately after startup.  Set @{b}CX_POPUP=NO@{ub} to keep @{b}DFA@{ub}
  392.      "quiet" until you pop up the @{b}DFA-Editor@{ub} by hitting the hotkey or
  393.      clicking on the application icon or by starting the @{b}DFA-Editor@{ub}
  394.      directly from the Workbench or the Shell.
  395.    @{b}*@{ub}     @{b}@{b}CX_PRIORITY@{ub}@{ub}
  396.      With this tool type you can change the Priority of the @{b}DFA@{ub}
  397.      commodity part. The default setting of @{b}CX_Priority=0@{ub} usually
  398.      doesn't need to be changed. For more information look up your
  399.      manual to the @{b}AMIGA-OS@{ub}.
  400.    @{b}*@{ub}     @{b}@{b}DFAEDITOR@{ub}@{ub}
  401.      This tooltype contains the filename (incl. the full path) that is
  402.      used by the @{b}DFA-Server@{ub} to call the @{b}DFA-Editor@{ub}. The install program
  403.      has usually set this tooltype according to your wishes, you only
  404.      have to change anything if you copied the @{b}DFA-Editor@{ub} manually to
  405.      another place on your harddisk.
  406.    @{b}*@{ub}     @{b}@{b}DONOTWAIT@{ub}@{ub}
  407.      This is a system tooltype, which forces the Workbench not to wait
  408.      for @{b}DFA@{ub} ending.  You should @{b}not@{ub} remove this tool type.
  409.    @{b}*@{ub}     @{b}@{b}PORTNAME@{ub}@{ub}
  410.      @{b}DFA@{ub} uses @{b}DFA@{ub} for the portname.  If there is another program with
  411.      the same portname, @{b}DFA@{ub} attaches numbers (@{b}DFA.1@{ub}, @{b}DFA.2@{ub}, etc.) until
  412.      a definite name is found.  However, if you want your "own"
  413.      portname, you can set it using the tool type @{b}PORTNAME@{ub} (e.g.
  414.      @{b}PORTNAME=OtherDFAPortname@{ub}).  Please remember that you have to
  415.      adapt all example AREXX scripts, if you change the portname!
  416. @EndNode
  417. @Node "ServerCLIParams" "dfa.guide/ServerCLIParams"
  418. @Next "Commodity"
  419. @Prev "ServerTooltypes"
  420. @Toc "DFAServer"
  421. CLI-Parameter
  422. =============
  423. If you start @{b}DFA@{ub} from Workbench the tooltypes described above will be
  424. used. When you start @{b}DFA@{ub} from Shell, these tooltypes are used as well,
  425. as long as the corresponding @{b}.info@{ub}-File is present. You can give the
  426. following parameters to @{b}DFA@{ub} that overwrite the previous settings
  427. (within the .info file). The possible arguments are described below:
  428. @{b}ADDRESSFILE/K@{ub}, @{b}CX_POPKEY/K@{ub}, @{b}CX_PRIORITY/N@{ub}, @{b}CX_POPUP/K@{ub}, @{b}PORTNAME/K@{ub},
  429. @{b}DFAEDITOR/K@{ub}
  430. This means, you may...
  431.    ... set the hotkey to @{b}Left Amiga F1@{ub} by @{b}DFA CX_POPUP="LCOMMAND F1"@{ub}
  432.    ... set the AREXX port to @{b}MyArexxPort@{ub} by @{b}DFA PORTNAME=MyArexxPort@{ub}
  433.    ... load the alternate address file @{b}MyAddresses.dfa@{ub} by @{b}DFA
  434.      ADDRESSFILE=MyAddresses.dfa@{ub}
  435. @EndNode
  436. @Node "Commodity" "dfa.guide/Commodity"
  437. @Next "AppIcon"
  438. @Prev "ServerCLIParams"
  439. @Toc "DFAServer"
  440. Commodity
  441. =========
  442. By pushing the hotkey (see @{"Tooltypes" Link "ServerTooltypes"}) you may envoke the @{b}DFA-Editor@{ub}.
  443. You'll get the same effect, if you start the @{b}Exchange@{ub} program of the
  444. Workbench and select @{b}Show Interface@{ub}.
  445. Using the @{b}Exchange@{ub} program you can although stop @{b}DFA@{ub} (hit @{b}Remove@{ub}) or to
  446. make it inactive (hit @{b}Inactive@{ub}) or active respectively.
  447. @EndNode
  448. @Node "AppIcon" "dfa.guide/AppIcon"
  449. @Next "Arexx"
  450. @Prev "Commodity"
  451. @Toc "DFAServer"
  452. Application-Icon
  453. ================
  454. The application icon supplies two functions:
  455.    @{b}*@{ub} A double click on it activates the @{b}DFA-Editor@{ub}.
  456.    @{b}*@{ub} If you let the icon of an address file "fall" on the application
  457.      icon, the @{b}DFA-Editor@{ub} is started and the according address file is
  458.      loaded.
  459. @EndNode
  460. @Node "Arexx" "dfa.guide/Arexx"
  461. @Prev "AppIcon"
  462. @Toc "DFAServer"
  463. Arexx
  464. =====
  465.  @{"          Important!          " Link "ArexxImportant"}                       New since version 1.2x
  466.  @{"            Basics            " Link "ArexxBasics"}                       Basics of  Arexx
  467.  @{" Format of the Address Field  " Link "ArexxReturnAddress"}                    
  468.  @{"        Arexx commands        " Link "ArexxCommands"}               
  469.  @{"          Error codes         " Link "ArexxErrorCodes"}                       Extended error codes
  470. @EndNode
  471. @Node "ArexxImportant" "dfa.guide/ArexxImportant"
  472. @Next "ArexxBasics"
  473. @Toc "Arexx"
  474. Important -- new features since version 1.2x
  475. --------------------------------------------
  476. The AREXX interface has been rewritten from scratch for @{b}DFA@{ub} 2.0. Some
  477. commands have been added...
  478.    @{b}*@{ub} ATTEMPTLOCK
  479.    @{b}*@{ub} CHANGEGROUPS
  480.    @{b}*@{ub} FREELOCK
  481.    @{b}*@{ub} NEWFILE
  482. ... some old commands have been changed or improved regarding their
  483. syntax:
  484.    @{b}*@{ub} APPEND
  485.    @{b}*@{ub} EDIT
  486.    @{b}*@{ub} KILL
  487.    @{b}*@{ub} LOAD
  488.    @{b}*@{ub} NEW
  489.    @{b}*@{ub} SAVEAS
  490.    @{b}*@{ub} SEARCH
  491. Most of all, however, I've changed the order of the fields within an
  492. address item, which is returned by several commands like @{b}FIRST@{ub}, @{b}NEXT@{ub},
  493. @{b}GETCURRENT@{ub}, etc.
  494. The reason for doing so is that I thought it would be a good idea to
  495. have the same order of the fields in the AREXX interface as in the
  496. @{b}DFA-Editor@{ub} edit window, as this makes it a lot easier to remember which
  497. meaning the different numbers of an address field have (cf.
  498. @{"Format of the address field" Link "ArexxReturnAddress"}).
  499. @EndNode
  500. @Node "ArexxBasics" "dfa.guide/ArexxBasics"
  501. @Next "ArexxReturnAddress"
  502. @Prev "ArexxImportant"
  503. @Toc "Arexx"
  504. Basics
  505. ------
  506. @{b}DFA@{ub} (i.e. the @{b}DFA-Server@{ub}) usually accepts AREXX commands at any time,
  507. even if the @{b}DFA-Editor@{ub} and/or the @{b}DFA-Preferences@{ub} program is running at
  508. the same time.  It is possible however that the execution of an AREXX
  509. command will be delayed, if someone for example is just editing an
  510. address within the @{b}Edit@{ub} window of the @{b}DFA-Editor@{ub}. The reason for this
  511. savety protocol can be explained easily: As the addresses are kept in
  512. memory only once, all @{b}DFA@{ub} related programs have access to the same
  513. address list. By the protocol described above I want to make sure that
  514. no part of the @{b}DFA@{ub} package tries to use addresses that another part of
  515. @{b}DFA@{ub} has already deleted (this would sooner or later cause the machine
  516. to crash).
  517. When I talk about executing AREXX commands, the execution of an @{b}AREXX
  518. script@{ub} that contains @{b}DFA@{ub} specific AREXX commands, is meant.
  519. The basics of the AREXX programming language can be found in the AREXX
  520. manual that comes along with @{b}AMIGA-OS 2.0@{ub} or better or in the "AREXX
  521. User's Reference Manual"(1).
  522. The AREXX port, that has to be used to address @{b}DFA@{ub} is @{b}DFA@{ub}, as long as
  523. you did not change this name by the tooltype @{b}PORTNAME@{ub}, as described in
  524. @{"Tooltypes" Link "ServerTooltypes"}.  This should only be done, if you have another program
  525. running that uses the portname @{b}DFA@{ub} as well and you don't want to use
  526. @{b}DFA@{ub}'s feature to choose a clear portname.
  527. A further remark on the @{b}Load@{ub}, @{b}Append@{ub}, and @{b}Save as@{ub} commands:
  528. If you give a filename, you should always use the complete pathname, as
  529. otherwise it is very likely that the file can't be found or is written
  530. to a place you don't expect. Refering to the home directory of @{b}DFA@{ub}
  531. doesn't make much sense, as @{b}DFA@{ub} is often placed in another drawer than
  532. the address files and furthermore as @{b}DFA@{ub} remembers the recently loaded
  533. filename and uses it for loading and saving.
  534. Beyond the item @{b}Syntax@{ub} the possible parameters are listed.  The
  535. description of the parameters follows the known style given by
  536. Commodore, here is its meaning:
  537. @{b}/S - Switch@{ub}
  538.      This is considered a boolean variable.  If this option is present,
  539.      the corresponding option is enabled, otherwise it keeps disabled.
  540. @{b}/K - Keyword.@{ub}
  541.      This parameter must be given in the format @{b}keyword=<setting>@{ub}; e.g.
  542.      the @{b}PRINT@{ub} command can get @{b}FORM/K@{ub} either as @{b}FORM=ALL@{ub} or
  543.      @{b}FORM=SELECTED@{ub} or @{b}FORM=ACTIVE@{ub}.  The equal sign @{b}=@{ub} may be left out.
  544. @{b}/N - Number.@{ub}
  545.      This means the parameter is considered a decimal integer,
  546. @{b}/T - Toggle.@{ub}
  547.      This is similar to the switch (/S) modifier, but one of the
  548.      keywords @{b}yes@{ub}, @{b}on@{ub}, @{b}no@{ub} or @{b}off@{ub} is expected (not case sensitive).
  549.      According to the keyword you provide, the option is switched on or
  550.      off respectively.
  551.      Please notice that you may @{b}not@{ub} use the equal sign (@{b}=@{ub}) between the
  552.      parameter and the modifier.
  553.      The following examples may give you an idea, how this switch can be
  554.      used:
  555.      Examples:
  556.               gui input off output on
  557.           
  558.               gui input yes output ON
  559.           
  560.               gui input NO output off
  561.      Important:
  562.      Starting with version 2.2 of DFA the behaviour of this /T switch
  563.      changed a bit, so please adopt your Arexx scripts accordingly.
  564. @{b}/A - Always.@{ub}
  565.      This modifier means that this option is required. It must appear in
  566.      the command line.
  567. The exact syntax for every AREXX command can be found below, see
  568. @{"Arexx commands" Link "ArexxCommands"}, for details.
  569. @{b}Important:@{ub}
  570. The AREXX interface of @{b}DFA@{ub} gives you a powerful instrument to manage
  571. the stored addresses. A wider range of functionality however implements
  572. more ways of loosing your data! This could happen not only by a
  573. malfunction of @{b}DFA@{ub} but also by an inproper used function or parameter.
  574. Therefore I encourage you to make regular copies of your databases to
  575. keep the potential damage as small as possible.
  576. ---------- Footnotes ----------
  577. (1)  AREXX User's Reference Manual, William S. Hawes, P.O. Box 308,
  578. Maynard, MA 01754
  579. @EndNode
  580. @Node "ArexxReturnAddress" "dfa.guide/ArexxReturnAddress"
  581. @Next "ArexxCommands"
  582. @Prev "ArexxBasics"
  583. @Toc "Arexx"
  584. Format of the Address Field
  585. ---------------------------
  586. If there is listed @{b}ADDRESS/M@{ub} in the return code section, this means
  587. that the corresponding command returns the wanted address if it has
  588. been executed successfully. The address can be found either in the
  589. variable given together with the AREXX keyword @{b}STEM@{ub} or @{b}VAR@{ub} or in the
  590. default variable @{b}RESULTS@{ub}.
  591. Example:
  592.          /* Outputs the first address */
  593.      
  594.          ADDRESS "DFA"
  595.          OPTIONS RESULTS
  596.      
  597.          /* Please notice the full stop behind 'TEST' ! */
  598.      
  599.          FIRST STEM TEST.
  600.          SAY TEST.ADDRESS.2
  601.          EXIT
  602. This short example outputs the name of the first entry of the address
  603. list.
  604. The @{b}STEM@{ub} keyword returns the address in the form of a list, i.e. the
  605. address items appear in @{b}TEST.ADDRESS.0@{ub} through @{b}TEST.ADDRESS.25@{ub}.  In
  606. @{b}TEST.ADDRESS.COUNT@{ub} you can find the number of entries of the address
  607. array. The @{b}VAR@{ub} keyword lets @{b}DFA@{ub} return the desired address as well, but
  608. the whole address is stored in one single variable, separated by
  609. spaces. Please consult your AREXX manual for further details.
  610. The address fields correspond to the following "numbers":
  611. @{b}0@{ub}
  612.      Salutation
  613. @{b}1@{ub}
  614.      First
  615. @{b}2@{ub}
  616.      Name
  617. @{b}3@{ub}
  618.      Co
  619. @{b}4@{ub}
  620.      Street
  621. @{b}5@{ub}
  622.      Zip
  623. @{b}6@{ub}
  624.      City
  625. @{b}7@{ub}
  626.      State
  627. @{b}8@{ub}
  628.      Country
  629. @{b}9@{ub}
  630.      Birthday
  631. @{b}10@{ub}
  632.      Phone
  633. @{b}11@{ub}
  634.      Fax
  635. @{b}12@{ub}
  636.      Email1
  637. @{b}13@{ub}
  638.      Email2
  639. @{b}14@{ub}
  640.      Email3
  641. @{b}15@{ub}
  642.      Comment
  643. @{b}16@{ub}
  644.      Group1
  645. @{b}17@{ub}
  646.      Group2
  647. @{b}18@{ub}
  648.      Group3
  649. @{b}19@{ub}
  650.      Group4
  651. @{b}20@{ub}
  652.      Group5
  653. @{b}21@{ub}
  654.      Group6
  655. @{b}22@{ub}
  656.      Group7
  657. @{b}23@{ub}
  658.      Group8
  659. @{b}24@{ub}
  660.      Selected
  661. @{b}25@{ub}
  662.      External
  663. @EndNode
  664. @Node "ArexxCommands" "dfa.guide/ArexxCommands"
  665. @Next "ArexxErrorCodes"
  666. @Prev "ArexxReturnAddress"
  667. @Toc "Arexx"
  668. Arexx commands
  669. --------------
  670.  @{" ABOUT " Link "ABOUT"} 
  671.  @{" APPEND " Link "APPEND"} 
  672.  @{" ATTEMPTLOCK " Link "ATTEMPTLOCK"} 
  673.  @{" CHANGEGROUPS " Link "CHANGEGROUPS"} 
  674.  @{" CLEARALL " Link "CLEARALL"} 
  675.  @{" DESELECT " Link "DESELECT"} 
  676.  @{" DIAL " Link "DIAL"} 
  677.  @{" EDIT " Link "EDIT"} 
  678.  @{" FIRST " Link "FIRST"} 
  679.  @{" FREELOCK " Link "FREELOCK"} 
  680.  @{" GETCURRENT " Link "GETCURRENT"} 
  681.  @{" GUI " Link "GUI"} 
  682.  @{" ICONIFY " Link "ICONIFY"} 
  683.  @{" KILL " Link "KILL"} 
  684.  @{" LAST " Link "LAST"} 
  685.  @{" LOAD " Link "LOAD"} 
  686.  @{" NEW " Link "NEW"} 
  687.  @{" NEWFILE " Link "NEWFILE"} 
  688.  @{" NEXT " Link "NEXT"} 
  689.  @{" NEXTSEL " Link "NEXTSEL"} 
  690.  @{" OPENEDITWINDOW " Link "OPENEDITWINDOW"} 
  691.  @{" POPUP " Link "POPUP"} 
  692.  @{" PREV " Link "PREV"} 
  693.  @{" PREVSEL " Link "PREVSEL"} 
  694.  @{" PRINT " Link "PRINT"} 
  695.  @{" SAVE " Link "SAVE"} 
  696.  @{" SAVEAS " Link "SAVEAS"} 
  697.  @{" SAVEASDEFAULT " Link "SAVEASDEFAULT"} 
  698.  @{" SEARCH " Link "SEARCH"} 
  699.  @{" SEARCHNEXT " Link "SEARCHNEXT"} 
  700.  @{" SELALL " Link "SELALL"} 
  701.  @{" SELBYNAME " Link "SELBYNAME"} 
  702.  @{" SELECT " Link "SELECT"} 
  703.  @{" SORT " Link "SORT"} 
  704. @EndNode
  705. @Node "ABOUT" "dfa.guide/ABOUT"
  706. @Next "APPEND"
  707. @Toc "ArexxCommands"
  708. The ABOUT Command
  709. .................
  710. @{b}Syntax:@{ub}
  711.      ABOUT
  712. @{b}Function:@{ub}
  713.      The @{b}About@{ub} window of @{b}DFA@{ub} is opened
  714. @EndNode
  715. @Node "APPEND" "dfa.guide/APPEND"
  716. @Next "ATTEMPTLOCK"
  717. @Prev "ABOUT"
  718. @Toc "ArexxCommands"
  719. The APPEND Command
  720. ..................
  721. @{b}Syntax:@{ub}
  722.      APPEND [FILENAME] <string> [FORCE] [PROMPT]
  723. @{b}Argument template:@{ub}
  724.      FILENAME, FORCE/S, PROMPT/S
  725. @{b}Function:@{ub}
  726.      New addresses are appended to the already existing address
  727.      database.  If the already existing addresses have been changed,
  728.      the new addresses are not appended, as long as you don't supply
  729.      the keyword @{b}FORCE@{ub} additionally. It is possible to use the @{b}PROMPT@{ub}
  730.      parameter, which will supply a file requester to input the desired
  731.      filename of the address database to append.
  732. @{b}Argument description:@{ub}
  733.         @{b}*@{ub} FILENAME <string>
  734.           The filename of the address file to be appended.
  735.         @{b}*@{ub} FORCE
  736.           Forces appending the address file.
  737.         @{b}*@{ub} PROMPT
  738.           Opens a file requester that allows the selection of the
  739.           address file to be appended.
  740. @{b}Results:@{ub}
  741.      The following error codes can be returned in @{b}RC2@{ub}:
  742.         @{b}*@{ub} RXERR_NOFILENAME
  743.         @{b}*@{ub} RXERR_APPENDFAILED
  744.         @{b}*@{ub} RXERR_ENVCHANGED
  745.         @{b}*@{ub} RXERR_NONETWORKAPPEND
  746.         @{b}*@{ub} RXERR_MODIFIED
  747. @EndNode
  748. @Node "ATTEMPTLOCK" "dfa.guide/ATTEMPTLOCK"
  749. @Next "CHANGEGROUPS"
  750. @Prev "APPEND"
  751. @Toc "ArexxCommands"
  752. The ATTEMPTLOCK Command
  753. .......................
  754. @{b}Syntax:@{ub}
  755.      ATTEMPTLOCK [<retries>] [<delay>]
  756. @{b}Argument template:@{ub}
  757.      RETRIES/N, DELAY/N
  758. @{b}Function:@{ub}
  759.      If you are in network mode (see @{"Networking" Link "PrefsNetworking"}), you have to get write
  760.      access to the address file, before you may modify anything. To do
  761.      so you have to use the @{b}ATTEMPTLOCK@{ub} command. If someone else in the
  762.      LAN keeps the write access to the desired address file, this
  763.      commands returns an error code in @{b}RC@{ub} and @{b}RC2@{ub} (see @{"FREELOCK" Link "FREELOCK"}).
  764. @{b}Argument description:@{ub}
  765.         @{b}*@{ub} RETRIES
  766.           Maximal number of retries, if the attempt to get write access
  767.           did not succeed at once.
  768.         @{b}*@{ub} DELAY
  769.           Number of seconds that shall pass between two retries.
  770. @{b}Results:@{ub}
  771.      The following error codes can be returned in @{b}RC2@{ub}:
  772.         @{b}*@{ub} RXERR_ENVCHANGED
  773. @EndNode
  774. @Node "CHANGEGROUPS" "dfa.guide/CHANGEGROUPS"
  775. @Next "CLEARALL"
  776. @Prev "ATTEMPTLOCK"
  777. @Toc "ArexxCommands"
  778. The CHANGEGROUPS Command
  779. ........................
  780. @{b}Syntax:@{ub}
  781.      CHANGEGROUPS [GROUP1] [GROUP2] [GROUP3] [GROUP4] [GROUP5] [GROUP6]
  782.      [GROUP7] [GROUP8] [PROMPT]
  783. @{b}Argument template:@{ub}
  784.      GROUP1/S, GROUP2/S, GROUP3/S, GROUP4/S, GROUP5/S, GROUP6/S,
  785.      GROUP7/S, GROUP8/S, PROMPT/S
  786. @{b}Function:@{ub}
  787.      Changes the active group selection. Commands like @{b}PRINT@{ub} or @{b}SEARCH@{ub}
  788.      apply only to the currently active groups. To reach all addresses
  789.      in all groups you have to activate them using this command before.
  790. @{b}Argument description:@{ub}
  791.         @{b}*@{ub} GROUP1
  792.         @{b}*@{ub} GROUP2
  793.         @{b}*@{ub} GROUP3
  794.         @{b}*@{ub} GROUP4
  795.         @{b}*@{ub} GROUP5
  796.         @{b}*@{ub} GROUP6
  797.         @{b}*@{ub} GROUP7
  798.         @{b}*@{ub} GROUP8
  799.         @{b}*@{ub} PROMPT
  800.           Opens a window, in which the user may select the desired
  801.           groups.
  802. @{b}Results:@{ub}
  803.      The following error codes can be returned in @{b}RC2@{ub}:
  804.         @{b}*@{ub} RXERR_NOFILENAME
  805.         @{b}*@{ub} RXERR_NOMEM
  806.         @{b}*@{ub} RXERR_ENVCHANGED
  807.         @{b}*@{ub} RXERR_MODIFIED
  808. @{b}Example:@{ub}
  809.           /* Activates groups 1 through 6 and */
  810.           /* deactivates group 7 and 8        */
  811.           
  812.           ADDRESS 'DFA'
  813.           
  814.           CHANGEGROUPS GROUP1 GROUP2 GROUP3 GROUP4 GROUP5 GROUP6
  815. @EndNode
  816. @Node "CLEARALL" "dfa.guide/CLEARALL"
  817. @Next "DESELECT"
  818. @Prev "CHANGEGROUPS"
  819. @Toc "ArexxCommands"
  820. The CLEARALL Command
  821. ....................
  822. @{b}Syntax:@{ub}
  823.      CLEARALL
  824. @{b}Function:@{ub}
  825.      All items of the address list are deselected.
  826. @{b}Results:@{ub}
  827.      The following error codes can be returned in @{b}RC2@{ub}:
  828.         @{b}*@{ub} RXERR_ENVCHANGED
  829.         @{b}*@{ub} RXERR_NONETWORKCLEAR
  830. @{b}Note:@{ub}
  831.      Only addresses that correspond to the current group selection are
  832.      deselected!
  833. @EndNode
  834. @Node "DESELECT" "dfa.guide/DESELECT"
  835. @Next "DIAL"
  836. @Prev "CLEARALL"
  837. @Toc "ArexxCommands"
  838. The DESELECT Command
  839. ....................
  840. @{b}Syntax:@{ub}
  841.      DESELECT
  842. @{b}Function:@{ub}
  843.      The current entry (it one exists) is deselected.
  844. @{b}Results:@{ub}
  845.      The following error codes can be returned in @{b}RC2@{ub}:
  846.         @{b}*@{ub} RXERR_NOCURRENT
  847.         @{b}*@{ub} RXERR_ENVCHANGED
  848. @EndNode
  849. @Node "DIAL" "dfa.guide/DIAL"
  850. @Next "EDIT"
  851. @Prev "DESELECT"
  852. @Toc "ArexxCommands"
  853. The DIAL Command
  854. ................
  855. @{b}Syntax:@{ub}
  856.      DIAL
  857. @{b}Function:@{ub}
  858.      The current address (if one exists) is dialed up.
  859. @{b}Results:@{ub}
  860.      The following error codes can be returned in @{b}RC2@{ub}:
  861.         @{b}*@{ub} RXERR_SERNOCARRIER
  862.         @{b}*@{ub} RXERR_SERNODIALTONE
  863.         @{b}*@{ub} RXERR_SERRING
  864.         @{b}*@{ub} RXERR_SERBUSY
  865.         @{b}*@{ub} RXERR_SEROK
  866.         @{b}*@{ub} RXERR_SERERROR
  867.         @{b}*@{ub} RXERR_SERCONNECT
  868.         @{b}*@{ub} RXERR_SERVOICE
  869.         @{b}*@{ub} RXERR_SERUNKNOWN
  870.         @{b}*@{ub} RXERR_NOSERIALDEV
  871.         @{b}*@{ub} RXERR_NOPHONENUM
  872.         @{b}*@{ub} RXERR_ENVCHANGED
  873. @EndNode
  874. @Node "EDIT" "dfa.guide/EDIT"
  875. @Next "FIRST"
  876. @Prev "DIAL"
  877. @Toc "ArexxCommands"
  878. The EDIT Command
  879. ................
  880. @{b}Syntax:@{ub}
  881.      EDIT [SALUTATION <string>] [FIRST <string>] [NAME <string>]
  882.      [STREET <string>] [CO <string>] [ZIP <string>] [CITY <string>]
  883.      [STATE <string>] [COUNTRY <string>] [BIRTHDAY <string>] [PHONE
  884.      <string>] [FAX <string>] [EMAIL1 <string>] [EMAIL2 <string>]
  885.      [EMAIL3 <string>] [COMMENT <string>] [GROUP1] [GROUP2] [GROUP3]
  886.      [GROUP4] [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL
  887.      <string>]
  888. @{b}Argument template:@{ub}
  889.      SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K,
  890.      STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K,
  891.      EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/T, GROUP2/T, GROUP3/T,
  892.      GROUP4/T, GROUP5/T, GROUP6/T, GROUP7/T, GROUP8/T, SELECT/T,
  893.      EXTERNAL/K
  894. @{b}Function:@{ub}
  895.      The current address (if one exists) is modified in the given
  896.      fields.  The former contents of these fields is deleted. Fields
  897.      that are not given as parameter are not changed and keep their
  898.      former contents.  Please notice that parameters that contain
  899.      spaces have to be set into quotes, for example:
  900.               EDIT 'COMMENT="A test that contains spaces"'
  901.      Please remember to use @{b}'@{ub} for the outer and @{b}"@{ub} for the inner quotes!
  902.      Since version 2.2 of @{b}DFA@{ub} has been completed, the behavior of the
  903.      @{b}/T@{ub} modifiers has slightly changed. If you want to switch a @{b}/T@{ub}
  904.      parameter on, you have to supply a @{b}ON@{ub} or @{b}YES@{ub} just behind the
  905.      according parameter. To switch a parameter off, use the keywords
  906.      @{b}OFF@{ub} or @{b}NO@{ub}, e.g.
  907.               EDIT GROUP1 ON GROUP2 OFF GROUP8 ON SELECT ON
  908. @{b}Argument description:@{ub}
  909.         @{b}*@{ub} SALUTATION <string>
  910.           Salutation
  911.         @{b}*@{ub} FIRST <string>
  912.           First name
  913.         @{b}*@{ub} NAME <string>
  914.           Name
  915.         @{b}*@{ub} STREET <string>
  916.           Street
  917.         @{b}*@{ub} CO <string>
  918.           c/o
  919.         @{b}*@{ub} ZIP <string>
  920.           Postal code
  921.         @{b}*@{ub} CITY <string>
  922.           City
  923.         @{b}*@{ub} STATE <string>
  924.           State
  925.         @{b}*@{ub} COUNTRY <string>
  926.           Country
  927.         @{b}*@{ub} BIRTHDAY <string>
  928.           Birthday
  929.         @{b}*@{ub} PHONE <string>
  930.           Phone number
  931.         @{b}*@{ub} FAX <string>
  932.           Telefax number
  933.         @{b}*@{ub} EMAIL1 <string>
  934.           Email address No. 1
  935.         @{b}*@{ub} EMAIL2 <string>
  936.           Email address No. 2
  937.         @{b}*@{ub} EMAIL3 <string>
  938.           Email address No. 3
  939.         @{b}*@{ub} COMMENT <string>
  940.           Comment
  941.         @{b}*@{ub} GROUP1
  942.           Group No. 1
  943.         @{b}*@{ub} GROUP2
  944.           Group No. 2
  945.         @{b}*@{ub} GROUP3
  946.           Group No. 3
  947.         @{b}*@{ub} GROUP4
  948.           Group No. 4
  949.         @{b}*@{ub} GROUP5
  950.           Group No. 5
  951.         @{b}*@{ub} GROUP6
  952.           Group No. 6
  953.         @{b}*@{ub} GROUP7
  954.           Group No. 7
  955.         @{b}*@{ub} GROUP8
  956.           Group No. 8
  957.         @{b}*@{ub} SELECT
  958.           Selection state, i.e. @{b}ON@{ub} or @{b}OFF@{ub}.
  959.         @{b}*@{ub} EXTERNAL <string>
  960.           The @{b}filename@{ub} of the external file.
  961. @{b}Results:@{ub}
  962.      The following error codes can be returned in @{b}RC2@{ub}:
  963.         @{b}*@{ub} RXERR_NODIR
  964.         @{b}*@{ub} RXERR_NOFILE
  965.         @{b}*@{ub} RXERR_NOCURRENT
  966.         @{b}*@{ub} RXERR_ENVCHANGED
  967.         @{b}*@{ub} RXERR_NONETWORKEDIT
  968. @EndNode
  969. @Node "FIRST" "dfa.guide/FIRST"
  970. @Next "FREELOCK"
  971. @Prev "EDIT"
  972. @Toc "ArexxCommands"
  973. The FIRST Command
  974. .................
  975. @{b}Syntax:@{ub}
  976.      FIRST [VAR <name>] [STEM <name>]
  977. @{b}Argument template:@{ub}
  978.      VAR/K, STEM/K
  979. @{b}Function:@{ub}
  980.      The first address of the address list becomes the current one and
  981.      is returned in the @{b}ADDRESS@{ub} variable.
  982. @{b}Argument description:@{ub}
  983.         @{b}*@{ub} VAR <name>
  984.         @{b}*@{ub} STEM <name>
  985. @{b}Results:@{ub}
  986.         @{b}*@{ub} .ADDRESS.COUNT
  987.         @{b}*@{ub} .ADDRESS.x
  988.      The following error codes can be returned in @{b}RC2@{ub}:
  989.         @{b}*@{ub} RXERR_NOFIRST
  990.         @{b}*@{ub} RXERR_ENVCHANGED
  991. @EndNode
  992. @Node "FREELOCK" "dfa.guide/FREELOCK"
  993. @Next "GETCURRENT"
  994. @Prev "FIRST"
  995. @Toc "ArexxCommands"
  996. The FREELOCK Command
  997. ....................
  998. @{b}Syntax:@{ub}
  999.      FREELOCK
  1000. @{b}Function:@{ub}
  1001.      If you've got write access using the @{b}ATTEMPTLOCK@{ub} command (cf.
  1002.      @{"ATTEMPTLOCK" Link "ATTEMPTLOCK"}), you should free the locked file as soon as possible
  1003.      using the @{b}FREELOCK@{ub} command, to give other members of the LAN the
  1004.      chance to access this address file.
  1005. @{b}Results:@{ub}
  1006.      The following error codes can be returned in @{b}RC2@{ub}:
  1007.         @{b}*@{ub} RXERR_NOSAVE
  1008.         @{b}*@{ub} RXERR_ENVCHANGED
  1009. @{b}Note:@{ub}
  1010.      Makes sense in network mode only!
  1011. @EndNode
  1012. @Node "GETCURRENT" "dfa.guide/GETCURRENT"
  1013. @Next "GUI"
  1014. @Prev "FREELOCK"
  1015. @Toc "ArexxCommands"
  1016. The GETCURRENT Command
  1017. ......................
  1018. @{b}Syntax:@{ub}
  1019.      GETCURRENT [VAR <name>] [STEM <name>]
  1020. @{b}Argument template:@{ub}
  1021.      VAR/K, STEM/K
  1022. @{b}Function:@{ub}
  1023.      The current entry (if there exists one) is returned.
  1024. @{b}Argument description:@{ub}
  1025.         @{b}*@{ub} VAR <name>
  1026.         @{b}*@{ub} STEM <name>
  1027. @{b}Results:@{ub}
  1028.         @{b}*@{ub} .ADDRESS.COUNT
  1029.         @{b}*@{ub} .ADDRESS.x
  1030.      The following error codes can be returned in @{b}RC2@{ub}:
  1031.         @{b}*@{ub} RXERR_NOCURRENT
  1032.         @{b}*@{ub} RXERR_ENVCHANGED
  1033. @EndNode
  1034. @Node "GUI" "dfa.guide/GUI"
  1035. @Next "ICONIFY"
  1036. @Prev "GETCURRENT"
  1037. @Toc "ArexxCommands"
  1038. The GUI Command
  1039. ...............
  1040. @{b}Syntax:@{ub}
  1041.      GUI [<input>] [<output>]
  1042. @{b}Argument template:@{ub}
  1043.      INPUT/T, OUTPUT/T
  1044. @{b}Function:@{ub}
  1045.      Using this command you may lock or free the @{b}DFAEditor's@{ub} output and
  1046.      input respectively.
  1047.      After you've locked the input of the @{b}DFAEditor@{ub} using @{b}GUI INPUT
  1048.      OFF@{ub}, it is no longer possible to do any input to the
  1049.      @{b}DFAEditor@{ub}, i.e. you cannot select any gadgets or menus.
  1050.      If you've used @{b}GUI OUTPUT OFF@{ub} to lock the output of the @{b}DFAEditor@{ub},
  1051.      the address and teh panel listview of the @{b}DFAEditor@{ub} main window
  1052.      are no longer updated, when you more through the address list
  1053.      using @{b}NEXT@{ub} or @{b}PREV@{ub} for example.  Not before you've used the
  1054.      command @{b}GUI OUTPUT ON@{ub}, the displayed is "activated" again.
  1055. @{b}Argument description:@{ub}
  1056.         @{b}*@{ub} INPUT
  1057.           Disables or enables user input into the @{b}DFAEditor@{ub}.
  1058.         @{b}*@{ub} OUTPUT
  1059.           Disables the refreshing of the @{b}DFAEditor@{ub}'s address and panel
  1060.           listview.
  1061. @{b}Results:@{ub}
  1062.      The following error codes can be returned in @{b}RC2@{ub}:
  1063.         @{b}*@{ub} RXERR_SYNTAX
  1064. @{b}Note:@{ub}
  1065.      Please make sure that you enable input and/or output, before your
  1066.      Arexx script ends, if you've formerly disabled them.
  1067. @EndNode
  1068. @Node "ICONIFY" "dfa.guide/ICONIFY"
  1069. @Next "KILL"
  1070. @Prev "GUI"
  1071. @Toc "ArexxCommands"
  1072. The ICONIFY Command
  1073. ...................
  1074. @{b}Syntax:@{ub}
  1075.      ICONIFY
  1076. @{b}Argument template:@{ub}
  1077. @{b}Function:@{ub}
  1078.      The @{b}DFA-Editor@{ub} is stopped, if it is currently running. The
  1079.      @{b}DFA-Server@{ub}, however, keeps running, so you still can reach the
  1080.      @{b}DFA-Editor@{ub} by pushing the hotkey.
  1081. @{b}Results:@{ub}
  1082.      The following error codes can be returned in @{b}RC2@{ub}:
  1083.         @{b}*@{ub} RXERR_NOICONIFY
  1084. @EndNode
  1085. @Node "KILL" "dfa.guide/KILL"
  1086. @Next "LAST"
  1087. @Prev "ICONIFY"
  1088. @Toc "ArexxCommands"
  1089. The KILL Command
  1090. ................
  1091. @{b}Syntax:@{ub}
  1092.      KILL [CURRENT] [SELECTED]
  1093. @{b}Argument template:@{ub}
  1094.      CURRENT/S, SELECTED/S
  1095. @{b}Function:@{ub}
  1096.      The current entry (@{b}CURRENT@{ub}) or all selected (@{b}SELECTED@{ub}) addresses
  1097.      are deleted! If you use the @{b}KILL@{ub} command without a parameter, it
  1098.      has the same meaning as if you had given the @{b}CURRENT@{ub} parameter,
  1099.      i.e. the current address (as long as there is one) is deleted.
  1100. @{b}Argument description:@{ub}
  1101.         @{b}*@{ub} CURRENT
  1102.           The current address will be deleted. Can be left out.
  1103.         @{b}*@{ub} SELECTED
  1104.           All selected addresses will be deleted.
  1105. @{b}Results:@{ub}
  1106.      The following error codes can be returned in @{b}RC2@{ub}:
  1107.         @{b}*@{ub} RXERR_ENVCHANGED
  1108.         @{b}*@{ub} RXERR_NONETWORKKILL
  1109. @{b}Note:@{ub}
  1110.      No safety requester will pop up! The addresses are deleted even if
  1111.      they have been modified before!
  1112. @EndNode
  1113. @Node "LAST" "dfa.guide/LAST"
  1114. @Next "LOAD"
  1115. @Prev "KILL"
  1116. @Toc "ArexxCommands"
  1117. The LAST Command
  1118. ................
  1119. @{b}Syntax:@{ub}
  1120.      LAST [VAR <name>] [STEM <name>]
  1121. @{b}Argument template:@{ub}
  1122.      VAR/K, STEM/K
  1123. @{b}Function:@{ub}
  1124.      The last address becomes the current one and is returned in
  1125.      @{b}ADDRESS@{ub}.
  1126. @{b}Argument description:@{ub}
  1127.         @{b}*@{ub} VAR <name>
  1128.         @{b}*@{ub} STEM <name>
  1129. @{b}Results:@{ub}
  1130.         @{b}*@{ub} .ADDRESS.COUNT
  1131.         @{b}*@{ub} .ADDRESS.x
  1132. @{b}Results:@{ub}
  1133.      The following error codes can be returned in @{b}RC2@{ub}:
  1134.         @{b}*@{ub} RXERR_ENVCHANGED
  1135. @EndNode
  1136. @Node "LOAD" "dfa.guide/LOAD"
  1137. @Next "NEW"
  1138. @Prev "LAST"
  1139. @Toc "ArexxCommands"
  1140. The LOAD Command
  1141. ................
  1142. @{b}Syntax:@{ub}
  1143.      LOAD [FILENAME] <string> [FORCE] [PROMPT]
  1144. @{b}Argument template:@{ub}
  1145.      FILENAME, FORCE/S, PROMPT/S
  1146. @{b}Function:@{ub}
  1147.      The given address file is loaded, if the previously loaded one had
  1148.      not been changed. You may force the loading of the new addresses by
  1149.      giving the @{b}FORCE@{ub} parameter. Please notice that using the @{b}FORCE@{ub}
  1150.      option throws away any changes you applied to the former loaded
  1151.      addresses.
  1152.      Instead of giving a filename it is possible to use the @{b}PROMPT@{ub}
  1153.      parameter, which will supply a file requester to input the desired
  1154.      filename.
  1155. @{b}Argument description:@{ub}
  1156.         @{b}*@{ub} FILENAME <string>
  1157.           Address file to be loaded.
  1158.         @{b}*@{ub} FORCE
  1159.           Forces loading a new address file.
  1160.         @{b}*@{ub} PROMPT
  1161.           Supplies a file requester to select the desired filename.
  1162. @{b}Results:@{ub}
  1163.      The following error codes can be returned in @{b}RC2@{ub}:
  1164.         @{b}*@{ub} RXERR_NOLOAD
  1165.         @{b}*@{ub} RXERR_ENVCHANGED
  1166.         @{b}*@{ub} RXERR_MODIFIED
  1167.         @{b}*@{ub} RXERR_NOFILENAME
  1168. @EndNode
  1169. @Node "NEW" "dfa.guide/NEW"
  1170. @Next "NEWFILE"
  1171. @Prev "LOAD"
  1172. @Toc "ArexxCommands"
  1173. The NEW Command
  1174. ...............
  1175. @{b}Syntax:@{ub}
  1176.      NEW [SALUTATION <string>] [FIRST <string>] [NAME <string>] [STREET
  1177.      <string>] [CO <string>] [ZIP <string>] [CITY <string>] [STATE
  1178.      <string>] [COUNTRY <string>] [BIRTHDAY <string>] [PHONE <string>]
  1179.      [FAX <string>] [EMAIL1 <string>] [EMAIL2 <string>] [EMAIL3
  1180.      <string>] [COMMENT <string>] [GROUP1] [GROUP2] [GROUP3] [GROUP4]
  1181.      [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL <string>]
  1182. @{b}Argument template:@{ub}
  1183.      SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K,
  1184.      STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K,
  1185.      EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/S, GROUP2/S, GROUP3/S,
  1186.      GROUP4/S, GROUP5/S, GROUP6/S, GROUP7/S, GROUP8/S, SELECT/S,
  1187.      EXTERNAL/K
  1188. @{b}Function:@{ub}
  1189.      A new address is created using the provided data.
  1190. @{b}Argument description:@{ub}
  1191.         @{b}*@{ub} SALUTATION <string>
  1192.           Salutation
  1193.         @{b}*@{ub} FIRST <string>
  1194.           First name
  1195.         @{b}*@{ub} NAME <string>
  1196.           Name
  1197.         @{b}*@{ub} STREET <string>
  1198.           Street
  1199.         @{b}*@{ub} CO <string>
  1200.           c/o
  1201.         @{b}*@{ub} ZIP <string>
  1202.           Postal code
  1203.         @{b}*@{ub} CITY <string>
  1204.           City
  1205.         @{b}*@{ub} STATE <string>
  1206.           State
  1207.         @{b}*@{ub} COUNTRY <string>
  1208.           Country
  1209.         @{b}*@{ub} BIRTHDAY <string>
  1210.           Birthday
  1211.         @{b}*@{ub} PHONE <string>
  1212.           Phone number
  1213.         @{b}*@{ub} FAX <string>
  1214.           Telefax number
  1215.         @{b}*@{ub} EMAIL1 <string>
  1216.           EMail address No. 1
  1217.         @{b}*@{ub} EMAIL2 <string>
  1218.           EMail address No. 2
  1219.         @{b}*@{ub} EMAIL3 <string>
  1220.           EMail address No. 3
  1221.         @{b}*@{ub} COMMENT <string>
  1222.           Comment
  1223.         @{b}*@{ub} GROUP1
  1224.           Group No. 1
  1225.         @{b}*@{ub} GROUP2
  1226.           Group No. 2
  1227.         @{b}*@{ub} GROUP3
  1228.           Group No. 3
  1229.         @{b}*@{ub} GROUP4
  1230.           Group No. 4
  1231.         @{b}*@{ub} GROUP5
  1232.           Group No. 5
  1233.         @{b}*@{ub} GROUP6
  1234.           Group No. 6
  1235.         @{b}*@{ub} GROUP7
  1236.           Group No. 7
  1237.         @{b}*@{ub} GROUP8
  1238.           Group No. 8
  1239.         @{b}*@{ub} SELECT
  1240.           Selection state, i.e. @{b}0@{ub} or @{b}1@{ub}.
  1241.         @{b}*@{ub} EXTERNAL <string>
  1242.           The @{b}filename@{ub} of the external file.
  1243. @EndNode
  1244. @Node "NEWFILE" "dfa.guide/NEWFILE"
  1245. @Next "NEXT"
  1246. @Prev "NEW"
  1247. @Toc "ArexxCommands"
  1248. The NEWFILE Command
  1249. ...................
  1250. @{b}Syntax:@{ub}
  1251.      NEWFILE [<filename>] [FORCE] [PROMPT]
  1252. @{b}Argument template:@{ub}
  1253.      FILENAME, FORCE/S, PROMPT/S
  1254. @{b}Function:@{ub}
  1255.      This command makes it possible to create a new address file. The
  1256.      command fails, if the previously loaded address file has been
  1257.      modifed.  This behaviour can be changed by giving the @{b}FORCE@{ub} option
  1258.      additionally.
  1259.      Using the parameter @{b}PROMPT@{ub} enables a file requester to input the
  1260.      new filename.
  1261. @{b}Argument description:@{ub}
  1262.         @{b}*@{ub} FILENAME
  1263.           New filename.
  1264.         @{b}*@{ub} FORCE
  1265.           Forces the creation of the new file, even if the old address
  1266.           file has been modified.
  1267.         @{b}*@{ub} PROMPT
  1268.           Supplies a file requester to input the new filename.
  1269. @{b}Results:@{ub}
  1270.      The following error codes can be returned in @{b}RC2@{ub}:
  1271.         @{b}*@{ub} RXERR_NODIR
  1272.         @{b}*@{ub} RXERR_NOEXTERNAL
  1273.         @{b}*@{ub} RXERR_ENVCHANGED
  1274.         @{b}*@{ub} RXERR_NONETWORKNEW
  1275. @EndNode
  1276. @Node "NEXT" "dfa.guide/NEXT"
  1277. @Next "NEXTSEL"
  1278. @Prev "NEWFILE"
  1279. @Toc "ArexxCommands"
  1280. The NEXT Command
  1281. ................
  1282. @{b}Syntax:@{ub}
  1283.      NEXT [VAR <name>] [STEM <name>]
  1284. @{b}Argument template:@{ub}
  1285.      VAR/K, STEM/K
  1286. @{b}Function:@{ub}
  1287.      The next address becomes the current one and is returned.
  1288. @{b}Argument description:@{ub}
  1289.         @{b}*@{ub} VAR <name>
  1290.         @{b}*@{ub} STEM <name>
  1291. @{b}Results:@{ub}
  1292.         @{b}*@{ub} .ADDRESS.COUNT
  1293.         @{b}*@{ub} .ADDRESS.x
  1294.      The following error codes can be returned in @{b}RC2@{ub}:
  1295.         @{b}*@{ub} RXERR_NONEXT
  1296.         @{b}*@{ub} RXERR_ENVCHANGED
  1297. @EndNode
  1298. @Node "NEXTSEL" "dfa.guide/NEXTSEL"
  1299. @Next "OPENEDITWINDOW"
  1300. @Prev "NEXT"
  1301. @Toc "ArexxCommands"
  1302. The NEXTSEL Command
  1303. ...................
  1304. @{b}Syntax:@{ub}
  1305.      NEXTSEL [VAR <name>] [STEM <name>]
  1306. @{b}Argument template:@{ub}
  1307.      VAR/K, STEM/K
  1308. @{b}Function:@{ub}
  1309.      The next selected address becomes the current one and is returned.
  1310. @{b}Argument description:@{ub}
  1311.         @{b}*@{ub} VAR <name>
  1312.         @{b}*@{ub} STEM <name>
  1313. @{b}Results:@{ub}
  1314.         @{b}*@{ub} .ADDRESS.COUNT
  1315.         @{b}*@{ub} .ADDRESS.x
  1316.      The following error codes can be returned in @{b}RC2@{ub}:
  1317.         @{b}*@{ub} RXERR_NONEXTSEL
  1318.         @{b}*@{ub} RXERR_ENVCHANGED
  1319. @EndNode
  1320. @Node "OPENEDITWINDOW" "dfa.guide/OPENEDITWINDOW"
  1321. @Next "POPUP"
  1322. @Prev "NEXTSEL"
  1323. @Toc "ArexxCommands"
  1324. The OPENEDITWINDOW Command
  1325. ..........................
  1326. @{b}Syntax:@{ub}
  1327.      OPENEDITWINDOW
  1328. @{b}Argument template:@{ub}
  1329. @{b}Function:@{ub}
  1330.      The @{b}Edit@{ub} window is opened and the current address is displayed, if
  1331.      there is one. The execution of the Arexx script is halted until
  1332.      the @{b}Edit@{ub} window is closed.
  1333. @{b}Argument description:@{ub}
  1334.      -
  1335. @{b}Results:@{ub}
  1336.      The following error codes can be returned in @{b}RC2@{ub}:
  1337.         @{b}*@{ub} RXERR_CURRENT
  1338. @{b}Warning:@{ub}
  1339.      The @{b}Edit@{ub} window is opened only if there is a current address,
  1340.      otherwise an error code is returned (see above).
  1341. @EndNode
  1342. @Node "POPUP" "dfa.guide/POPUP"
  1343. @Next "PREV"
  1344. @Prev "OPENEDITWINDOW"
  1345. @Toc "ArexxCommands"
  1346. The POPUP Command
  1347. .................
  1348. @{b}Syntax:@{ub}
  1349.      POPUP
  1350. @{b}Function:@{ub}
  1351.      If the @{b}DFA-Editor@{ub} doesn't run up to now, it is started. Then it
  1352.      opens its main window. If the @{b}DFA-Editor@{ub} is already running, it
  1353.      comes to front.
  1354. @EndNode
  1355. @Node "PREV" "dfa.guide/PREV"
  1356. @Next "PREVSEL"
  1357. @Prev "POPUP"
  1358. @Toc "ArexxCommands"
  1359. The PREV Command
  1360. ................
  1361. @{b}Syntax:@{ub}
  1362.      PREV [VAR <name>] [STEM <name>]
  1363. @{b}Argument template:@{ub}
  1364.      VAR/K, STEM/K
  1365. @{b}Function:@{ub}
  1366.      The previous address becomes the current one and is returned.
  1367. @{b}Argument description:@{ub}
  1368.         @{b}*@{ub} VAR <name>
  1369.         @{b}*@{ub} STEM <name>
  1370. @{b}Results:@{ub}
  1371.         @{b}*@{ub} .ADDRESS.COUNT
  1372.         @{b}*@{ub} .ADDRESS.x
  1373.      The following error codes can be returned in @{b}RC2@{ub}:
  1374.         @{b}*@{ub} RXERR_NOPREV
  1375.         @{b}*@{ub} RXERR_ENVCHANGED
  1376. @EndNode
  1377. @Node "PREVSEL" "dfa.guide/PREVSEL"
  1378. @Next "PRINT"
  1379. @Prev "PREV"
  1380. @Toc "ArexxCommands"
  1381. The PREVSEL Command
  1382. ...................
  1383. @{b}Syntax:@{ub}
  1384.      PREVSEL [VAR <name>] [STEM <name>]
  1385. @{b}Argument template:@{ub}
  1386.      VAR/K, STEM/K
  1387. @{b}Function:@{ub}
  1388.      The previously selected address becomes the current one and is
  1389.      returned.
  1390. @{b}Argument description:@{ub}
  1391.         @{b}*@{ub} VAR <name>
  1392.         @{b}*@{ub} STEM <name>
  1393. @{b}Results:@{ub}
  1394.         @{b}*@{ub} .ADDRESS.COUNT
  1395.         @{b}*@{ub} .ADDRESS.x
  1396.      The following error codes can be returned in @{b}RC2@{ub}:
  1397.         @{b}*@{ub} RXERR_NOPREVSEL
  1398.         @{b}*@{ub} RXERR_ENVCHANGED
  1399. @EndNode
  1400. @Node "PRINT" "dfa.guide/PRINT"
  1401. @Next "SAVE"
  1402. @Prev "PREVSEL"
  1403. @Toc "ArexxCommands"
  1404. The PRINT Command
  1405. .................
  1406. @{b}Syntax:@{ub}
  1407.      PRINT [WHICH <string>] [FILE <string>] [NLQ] [CONDENSED]
  1408.      [FORMFEED] [<form>]
  1409. @{b}Argument template:@{ub}
  1410.      WHICH/K, FILE/K, NLQ/S, CONDENSED/S, FORMFEED/S, FORM/N
  1411. @{b}Function:@{ub}
  1412.      Prints the desired addresses.
  1413. @{b}Argument description:@{ub}
  1414.         @{b}*@{ub} WHICH <string>
  1415.           @{b}WHICH@{ub} can get the following keywords:
  1416.          @{b}ALL@{ub}
  1417.                All addresses are printed
  1418.          @{b}SELECTED@{ub}
  1419.                Only the selected addresses are printed
  1420.          @{b}ACTIVE@{ub}
  1421.                Only the active entry (if there is one) is printed.
  1422.         @{b}*@{ub} FILE <string>
  1423.           the @{b}FILE@{ub} parameter gets a filename. To this file the addresses
  1424.           are written instead of printed on the printer.
  1425.         @{b}*@{ub} NLQ
  1426.           Prints the addresses in @{b}NLQ@{ub}
  1427.         @{b}*@{ub} CONDENSED
  1428.           Prints the addresses in condensed mode
  1429.         @{b}*@{ub} FORMFEED
  1430.           After the last address, which has been printed, a formfeed is
  1431.           performed. The settings from the @{b}DFA-Editor@{ub} print window are
  1432.           not taken!
  1433.         @{b}*@{ub} FORM
  1434.           the @{b}FORM@{ub} keyword can get the numbers @{b}0@{ub} through @{b}4@{ub}.  These
  1435.           numbers have the same meaning as the order of the print forms
  1436.           in the print window, but starting with @{b}0@{ub} instead of @{b}1@{ub}.
  1437.                0:    Short address list
  1438.                1:    Long address list
  1439.                2:    Telephone list
  1440.                3:    mailing labels, [70mm x 46mm]
  1441.                4:    address cards
  1442. @{b}Results:@{ub}
  1443.      The following error codes can be returned in @{b}RC2@{ub}:
  1444.         @{b}*@{ub} RXERR_SYNTAX
  1445.         @{b}*@{ub} RXERR_ENVCHANGED
  1446.         @{b}*@{ub} RXERR_OPNPRT
  1447.         @{b}*@{ub} RXERR_CRTEXTIO
  1448.         @{b}*@{ub} RXERR_CRTPORT
  1449.         @{b}*@{ub} RXERR_WRITEALL
  1450.         @{b}*@{ub} RXERR_WRITESEL
  1451.         @{b}*@{ub} RXERR_WRITECURRENT
  1452. @EndNode
  1453. @Node "SAVE" "dfa.guide/SAVE"
  1454. @Next "SAVEAS"
  1455. @Prev "PRINT"
  1456. @Toc "ArexxCommands"
  1457. The SAVE Command
  1458. ................
  1459. @{b}Syntax:@{ub}
  1460.      SAVE
  1461. @{b}Function:@{ub}
  1462.      The addresses are saved under their current name.
  1463. @{b}Results:@{ub}
  1464.      The following error codes can be returned in @{b}RC2@{ub}:
  1465.         @{b}*@{ub} RXERR_ENVCHANGED
  1466.         @{b}*@{ub} RXERR_NONETWORKSAVE
  1467. @EndNode
  1468. @Node "SAVEAS" "dfa.guide/SAVEAS"
  1469. @Next "SAVEASDEFAULT"
  1470. @Prev "SAVE"
  1471. @Toc "ArexxCommands"
  1472. The SAVEAS Command
  1473. ..................
  1474. @{b}Syntax:@{ub}
  1475.      SAVEAS [FILENAME] <string> [FORCE] [PROMPT]
  1476. @{b}Argument template:@{ub}
  1477.      FILENAME, FORCE/S, PROMPT/S
  1478. @{b}Function:@{ub}
  1479.      The addresses are saved under the given name.
  1480. @{b}Argument description:@{ub}
  1481.         @{b}*@{ub} FILENAME <string>
  1482.           Name of the address file to save.
  1483.         @{b}*@{ub} FORCE
  1484.           Saves the addresses even if they have @{b}not@{ub} been changed before.
  1485.         @{b}*@{ub} PROMPT
  1486.           Supplies a file requester, which may be used to select the
  1487.           name of the address file to be saved.
  1488. @{b}Results:@{ub}
  1489.      The following error codes can be returned in @{b}RC2@{ub}:
  1490.         @{b}*@{ub} RXERR_NONETWORKSAVE
  1491.         @{b}*@{ub} RXERR_NOSAVE
  1492.         @{b}*@{ub} RXERR_ENVCHANGED
  1493. @EndNode
  1494. @Node "SAVEASDEFAULT" "dfa.guide/SAVEASDEFAULT"
  1495. @Next "SEARCH"
  1496. @Prev "SAVEAS"
  1497. @Toc "ArexxCommands"
  1498. The SAVEASDEFAULT Command
  1499. .........................
  1500. @{b}Syntax:@{ub}
  1501.      SAVEASDEFAULT
  1502. @{b}Function:@{ub}
  1503.      The addresses are saved under the default name that you entered in
  1504.      the @{b}DFA-Preferences@{ub} (default name: @{b}s:adr.file@{ub}).
  1505. @{b}Results:@{ub}
  1506.      The following error codes can be returned in @{b}RC2@{ub}:
  1507.         @{b}*@{ub} RXERR_NONETWORKSAVE
  1508.         @{b}*@{ub} RXERR_NOSAVE
  1509.         @{b}*@{ub} RXERR_ENVCHANGED
  1510. @{b}Note:@{ub}
  1511.      Please use this command very carefully! If you've just loaded
  1512.      another than the default address file, the default address file is
  1513.      overwritten by this command!
  1514. @EndNode
  1515. @Node "SEARCH" "dfa.guide/SEARCH"
  1516. @Next "SEARCHNEXT"
  1517. @Prev "SAVEASDEFAULT"
  1518. @Toc "ArexxCommands"
  1519. The SEARCH Command
  1520. ..................
  1521. @{b}Syntax:@{ub}
  1522.      SEARCH [PATTERN] <string> [IGNORECASE] [ALL] [SALUTATION] [FIRST]
  1523.      [NAME] [STREET] [CO] [ZIP] [CITY] [STATE] [COUNTRY] [BIRTHDAY]
  1524.      [PHONE] [FAX] [EMAIL1] [EMAIL2] [EMAIL3] [COMMENT] [VAR <name>]
  1525.      [STEM <name>]
  1526. @{b}Argument template:@{ub}
  1527.      PATTERN/A, IGNORECASE/S, ALL/S, SALUTATION/S, FIRST/S, NAME/S,
  1528.      STREET/S, CO/S, ZIP/S, CITY/S, STATE/S, COUNTRY/S, BIRTHDAY/S,
  1529.      PHONE/S, FAX/S, EMAIL1/S, EMAIL2/S, EMAIL3/S, COMMENT/S, VAR/K,
  1530.      STEM/K
  1531. @{b}Function:@{ub}
  1532.      The given pattern is searched for. If an address fits into the
  1533.      pattern, it is returned. If the @{b}DFA-Editor@{ub} is currently open, the
  1534.      address list scrolls to the corresponding place.
  1535. @{b}Argument description:@{ub}
  1536.         @{b}*@{ub} PATTERN <string>
  1537.           A search pattern. The known patterns from the Shell, as for
  1538.           example @{b}#?@{ub} may (and must) be used. Please notice that partial
  1539.           strings are only found, if you put an @{b}#?@{ub} before and/or behind
  1540.           the string (see example for details)! A detailed description of
  1541.           possible search patterns can be found in @{"Search" Link "EditorSearch"}.
  1542.         @{b}*@{ub} IGNORECASE
  1543.           Upper and lower case is treated as the same.
  1544.         @{b}*@{ub} ALL
  1545.           All fields are searched.
  1546.         @{b}*@{ub} SALUTATION
  1547.           Only the @{b}Salutation@{ub} fields are searched through.
  1548.         @{b}*@{ub} FIRST
  1549.           Only the @{b}First@{ub} fields are searched through.
  1550.         @{b}*@{ub} NAME
  1551.           Only the @{b}Name@{ub} fields are searched through.
  1552.         @{b}*@{ub} STREET
  1553.           Only the @{b}Street@{ub} fields are searched through.
  1554.         @{b}*@{ub} CO
  1555.           Only the @{b}c/o@{ub} fields are searched through.
  1556.         @{b}*@{ub} ZIP
  1557.           Only the @{b}ZIP@{ub} fields are searched through.
  1558.         @{b}*@{ub} CITY
  1559.           Only the @{b}City@{ub} fields are searched through.
  1560.         @{b}*@{ub} STATE
  1561.           Only the @{b}State@{ub} fields are searched through.
  1562.         @{b}*@{ub} COUNTRY
  1563.           Only the @{b}Country@{ub} fields are searched through.
  1564.         @{b}*@{ub} BIRTHDAY
  1565.           Only the @{b}Birthday@{ub} fields are searched through.
  1566.         @{b}*@{ub} PHONE
  1567.           Only the @{b}Phone@{ub} fields are searched through.
  1568.         @{b}*@{ub} FAX
  1569.           Only the @{b}Fax@{ub} fields are searched through.
  1570.         @{b}*@{ub} EMAIL1
  1571.           Only the @{b}EMail1@{ub} fields are searched through.
  1572.         @{b}*@{ub} EMAIL2
  1573.           Only the @{b}EMail2@{ub} fields are searched through.
  1574.         @{b}*@{ub} EMAIL3
  1575.           Only the @{b}EMail3@{ub} fields are searched through.
  1576.         @{b}*@{ub} COMMENT
  1577.           Only the @{b}Comment@{ub} fields are searched through.
  1578.         @{b}*@{ub} VAR <name>
  1579.         @{b}*@{ub} STEM <name>
  1580. @{b}Results:@{ub}
  1581.         @{b}*@{ub} .ADDRESS.COUNT
  1582.         @{b}*@{ub} .ADDRESS.x
  1583.      The following error codes can be returned in @{b}RC2@{ub}:
  1584.         @{b}*@{ub} RXERR_ENVCHANGED
  1585.         @{b}*@{ub} RXERR_NOTFOUND
  1586. @{b}Example:@{ub}
  1587.           /*
  1588.            * Look for all names beginning with @{b}M@{ub}.
  1589.            * Make no difference between upper and lower case.
  1590.            */
  1591.           
  1592.           ADDRESS 'DFA'
  1593.           
  1594.           SEARCH 'M#?' IGNORECASE NAME
  1595. @EndNode
  1596. @Node "SEARCHNEXT" "dfa.guide/SEARCHNEXT"
  1597. @Next "SELALL"
  1598. @Prev "SEARCH"
  1599. @Toc "ArexxCommands"
  1600. The SEARCHNEXT Command
  1601. ......................
  1602. @{b}Syntax:@{ub}
  1603.      SEARCHNEXT [VAR <name>] [STEM <name>]
  1604. @{b}Argument template:@{ub}
  1605.      VAR/K, STEM/K
  1606. @{b}Function:@{ub}
  1607.      Continue searching for the pattern given in @{b}SEARCH@{ub} before.  If the
  1608.      search succeeded, the found address is returned. If the @{b}DFA-Editor@{ub}
  1609.      is currently running, the address listview is updated.
  1610. @{b}Argument description:@{ub}
  1611.         @{b}*@{ub} VAR <name>
  1612.         @{b}*@{ub} STEM <name>
  1613. @{b}Results:@{ub}
  1614.         @{b}*@{ub} .ADDRESS.COUNT
  1615.         @{b}*@{ub} .ADDRESS.x
  1616. @{b}Note:@{ub}
  1617.      The following error codes can be returned in @{b}RC2@{ub}:
  1618.         @{b}*@{ub} RXERR_NOTFOUND
  1619.         @{b}*@{ub} RXERR_ENVCHANGED
  1620. @EndNode
  1621. @Node "SELALL" "dfa.guide/SELALL"
  1622. @Next "SELBYNAME"
  1623. @Prev "SEARCHNEXT"
  1624. @Toc "ArexxCommands"
  1625. The SELALL Command
  1626. ..................
  1627. @{b}Syntax:@{ub}
  1628.      SELALL
  1629. @{b}Function:@{ub}
  1630.      All addresses are selected.
  1631. @{b}Results:@{ub}
  1632.      The following error codes can be returned in @{b}RC2@{ub}:
  1633.         @{b}*@{ub} RXERR_ENVCHANGED
  1634.         @{b}*@{ub} RXERR_NONETWORKSELECT
  1635. @{b}Note:@{ub}
  1636.      Only addresses that match the current group selection are selected.
  1637. @EndNode
  1638. @Node "SELBYNAME" "dfa.guide/SELBYNAME"
  1639. @Next "SELECT"
  1640. @Prev "SELALL"
  1641. @Toc "ArexxCommands"
  1642. The SELBYNAME Command
  1643. .....................
  1644. @{b}Syntax:@{ub}
  1645.      SELBYNAME [PATTERN] <string>
  1646. @{b}Argument template:@{ub}
  1647.      PATTERN/A
  1648. @{b}Function:@{ub}
  1649.      All addresses that match the given pattern are selected. Upper and
  1650.      lower case does not make a difference.
  1651. @{b}Argument description:@{ub}
  1652.         @{b}*@{ub} PATTERN <string>
  1653.           A pattern string. The description of such patterns can be
  1654.           found in @{"Search" Link "EditorSearch"}.
  1655. @{b}Results:@{ub}
  1656.      The following error codes can be returned in @{b}RC2@{ub}:
  1657.         @{b}*@{ub} RXERR_ENVCHANGED
  1658.         @{b}*@{ub} RXERR_NONETWORKSELECT
  1659. @{b}Note:@{ub}
  1660.      All fields of all addresses (that match the current group
  1661.      selection) are searched through.
  1662. @EndNode
  1663. @Node "SELECT" "dfa.guide/SELECT"
  1664. @Next "SORT"
  1665. @Prev "SELBYNAME"
  1666. @Toc "ArexxCommands"
  1667. The SELECT Command
  1668. ..................
  1669. @{b}Syntax:@{ub}
  1670.      SELECT [QUERY] [VAR <name>] [STEM <name>]
  1671. @{b}Argument template:@{ub}
  1672.      QUERY/S, VAR/K, STEM/K
  1673. @{b}Function:@{ub}
  1674.      The current entry (if there is one) is selected. If you supply the
  1675.      @{b}QUERY@{ub} parameter, the current address is @{b}not@{ub} selected, but its
  1676.      selection state (@{b}0@{ub} or @{b}1@{ub}) is returned.
  1677. @{b}Argument description:@{ub}
  1678.         @{b}*@{ub} QUERY
  1679.         @{b}*@{ub} VAR <name>
  1680.         @{b}*@{ub} STEM <name>
  1681. @{b}Results:@{ub}
  1682.         @{b}*@{ub} .SELECTED
  1683.      The following error codes can be returned in @{b}RC2@{ub}:
  1684.         @{b}*@{ub} RXERR_NOCURRENT
  1685.         @{b}*@{ub} RXERR_ENVCHANGED
  1686.         @{b}*@{ub} RXERR_NONETWORKSELECT
  1687. @EndNode
  1688. @Node "SORT" "dfa.guide/SORT"
  1689. @Prev "SELECT"
  1690. @Toc "ArexxCommands"
  1691. The SORT Command
  1692. ................
  1693. @{b}Syntax:@{ub}
  1694.      SORT [SORT1 <string>] [SORT2 <string>] [SORT3 <string>] [SORT4
  1695.      <string>]
  1696. @{b}Argument template:@{ub}
  1697.      SORT1/K, SORT2/K, SORT3/K, SORT4/K
  1698. @{b}Function:@{ub}
  1699.      The addresses are sorted according to the sort criteria given in
  1700.      the @{b}DFA-Preferences@{ub}. Alternatively you may explicitely give the
  1701.      search criteria by which you would like your addresses be sorted.
  1702. @{b}Argument description:@{ub}
  1703.         @{b}*@{ub} SORT1 <string>
  1704.         @{b}*@{ub} SORT2 <string>
  1705.         @{b}*@{ub} SORT3 <string>
  1706.         @{b}*@{ub} SORT4 <string>
  1707.           The following keywords are supported for the @{b}Sort@{ub} parameters:
  1708.              - SALUTATION
  1709.              - FIRST
  1710.              - NAME
  1711.              - CO
  1712.              - STREET
  1713.              - ZIP
  1714.              - CITY
  1715.              - STATE
  1716.              - COUNTRY
  1717.              - BIRTHDAY
  1718.              - PHONE
  1719.              - FAX
  1720.              - EMAIL1
  1721.              - EMAIL2
  1722.              - EMAIL3
  1723.              - COMMENT
  1724. @{b}Results:@{ub}
  1725.      The following error codes can be returned in @{b}RC2@{ub}:
  1726.         @{b}*@{ub} RXERR_ENVCHANGED
  1727.         @{b}*@{ub} RXERR_NONETWORKSORT
  1728. @EndNode
  1729. @Node "ArexxErrorCodes" "dfa.guide/ArexxErrorCodes"
  1730. @Prev "ArexxCommands"
  1731. @Toc "Arexx"
  1732. Error Codes
  1733. -----------
  1734. Besides the usual error code that can be found in the @{b}RC@{ub} variable (1)
  1735. the AREXX interface of DFA returns a second return value in the
  1736. variable @{b}RC2@{ub}, which describes in further detail what has gone wrong.
  1737. Bolow you'll find the error numbers and their meaning:
  1738.          @{b}Symbolic Name@{ub}                @{b}Meaning@{ub}
  1739.      
  1740.      10  RXERR_NONETWORKAPPEND....Could not append file,
  1741.                                   as the network mode is activated
  1742.      11  RXERR_MODIFIED...........The address file has been changed
  1743.      12  RXERR_NOFILENAME.........No filename has been supplied
  1744.      13  RXERR_NOCURRENT..........No current address available
  1745.      14  RXERR_NOFIRST............No first address available
  1746.      15  RXERR_NOICONIFY..........Iconifying the Editor went wrong
  1747.      16  RXERR_NONETWORKKILL......Deleting addresses is not allowed
  1748.                                   while in network mode
  1749.      17  RXERR_NOLAST.............There is no last address
  1750.      18  RXERR_NOLOAD.............The address file could not be loaded
  1751.      19  RXERR_NONETWORKNEW.......It is not possible to enter new
  1752.                                   addresses in network mode
  1753.      20  RXERR_NONEXT.............There is no next address
  1754.      21  RXERR_NONEXTSEL..........There is no next selected address
  1755.      22  RXERR_NOPREV.............There is no previous address
  1756.      23  RXERR_NOPREVSEL..........There is no previous selected address
  1757.      24  RXERR_SYNTAX.............The AREXX command contained an syntax error
  1758.      25  RXERR_WRITEALL...........The "printing" of addresses (all)
  1759.                                   into a file went wrong
  1760.      26  RXERR_WRITESEL...........The "printing" of addresses (selected)
  1761.                                   into a file went wrong
  1762.      27  RXERR_WRITECURRENT.......The "printing" of the current address
  1763.                                   into a file went wrong
  1764.      28  RXERR_NOSAVE.............The address file could not be saved
  1765.      29  RXERR_NONETWORKSAVE......Saving your address database is not
  1766.                                   allowed in network mode
  1767.      30  RXERR_NOTFOUND...........The wanted address could not be found
  1768.      31  RXERR_NONETWORKCLEAR.....Deselecting addresses is not allowed
  1769.                                   while being in network mode
  1770.      32  RXERR_NONETWORKSELECT....Selecting addresses is not allowed
  1771.                                   in network mode
  1772.      33  RXERR_NONETWORKSORT......Sorting addresses is not allowed
  1773.                                   while being in network mode
  1774.      34  RXERR_NONETWORKEDIT......Editing addressen is not allowed
  1775.                                   while being in network mode
  1776.      35  RXERR_OPNPRT.............Could not open printer device
  1777.      36  RXERR_CRTEXTIO...........Could not reach the printer
  1778.                                   (ExtIO could not be initialized)
  1779.      37  RXERR_CRTPORT............Could not reach the printer
  1780.                                   (Could not open message port)
  1781.      38  RXERR_NOMEM..............No more RAM available
  1782.      39  RXERR_NORELOAD...........Reloading the address file went wrong
  1783.      40  RXERR_NOWRITELOCK........could not get write access to the
  1784.                                   address file
  1785.      41  RXERR_NODIR..............Could not locate the needed drawer
  1786.      42  RXERR_NOFILE.............Could not find the address file
  1787.      43  RXERR_APPENDFAILED.......Appending an address file went wrong
  1788.      44  RXERR_ENVCHANGED.........Execution of the current AREXX command
  1789.                                   has been canceled, as the environment changed
  1790.                                   (e.g. new address file)
  1791.      45  RXERR_NOEXTERNAL.........Trying to access the external file had no success
  1792.      46  RXERR_NOSERIALDEV........Could not open serial device
  1793.      47  RXERR_NOPHONENUM.........Current address doesn't have a phone number
  1794.      48  RXERR_SERNOCARRIER.......Phone: No Carrier
  1795.      49  RXERR_SERNODIALTONE......Phone: No dialtone
  1796.      50  RXERR_SERRING............Phone: Ring
  1797.      51  RXERR_SERBUSY............Phone: Line is busy
  1798.      52  RXERR_SEROK..............Phone: Modem sent 'Ok'
  1799.      53  RXERR_SERERROR...........Phone: Modem recognized an error
  1800.      54  RXERR_SERCONNECT.........Phone: Data connect
  1801.      55  RXERR_SERVOICE...........Phone: Voice connect
  1802.      56  RXERR_SERUNKNOWN.........Error caused by the serial device
  1803. ---------- Footnotes ----------
  1804. (1)  cf. AREXX User's Reference Manual, William S. Hawes, P.O. Box 308,
  1805. Maynard, MA 01754
  1806. @EndNode
  1807. @Node "DFAEditor" "dfa.guide/DFAEditor"
  1808. @Toc "Main"
  1809. The DFA-Editor program
  1810. **********************
  1811. The @{b}DFA-Editor@{ub} is the graphical user interface of @{b}DFA@{ub}.
  1812. It can be started seperately or may be invoked (by the hotkey for
  1813. example) out of the @{b}DFA-Server@{ub}.
  1814.  @{"     Tooltypes      " Link "EditorTooltypes"}                 
  1815.  @{"   CLI-Parameter    " Link "EditorCLIParams"}                 
  1816.  @{"    Main Window     " Link "EditorMainWindow"}                  
  1817.  @{"    Tool Gadgets    " Link "EditorTools"}                        The Gadget row
  1818.  @{"       Menus        " Link "EditorMenus"}                        Menus of the main window
  1819.  @{"        Full        " Link "EditorFull"}                        The Full window
  1820.  @{"        Edit        " Link "EditorEdit"}                        The Edit window
  1821.  @{"        New         " Link "EditorNew"}                        The New window
  1822.  @{"       Search       " Link "EditorSearch"}                        The Search window
  1823.  @{"       Print        " Link "EditorPrint"}                        The Print window
  1824.  @{"        Dial        " Link "EditorDial"}                        The Dial window
  1825. @EndNode
  1826. @Node "EditorTooltypes" "dfa.guide/EditorTooltypes"
  1827. @Next "EditorCLIParams"
  1828. @Toc "DFAEditor"
  1829. Tooltypes
  1830. =========
  1831. If you click once on the @{b}DFA-Editor@{ub} icon and then activate the
  1832. Information program of the Workbench, you may adjust the following
  1833. tooltypes:
  1834.    @{b}*@{ub}     @{b}@{b}PUBSCREEN@{ub}@{ub}
  1835.      If you enter the @{b}name@{ub} of a public screen together with this
  1836.      tooltype, you may select an alternate (public) screen for the
  1837.      @{b}DFA-Editor@{ub} to open on.
  1838.      For example:
  1839.               PUBSCREEN=TERM
  1840.      If the given public screen exists when the @{b}DFA-Editor@{ub} comes up, it
  1841.      opens its window(s) on this screen, otherwise on the default
  1842.      public screen, usually the Workbench screen.
  1843.    @{b}*@{ub}     @{b}@{b}UPPERPUBSCREEN@{ub}@{ub}
  1844.      If you enter @{b}UPPERPUBSCREEN=YES@{ub}, you tell the @{b}DFA-Editor@{ub} to open
  1845.      its window(s) on the frontmost @{b}public@{ub} screen. If the current
  1846.      frontmost screen isn't public, the @{b}DFA-Editor@{ub} comes up on the
  1847.      screen you selected with the tooltype @{b}PUBSCREEN@{ub}; if this fails as
  1848.      well, the @{b}DFA-Editor@{ub} opens its window(s) on the default public
  1849.      screen.
  1850.    @{b}*@{ub}     @{b}@{b}GUIDEFILE@{ub}@{ub}
  1851.      To make the online help work, the @{b}DFA-Editor@{ub} has to know where to
  1852.      find the online help file. This can be done via the tooltype
  1853.      @{b}GUIDEFILE@{ub}. This tooltype is usually already be set by the install
  1854.      program.
  1855.    @{b}*@{ub}     @{b}@{b}DFAPREFS@{ub}@{ub}
  1856.      As the @{b}DFA-Preferences@{ub} program can be started directly out of the
  1857.      @{b}DFA-Editor@{ub}, the @{b}DFA-Editor@{ub} has to know where to find the
  1858.      @{b}DFA-Preferences@{ub} program. The complete path name must be given with
  1859.      the tooltype @{b}DFAPREFS@{ub} and is already set by the install program
  1860.      usually.
  1861. @EndNode
  1862. @Node "EditorCLIParams" "dfa.guide/EditorCLIParams"
  1863. @Next "EditorMainWindow"
  1864. @Prev "EditorTooltypes"
  1865. @Toc "DFAEditor"
  1866. CLI parameter
  1867. =============
  1868. If you start the @{b}DFA-Editor@{ub} from the shell (or the CLI), it uses the
  1869. @{b}tooltypes@{ub} of the corresponding @{b}.info@{ub} file!  However, you may overwrite
  1870. these setting by giving one or more of the following CLI parameters:
  1871.      PUBSCREEN/K,UPPERPUBSCREEN/K,GUIDEFILE/K,DFAPREFS/K
  1872. This means, you may use...
  1873.    ...   @{b}DFAEditor PUBSCREEN=TERM@{ub} to make the @{b}DFA-Editor@{ub} open its
  1874.      window(s) on the public screen named @{b}TERM@{ub}.
  1875.    ...   @{b}DFAEditor UPPERPUBSCREEN=YES@{ub} to make the @{b}DFA-Editor@{ub} open its
  1876.      window(s) on the frontmost screen, as long as this is a public
  1877.      screen.
  1878.    ...   @{b}DFAEditor GUIDEFILE=Help:DFAEditor.guide@{ub} to set another path
  1879.      for the online help file.
  1880.    ...   @{b}DFAEditor DFAPREFS=C:DFAPrefs@{ub} to set another path for the call
  1881.      of the @{b}DFA-Preferences@{ub} program.
  1882. @EndNode
  1883. @Node "EditorMainWindow" "dfa.guide/EditorMainWindow"
  1884. @Next "EditorTools"
  1885. @Prev "EditorCLIParams"
  1886. @Toc "DFAEditor"
  1887. The Main Window
  1888. ===============
  1889. The main window of the @{b}DFA-Editor@{ub} can be resized using the sizing
  1890. gadget on the lower right corner of the window. The window contents
  1891. automatically adapts on the new window dimensions.
  1892. As the main window is a socalled application window you may drag the
  1893. icon of an address file on this window and drop it, to let the
  1894. @{b}DFA-Editor@{ub} load the corresponding address file.
  1895. The main window of the @{b}DFA-Editor@{ub} gives you the following possibilities:
  1896.    @{b}*@{ub}     @{b}The address listview@{ub}
  1897.      The address listview displays the stored addresses that are
  1898.      available as soon as you entered some (more details about this
  1899.      subject later on). This listview can be controlled by mouse as
  1900.      usual or completely by keyboard:
  1901.              Cursor down     The next address becomes the current one.
  1902.           
  1903.           SHIFT+Cursor down  The list scrolls @{b}up@{ub} by one page.
  1904.           
  1905.           CRTL+Cursor down   The last address becomes the current one.
  1906.           
  1907.               Cursor up      The previous address becomes the current one.
  1908.           
  1909.            SHIFT+Cursor up   The list scrolls @{b}down@{ub} by one page.
  1910.           
  1911.            CRTL+Cursor up    The first address becomes the current one.
  1912.           
  1913.                              The current entry is selected.
  1914.                SPACE         To make this state visible, the current entry
  1915.                              is leaded by a @{b}>@{ub} character.
  1916.           
  1917.                RETURN        Activates the @{b}Full@{ub} window, as long as
  1918.                              there is an active address item.
  1919.           
  1920.             SHIFT+RETURN     Activates the @{b}Edit@{ub} wenster, as long as
  1921.                              there is an active address item.
  1922.           
  1923.             SHIFT+SPACE      Set the start of the block or the end of the
  1924.                              block respectively
  1925.      You may select entries of the address list with @{b}Shift Left
  1926.      Mousebutton@{ub} or @{b}Middle Mousebutton Left Mousebutton@{ub} (3-Button mouse
  1927.      needed); alternatively you may hit @{b}SPACE@{ub} on the keyboard.  If you
  1928.      hit @{b}RETURN@{ub}, it has the same effect as if you had selected the @{b}Full@{ub}
  1929.      button: The current address is displayed in another window in
  1930.      further detail (please see @{"Full" Link "EditorFull"} for details). Synonymously you may
  1931.      hit @{b}SHIFT RETURN@{ub} to envoce the @{b}Edit@{ub} window (see @{"Edit" Link "EditorEdit"}).
  1932.      @{b}SHIFT RETURN@{ub} sets the start of the block or -- if you've already
  1933.      set it previously -- the end of the block. After the block end is
  1934.      set, the selection state of all items between start end end of the
  1935.      block is toggled, i.e. the selected addresses become deselected
  1936.      and vice versa. The same result can be reached, if you use the left
  1937.      mouse button together with the @{b}SHIFT@{ub} qualifier.
  1938.      Please notice that you may change the fields of the addresses that
  1939.      are displayed in the address listview using the @{b}DFA-Preferences@{ub}
  1940.      program.
  1941.    @{b}*@{ub}     @{b}Der Panel-Listview@{ub}
  1942.      Below the address listview you find another listview. It is used to
  1943.      display some more fields of the current address item. If you use
  1944.      the default settings you'll see the phone number, the three email
  1945.      addresses and the comment. However, by using the @{b}DFA-Preferences@{ub}
  1946.      program you may change the contents of these lines!
  1947.      As this listview doesn't have a title and for this reason no
  1948.      shortcut either, you may scroll it using the following keys:
  1949.           ALT+Cursor down  The list scrolls @{b}up@{ub} by one line.
  1950.           ALT+Cursor up   The list scrolls @{b}down@{ub} by one line.
  1951.      Of course, the list can only be scrolled if there is 1st an active
  1952.      entry and 2nd more lines to display than visible at the same time.
  1953.      The contents of this listview can be configured in quite a wide
  1954.      range (see @{b}DFA-Preferences@{ub}: Panel Listview, for details).
  1955. Just below the the address listview there are four buttons that may be
  1956. used to change the selection of the displayed addresses:
  1957.    @{b}*@{ub}     @{b}All@{ub}
  1958.      Selects all displayed addresses.
  1959.    @{b}*@{ub}     @{b}By name@{ub}
  1960.      A window is opened in which you may enter a search pattern (case
  1961.      insensitive!). After you hit @{b}Ok@{ub} (or @{b}RETURN@{ub}) all entries of the
  1962.      address list are selected that match the pattern. The difference
  1963.      to the @{b}Search@{ub} function is that 1st you can't toggle case
  1964.      sensitivity and 2nd all address fields are searched through.
  1965.      Furthermore all matching items are @{b}marked@{ub} and the first matching
  1966.      item is activated. A detailed description of the allowed search
  1967.      patterns can be found in @{"Search" Link "EditorSearch"}.
  1968.    @{b}*@{ub}     @{b}Clear@{ub}
  1969.      All selected addresses are deselected.
  1970.    @{b}*@{ub}     @{b}Jump to@{ub}
  1971.      The next selected entry becomes the current one, as long as there
  1972.      is at least one selected entry left.
  1973. At the lower end of the main window of the @{b}DFA-Editor@{ub} you can find the
  1974. gadgets @{b}Quit@{ub} and @{b}Remove@{ub}.
  1975. If you hit @{b}Quit@{ub} the @{b}DFA-Editor@{ub} is terminated! The @{b}DFA-Server@{ub}, if it is
  1976. currently running, is not ended however, so you can still reach the
  1977. @{b}DFA-Editor@{ub} by a doubleclick on the application icon and/or the hotkey
  1978. (default: @{b}Left Amiga F5@{ub})
  1979. If you select @{b}Remove@{ub}, not only the @{b}DFA-Editor@{ub} is ended, but although a
  1980. currently running @{b}DFA-Server@{ub}.
  1981. If you terminate the @{b}DFA-Editor@{ub} using @{b}Quit@{ub} or @{b}Remove@{ub}, the addresses are
  1982. saved if they had been modified before.  This behaviour can be
  1983. customized in the @{b}DFA-Preferences@{ub} however.
  1984. @EndNode
  1985. @Node "EditorTools" "dfa.guide/EditorTools"
  1986. @Next "EditorMenus"
  1987. @Prev "EditorMainWindow"
  1988. @Toc "DFAEditor"
  1989. Tool Gadgets
  1990. ============
  1991. It is possible reach the socalled tool gadgets from the @{b}DFA-Editor@{ub}.
  1992. Using these gadgets you can easily reach the following functions :
  1993.    @{b}*@{ub}     @{b}Full@{ub}
  1994.      Shows the current entry in another window in great detail; see
  1995.      @{"Full" Link "EditorFull"}, for details.
  1996.    @{b}*@{ub}     @{b}Edit@{ub}
  1997.      If you hit @{b}Edit@{ub}, you may change the current entry. If there is no
  1998.      current address, this button is displayed "ghosted" and can't be
  1999.      selected (cf. @{"Edit" Link "EditorEdit"}).
  2000.    @{b}*@{ub}     @{b}New@{ub}
  2001.      If you select @{b}New@{ub}, you may enter a @{b}new@{ub} address. The functions
  2002.      within this window are exactly the same as within the @{b}Edit@{ub} window;
  2003.      see @{"Edit" Link "EditorEdit"} for details.
  2004.    @{b}*@{ub}     @{b}Kill@{ub}
  2005.      Kill can either be used to delete the current entry (if there is
  2006.      one) or all marked entries. To make sure that nobody deletes
  2007.      precious addresses, a safety requester pops up!
  2008.    @{b}*@{ub}     @{b}Search@{ub}
  2009.      Another window pops up, in which you may enter a search string as
  2010.      well as some other search related settings (cf. @{"Search" Link "EditorSearch"}).
  2011.    @{b}*@{ub}     @{b}Search Next@{ub}
  2012.      @{b}Search Next@{ub} can be selected only, if there has been given a search
  2013.      pattern previously using the @{b}Search@{ub} function. If this is the case,
  2014.      the next matching entry is displayed (not marked!).
  2015.    @{b}*@{ub}     @{b}Print@{ub}
  2016.      After you have selected @{b}Print@{ub}, another window pops up, which gives
  2017.      you several ways to print your addresses, as it is described in
  2018.      @{"Print" Link "EditorPrint"}.
  2019.    @{b}*@{ub}     @{b}Sort@{ub}
  2020.      @{b}Sort@{ub} sorts the complete address list. As long as you use the
  2021.      default setting the list is sorted by name, first name and city (in
  2022.      this order). If you prefer another sort order, you may change it in
  2023.      the @{b}DFA-Preferences@{ub}.
  2024.    @{b}*@{ub}     @{b}Dial@{ub}
  2025.      Another window pops up, which allows you to dial phone numbers (cf.
  2026.      @{"Dial" Link "EditorDial"}).
  2027. Please notice that there is a corresponding menu item for every tool
  2028. gadget. All functions can therefore be reached by keyboard shortcuts as
  2029. well!
  2030. @EndNode
  2031. @Node "EditorMenus" "dfa.guide/EditorMenus"
  2032. @Next "EditorFull"
  2033. @Prev "EditorTools"
  2034. @Toc "DFAEditor"
  2035. The Menu Items
  2036. ==============
  2037. @{b}Project Menu@{ub}
  2038.  @{"       About        " Link "EditorMenuAbout"}                 
  2039.  @{"       Info         " Link "EditorMenuInfo"}                
  2040.  @{"     New file       " Link "EditorMenuNewFile"}                   
  2041.  @{"       Open         " Link "EditorMenuOpen"}                
  2042.  @{"      Append        " Link "EditorMenuAppend"}                  
  2043.  @{"       Save         " Link "EditorMenuSave"}                
  2044.  @{"     Save as...     " Link "EditorMenuSaveas"}                  
  2045.  @{"  Save as default   " Link "EditorMenuSaveasdefault"}                         
  2046.  @{"       Quit         " Link "EditorMenuQuit"}                
  2047.  @{"      Remove        " Link "EditorMenuRemove"}                  
  2048. @{b}Edit Menu@{ub}
  2049.  @{"       Full         " Link "EditorMenuFull"}                
  2050.  @{"       Edit         " Link "EditorMenuEdit"}                
  2051.  @{"       New          " Link "EditorMenuNew"}               
  2052.  @{"       Kill         " Link "EditorMenuKill"}                
  2053.  @{" Copy to Clipboard  " Link "EditorMenuCopyToClip"}                      
  2054.  @{"   (Un)set Groups   " Link "EditorMenuSetGroups"}                     
  2055. @{b}Misc Menu@{ub}
  2056.  @{"      Search        " Link "EditorMenuSearch"}                  
  2057.  @{"   Search Next      " Link "EditorMenuSearchNext"}                      
  2058.  @{"      Print         " Link "EditorMenuPrint"}                 
  2059.  @{"       Sort         " Link "EditorMenuSort"}                
  2060.  @{"       Dial         " Link "EditorMenuDial"}                
  2061. @{b}Settings Menu@{ub}
  2062.  @{"   Preferences      " Link "EditorMenuPreferences"}                       
  2063.  @{"  Edit Template     " Link "EditorMenuEditTemplate"}                        
  2064.  @{"   Write Access     " Link "EditorMenuWriteAccess"}                       
  2065.  @{" Save Preferences   " Link "EditorMenuSavePrefs"} 
  2066. @EndNode
  2067. @Node "EditorMenuAbout" "dfa.guide/EditorMenuAbout"
  2068. @Next "EditorMenuInfo"
  2069. @Toc "EditorMenus"
  2070. About
  2071. -----
  2072. The @{b}About@{ub} window gives you some useful informations about the program
  2073. and the author:
  2074.    @{b}*@{ub} The version number and a corresponding remark, if you got a
  2075.      registered version.
  2076.    @{b}*@{ub} The copyright notice and the author's address (incl. email
  2077.      addresses).
  2078.    @{b}*@{ub} Your name and your address, as well as the serial number of the
  2079.      program, if you are a registered user.
  2080. @EndNode
  2081. @Node "EditorMenuInfo" "dfa.guide/EditorMenuInfo"
  2082. @Next "EditorMenuNewFile"
  2083. @Prev "EditorMenuAbout"
  2084. @Toc "EditorMenus"
  2085. The window which pops up as soon as you select the @{b}Info@{ub} menu item gives
  2086. you some useful informations:
  2087.    @{b}*@{ub}     @{b}Arexx Port@{ub}
  2088.      In this field you can look up the name of @{b}DFA@{ub}'s AREXX port. Usually
  2089.      this is @{b}DFA@{ub}. However, you can change the portname by changing the
  2090.      @{b}PORTNAME@{ub} tooltype (of the @{b}DFA@{ub} server program!)
  2091.      If you have already started a program that uses the portname @{b}DFA@{ub},
  2092.      @{b}DFA@{ub} adapts the portname by appending "numbers" (e.g.  @{b}DFA.1@{ub},
  2093.      @{b}DFA.2@{ub},...) until a clear portname is found.
  2094.    @{b}*@{ub}     @{b}Addresses@{ub}
  2095.      The number of the currently loaded address is displayed here. The
  2096.      first number (@{b}d@{ub} means displayed)  is the number of actually
  2097.      displayed entries, the second number (@{b}a@{ub} means available) is the
  2098.      number of addresses available.
  2099.    @{b}*@{ub}     @{b}Memory Condition@{ub}
  2100.      The three fields give a quite detailed report about the current
  2101.      memory condition.
  2102. @EndNode
  2103. @Node "EditorMenuNewFile" "dfa.guide/EditorMenuNewFile"
  2104. @Next "EditorMenuOpen"
  2105. @Prev "EditorMenuInfo"
  2106. @Toc "EditorMenus"
  2107. New file
  2108. --------
  2109. If you want to create a @{b}new@{ub}, i.e. @{b}empty@{ub} address file, you may use this
  2110. menu item. A new address file named unnamed.dfa is created then. You
  2111. may use the @{b}Save as...@{ub} menu item to save this address file under
  2112. another name.
  2113. @{b}Be careful:@{ub}
  2114. Please do never use @{b}Save as default@{ub} after you created a new file to
  2115. save it, as the new address file (the empty one!) would overwrite your
  2116. old "default" address file, which means that the old addresses would
  2117. have been lost!
  2118. @EndNode
  2119. @Node "EditorMenuOpen" "dfa.guide/EditorMenuOpen"
  2120. @Next "EditorMenuAppend"
  2121. @Prev "EditorMenuNewFile"
  2122. @Toc "EditorMenus"
  2123. Use @{b}Open@{ub} to load another address file. The currently loaded addresses
  2124. are not kept in memory but replaced by the loaded! After you selected
  2125. @{b}Load@{ub}, a file requester pops up, which lets you enter the address file.
  2126. Notice that only files can be loaded, which have the proper format --
  2127. files that have been created by @{b}DFA@{ub} before!  Files with the wrong
  2128. format can't be loaded by @{b}DFA@{ub} and the already loaded addresses keep
  2129. unchanged!
  2130. @EndNode
  2131. @Node "EditorMenuAppend" "dfa.guide/EditorMenuAppend"
  2132. @Next "EditorMenuSave"
  2133. @Prev "EditorMenuOpen"
  2134. @Toc "EditorMenus"
  2135. Append
  2136. ------
  2137. @{b}Append@{ub} allows you to append further addresses to the existing ones. The
  2138. already loaded addresses are @{b}not@{ub} deleted before. Be careful! If you
  2139. append two identical address lists, every entry will appear twice,
  2140. which is usually not desired.
  2141. It is possible to set the group selection for the addresses that are to
  2142. be appended in the little window that appears after you selected
  2143. @{b}Append@{ub}. These group selection flags are set to all addresses that
  2144. shall be loaded!
  2145. Please notice that already existing group flags of addresses in the
  2146. file to append are @{b}not@{ub} erased! This means that you may only add new
  2147. group flags to the addresses but not unset existing ones!
  2148. @{b}Ok@{ub} accepts the set group selection and appends the selected address
  2149. file; @{b}Cancel@{ub} not only cancels the group selection but the complete
  2150. appending procedure, i.e. no addresses are appended!
  2151. @EndNode
  2152. @Node "EditorMenuSave" "dfa.guide/EditorMenuSave"
  2153. @Next "EditorMenuSaveas"
  2154. @Prev "EditorMenuAppend"
  2155. @Toc "EditorMenus"
  2156. @{b}Save@{ub} saves the addresses under the current name. The current name is
  2157. either the one you entered in the preferences (default: @{b}s:adr.file@{ub}) or
  2158. the one you selected before when loading an address file.
  2159. @EndNode
  2160. @Node "EditorMenuSaveas" "dfa.guide/EditorMenuSaveas"
  2161. @Next "EditorMenuSaveasdefault"
  2162. @Prev "EditorMenuSave"
  2163. @Toc "EditorMenus"
  2164. Save as...
  2165. ----------
  2166. @{b}Save as@{ub} saves the address as well. However, you are able to select a
  2167. filename before (a file requester pops up). This may be useful, if you
  2168. have several address files for different purposes or you've created a
  2169. new address file just before (cf.  @{"New file" Link "EditorMenuNewFile"}) and want to enter a new
  2170. name for your address file.
  2171. @EndNode
  2172. @Node "EditorMenuSaveasdefault" "dfa.guide/EditorMenuSaveasdefault"
  2173. @Next "EditorMenuQuit"
  2174. @Prev "EditorMenuSaveas"
  2175. @Toc "EditorMenus"
  2176. Save as default
  2177. ---------------
  2178. The addresses will be saved under the name specified in the preferences
  2179. (default: @{b}s:adr.file@{ub}), if you select @{b}Save as default@{ub}, even if you
  2180. loaded a file with another name before.
  2181. @{b}Be careful:@{ub}
  2182. If you have loaded an address file with another but the default name
  2183. before (or you've created a new address file), you should not use
  2184. @{b}Save as default@{ub} in any case, as the current address file would
  2185. overwrite the default address file.
  2186. @EndNode
  2187. @Node "EditorMenuQuit" "dfa.guide/EditorMenuQuit"
  2188. @Next "EditorMenuRemove"
  2189. @Prev "EditorMenuSaveasdefault"
  2190. @Toc "EditorMenus"
  2191. @{b}Quit@{ub} ends the @{b}DFA-Editor@{ub}! The @{b}DFA-Server@{ub}, if it is currently running,
  2192. is not ended, so it the @{b}DFA-Editor@{ub} still can be reached by a double
  2193. click on the application icon or by the hotkey (Default: @{b}Left Amiga F5@{ub}).
  2194. @EndNode
  2195. @Node "EditorMenuRemove" "dfa.guide/EditorMenuRemove"
  2196. @Next "EditorMenuFull"
  2197. @Prev "EditorMenuQuit"
  2198. @Toc "EditorMenus"
  2199. Remove
  2200. ------
  2201. Select @{b}Remove@{ub} to end not only the @{b}DFA-Editor@{ub} but a currently running
  2202. @{b}DFA-Server@{ub} as well.
  2203. If you end the @{b}DFA-Editor@{ub} using @{b}Quit@{ub} or @{b}Remove DFA@{ub}, the addresses are
  2204. saved, if they have been modified before. This behaviour can be
  2205. customized in the @{b}DFA-Preferences@{ub} program however.
  2206. @EndNode
  2207. @Node "EditorMenuFull" "dfa.guide/EditorMenuFull"
  2208. @Next "EditorMenuEdit"
  2209. @Prev "EditorMenuRemove"
  2210. @Toc "EditorMenus"
  2211. Shows the current entry in a separate window. @{b}All@{ub} fields of the address
  2212. are displayed here; See @{"Full" Link "EditorFull"}.
  2213. @EndNode
  2214. @Node "EditorMenuEdit" "dfa.guide/EditorMenuEdit"
  2215. @Next "EditorMenuNew"
  2216. @Prev "EditorMenuFull"
  2217. @Toc "EditorMenus"
  2218. Using @{b}Edit@{ub} gives you the chance to change the current address item, if
  2219. there is one. If there is no current entry, the corresponding button is
  2220. "ghosted" and can't be selected (see @{"Edit" Link "EditorEdit"}).
  2221. @EndNode
  2222. @Node "EditorMenuNew" "dfa.guide/EditorMenuNew"
  2223. @Next "EditorMenuKill"
  2224. @Prev "EditorMenuEdit"
  2225. @Toc "EditorMenus"
  2226. Select @{b}New@{ub} to enter a @{b}new@{ub} address. The functions inside of this window
  2227. are exactly the same as within the @{b}Edit@{ub} window; see @{"Edit" Link "EditorEdit"} for details.
  2228. @EndNode
  2229. @Node "EditorMenuKill" "dfa.guide/EditorMenuKill"
  2230. @Next "EditorMenuCopyToClip"
  2231. @Prev "EditorMenuNew"
  2232. @Toc "EditorMenus"
  2233. Use @{b}Kill@{ub} to delete either the current entry (if there is one) or all
  2234. marked addresses. To make sure that nobody deletes precious addresses,
  2235. a savety requester pops up.
  2236. @EndNode
  2237. @Node "EditorMenuCopyToClip" "dfa.guide/EditorMenuCopyToClip"
  2238. @Next "EditorMenuSetGroups"
  2239. @Prev "EditorMenuKill"
  2240. @Toc "EditorMenus"
  2241. Copy to Clipboard
  2242. -----------------
  2243. This function makes it possible to copy the @{b}current@{ub} address to the
  2244. clipboard (unit 0).
  2245. Every other program that supplies clipboard support, can access these
  2246. data.
  2247. @EndNode
  2248. @Node "EditorMenuSetGroups" "dfa.guide/EditorMenuSetGroups"
  2249. @Next "EditorMenuSearch"
  2250. @Prev "EditorMenuCopyToClip"
  2251. @Toc "EditorMenus"
  2252. (Un)set Groups
  2253. --------------
  2254. After you have selected this menu item, another window pops up that
  2255. allows you to change the group flags of one, several or all addresses
  2256. fast and comfortably.
  2257. Using the upper eight group checkboxes, you can select, which group
  2258. flags you want to have @{b}cleared@{ub}.
  2259. The lower eight group checkboxes can be used to @{b}set@{ub} the corresponding
  2260. group flags.  To control even these gadgets by keyboard, you have to
  2261. push the @{b}CRTL@{ub} key in addition to the shortcut itself.
  2262. Please notice that these actions take effect only to the active
  2263. addresses, i.e. the addresses that can be seen within the main address
  2264. listview.
  2265. Hit @{b}Active@{ub} to change the current address (if there exists one), @{b}Marked@{ub}
  2266. to change all marked addresses and @{b}All@{ub} to (un)set the group flags of
  2267. all (visible) addresses.
  2268. @EndNode
  2269. @Node "EditorMenuSearch" "dfa.guide/EditorMenuSearch"
  2270. @Next "EditorMenuSearchNext"
  2271. @Prev "EditorMenuSetGroups"
  2272. @Toc "EditorMenus"
  2273. Search
  2274. ------
  2275. Another window pops up that allows you to enter several search criteria
  2276. (cf. @{"Search" Link "EditorSearch"}):
  2277. @EndNode
  2278. @Node "EditorMenuSearchNext" "dfa.guide/EditorMenuSearchNext"
  2279. @Next "EditorMenuPrint"
  2280. @Prev "EditorMenuSearch"
  2281. @Toc "EditorMenus"
  2282. Search Next
  2283. -----------
  2284. @{b}Search Next@{ub} can be selected only, if there has been given a search
  2285. pattern previously using the @{b}Search@{ub} function. If this is the case, the
  2286. next matching entry is displayed (not marked!).
  2287. @EndNode
  2288. @Node "EditorMenuPrint" "dfa.guide/EditorMenuPrint"
  2289. @Next "EditorMenuSort"
  2290. @Prev "EditorMenuSearchNext"
  2291. @Toc "EditorMenus"
  2292. Print
  2293. -----
  2294. After you have selected @{b}Print@{ub}, another window pops up, which gives you
  2295. several ways to print your addresses, as it is described in @{"Print" Link "EditorPrint"}.
  2296. @EndNode
  2297. @Node "EditorMenuSort" "dfa.guide/EditorMenuSort"
  2298. @Next "EditorMenuDial"
  2299. @Prev "EditorMenuPrint"
  2300. @Toc "EditorMenus"
  2301. @{b}Sort@{ub} sorts the complete address list. As long as you use the default
  2302. setting, the list is sorted by name, first name and city (in this
  2303. order). If you prefer another sort order, you may change it in the
  2304. @{b}DFA-Preferences@{ub}.
  2305. @EndNode
  2306. @Node "EditorMenuDial" "dfa.guide/EditorMenuDial"
  2307. @Next "EditorMenuPreferences"
  2308. @Prev "EditorMenuSort"
  2309. @Toc "EditorMenus"
  2310. Another window pops up, which allows you to dial phone numbers (cf.
  2311. @{"Dial" Link "EditorDial"}).
  2312. @EndNode
  2313. @Node "EditorMenuPreferences" "dfa.guide/EditorMenuPreferences"
  2314. @Next "EditorMenuEditTemplate"
  2315. @Prev "EditorMenuDial"
  2316. @Toc "EditorMenus"
  2317. Preferences
  2318. -----------
  2319. The @{b}DFA-Preferences@{ub} program is loaded. Please notice that the tooltype
  2320. @{b}DFAPREFS@{ub} of the @{b}DFA-Editor@{ub} has to be set correctly to enable the
  2321. @{b}DFA-Editor@{ub} to find the @{b}DFA-Preferences@{ub} program! This has usually
  2322. already been done by the install program.
  2323. @EndNode
  2324. @Node "EditorMenuEditTemplate" "dfa.guide/EditorMenuEditTemplate"
  2325. @Next "EditorMenuWriteAccess"
  2326. @Prev "EditorMenuPreferences"
  2327. @Toc "EditorMenus"
  2328. Edit Template
  2329. -------------
  2330. The window that pops up will be quite familiar to you, as it is exactly
  2331. the same as in @{"Edit" Link "EditorEdit"} or @{"New" Link "EditorNew"}. You may enter several @{b}presets@{ub} here, which
  2332. are automatically copied into the corresponding fields, just before you
  2333. enter a @{b}new@{ub} address. The template strings are saved in the address
  2334. file, so it is possible to have different templates for every address
  2335. file.
  2336. @EndNode
  2337. @Node "EditorMenuWriteAccess" "dfa.guide/EditorMenuWriteAccess"
  2338. @Next "EditorMenuSavePrefs"
  2339. @Prev "EditorMenuEditTemplate"
  2340. @Toc "EditorMenus"
  2341. Write Access
  2342. ------------
  2343. This menu item can only be selected, if you have activated the network
  2344. mode before.
  2345. Starting with version 2.0, @{b}DFA@{ub} supplies a simple network mode. This
  2346. network mode has been developed to make it possible that several
  2347. connected computers can use the same address file. The problem that
  2348. comes up, when an address file is used by more than one user at the
  2349. same time is the following:
  2350. If several users change the address file at the same time, the last
  2351. saved address file overwrites the previously saved ones. The previously
  2352. saved changes are lost!
  2353. @{b}DFA@{ub} tries to solve this problem in the following way:
  2354. If the network mode is active, all operations that change the address
  2355. database are forbidden, i.e. saving, changing, marking of addresses is
  2356. not possible. It is allowed however, to view the addresses (@{b}Full@{ub}), to
  2357. scroll within the address list, to print the addresses and so on.
  2358. If you want to do some changes on the addresses, you have to obtain
  2359. write access to the address file. This can be done using the AREXX
  2360. command @{b}ATTEMPTLOCK@{ub} or by selecting the menu item @{b}Write Access@{ub} in the
  2361. @{b}DFA-Editor@{ub}.
  2362. If your try to get write access was successful, you may change the
  2363. addresses. If you've completed your changes, you should free the write
  2364. access using either the AREXX command @{b}FREELOCK@{ub} or the menu item @{b}Write
  2365. Access@{ub} in the @{b}DFA-Editor@{ub}. After you have done so, other members of the
  2366. LAN can get write access to this address file.
  2367. Please note that you will only get advantages out of the network mode,
  2368. if you have really installed a network @{b}and@{ub} access the @{b}same@{ub} address file
  2369. from different computers! Activating the network mode on a computer
  2370. that is not connected to a network has no advantages at all!
  2371. @EndNode
  2372. @Node "EditorMenuSavePrefs" "dfa.guide/EditorMenuSavePrefs"
  2373. @Prev "EditorMenuWriteAccess"
  2374. @Toc "EditorMenus"
  2375. Save Preferences
  2376. ----------------
  2377. As the window coordinates and several other settings of the @{b}DFA-Editor@{ub}
  2378. are saved together with the preferences that can be tuned in the
  2379. @{b}DFA-Preferences@{ub} program, there is the opportunity to save the
  2380. preferences not only from within the @{b}DFA-Preferences@{ub} program, but from
  2381. the @{b}DFA-Editor@{ub} as well using this menu item.
  2382. @EndNode
  2383. @Node "EditorFull" "dfa.guide/EditorFull"
  2384. @Next "EditorEdit"
  2385. @Prev "EditorMenus"
  2386. @Toc "DFAEditor"
  2387. @{b}Full@{ub} can only be selected, if there is a current address! If this is
  2388. the case, another window pops up (title: @{b}Full address...@{ub}), which
  2389. displays @{b}all@{ub} fields of the current address.
  2390. If there is an external file for the current address, you may select
  2391. the @{b}View external@{ub} button to start the ASCII viewer together with the
  2392. corresponding external file.
  2393. Please notice that the ASCII viewer of your choice may be entered in
  2394. the @{b}DFA-Preferences@{ub} program (cf. @{"Edit" Link "EditorEdit"}).
  2395. The listview that displays the different fields of the current address
  2396. may be scrolled as follows:
  2397.       Cursor down       The listview scrolls @{b}up@{ub}.
  2398.      Cursor up        The listview scrolls @{b}down@{ub}.
  2399. Below this listview there is a gadget panel that may be used to step
  2400. through the addresses:
  2401.    @{b}*@{ub}     @{b}First@{ub}
  2402.      The first entry of the address list is displayed. Besides the
  2403.      underlined letter you may alternatively use @{b}CRTL + Cursor Left@{ub} as
  2404.      the corresponding gadget shortcut.
  2405.    @{b}*@{ub}     @{b}Last@{ub}
  2406.      The last entry of the address list is displayed. Besides the
  2407.      underlined letter you may alternatively use @{b}CRTL + Cursor Right@{ub} as
  2408.      the corresponding gadget shortcut.
  2409.    @{b}*@{ub}     @{b}Prev. Sel.@{ub}
  2410.      If there is a selected item infront of the current one, it is is
  2411.      displayed. Besides the underlined letter you may alternatively use
  2412.      @{b}SHIFT + Cursor Left@{ub} as the corresponding gadget shortcut.
  2413.    @{b}*@{ub}     @{b}Next Sel.@{ub}
  2414.      If there is a selected item behind of the current one, it is is
  2415.      displayed. Besides the underlined letter you may alternatively use
  2416.      @{b}SHIFT + Cursor Right@{ub} as the corresponding gadget shortcut.
  2417.    @{b}*@{ub}     @{b}Prev.@{ub}
  2418.      The previous entry of the address list is displayed. Besides the
  2419.      underlined letter you may alternatively use @{b}Cursor Left@{ub} as the
  2420.      corresponding gadget shortcut.
  2421.    @{b}*@{ub}     @{b}Next@{ub}
  2422.      The next entry of the address list is displayed. Besides the
  2423.      underlined letter you may alternatively use @{b}Cursor Left@{ub} as the
  2424.      corresponding gadget shortcut.
  2425. @{b}Ok@{ub} closes the window, @{b}Edit@{ub} opens the @{b}Edit@{ub} window. The @{b}Edit@{ub} window is
  2426. described in further detail in @{"Edit" Link "EditorEdit"}.
  2427. @EndNode
  2428. @Node "EditorEdit" "dfa.guide/EditorEdit"
  2429. @Next "EditorNew"
  2430. @Prev "EditorFull"
  2431. @Toc "DFAEditor"
  2432. If there exists a current address (cf. @{"Full" Link "EditorFull"}), a window pops up, where
  2433. you may change any part of the address. The string gadgets have some
  2434. additional features compared to the "original" ones:
  2435.    - Hit @{b}RETURN@{ub} to end the input to the current gadget and go to the
  2436.      next string or integer gadget. You may use the @{b}ENTER@{ub} key
  2437.      alternatively.
  2438.    - Hit @{b}SHIFT@{ub} @{b}RETURN@{ub} to end the input to the current gadget and go to
  2439.      the @{b}previous@{ub} gadget.
  2440.    -     @{b}CURSOR UP@{ub} or @{b}CURSOR DOWN@{ub} brings the cursor to the previous or
  2441.      next string gadget respectively.
  2442.    - Hit @{b}ESCAPE@{ub} to cancel the input completely.  The window which
  2443.      contains the gadget is closed and all previous input is discarded.
  2444.    - If the cursor stands within a string gadget, the gadget shortcuts
  2445.      can be reached by hitting @{b}RIGHT AMIGA@{ub}-@{b}letter@{ub} and @{b}SHIFT@{ub}. If you
  2446.      don't hit @{b}SHIFT@{ub} additionally, the keyboard shortcut is used either
  2447.      by the internal string gadget edit features (like @{b}RIGHT AMIGA X@{ub} or
  2448.      @{b}RIGHT AMIGA Q@{ub}) or by additional tools (like @{b}NewList@{ub}).
  2449. There exist the following fields:
  2450.      Address         Address
  2451.      First           First name
  2452.      Name            Name
  2453.      c/o             may be used for additional information
  2454.      Street          Street/No.
  2455.      Zip             Zip
  2456.      City            City
  2457.      State           State
  2458.      Country         Country
  2459.      Birthday        Birthday
  2460.      Phone           Telphone number
  2461.      Fax             Telefax number
  2462.      Email1          email address # 1
  2463.      Email2          email address # 2
  2464.      Email3          email address # 3
  2465.      Comment         Comment
  2466. Please notice that it is possible to enter more than one phone number
  2467. into the @{b}Phone@{ub} field. These numbers can be dialed correctly as well, as
  2468. long as you separate them by a pipe sign (@{b}|@{ub}).
  2469. Using the @{b}Address selected@{ub} checkbox you may set (or unset) the
  2470. selection state of the current address.
  2471. If you hit @{b}External@{ub} you activate the ASCII-Editor (default: @{b}ed@{ub}). This
  2472. makes sense if you want to enter a long text (for example: How to find
  2473. the way to Joe User, living in New York City).  When you have finished
  2474. your inputs, save the file with the @{b}given name@{ub} and quit the editor. The
  2475. @{b}DFA-Editor@{ub} remembers the file name, so it is possible from now on, to
  2476. access this external file e.g.  from the @{b}Full@{ub} window (cf. @{"Full" Link "EditorFull"}) or from
  2477. the @{b}Edit@{ub} window to modify it.
  2478. As soon as the there is an external file for the current address item,
  2479. the @{b}Del.@{ub} button can be reached that makes it possible to delete an
  2480. external file as soon as you no longer need it.
  2481. All external files get their unique file name by @{b}DFA@{ub}. This file name is
  2482. guarantied to be @{b}unique@{ub} within the given directory (default:
  2483. @{b}s:DFAExternals@{ub}). @{b}DFA@{ub} only saves the filename -- not the file itself, so
  2484. this is completely up to you.  Please do not change the filename given
  2485. by @{b}DFA@{ub}, as if you do so, @{b}DFA@{ub} will no longer be able to find this file!
  2486. If you want to delete one (or more) external files, you have to use the
  2487. @{b}Del.@{ub} function of this window. This is the only way to make sure that
  2488. not only the file itself is deleted, but the filename, which is stored
  2489. by @{b}DFA@{ub} as well!
  2490. You may set your favourite ASCII editor as well as the wanted directory
  2491. for the external files in the @{b}DFA-Preferences@{ub} program.
  2492. Hit @{b}Ok@{ub} to use the changes; if you select @{b}Cancel@{ub} instead, all changes
  2493. are discarded.
  2494. @EndNode
  2495. @Node "EditorNew" "dfa.guide/EditorNew"
  2496. @Next "EditorSearch"
  2497. @Prev "EditorEdit"
  2498. @Toc "DFAEditor"
  2499. @{b}New@{ub} opens a window that looks exactly like the @{b}Edit@{ub} window! The
  2500. templates (cf.  @{"Edit Template" Link "EditorMenuEditTemplate"}) have been copied into the corresponding
  2501. fields and you may enter a new address now. All functions within this
  2502. window are the same as in the @{b}Edit@{ub} window (see @{"Edit" Link "EditorEdit"} for details).
  2503. @EndNode
  2504. @Node "EditorSearch" "dfa.guide/EditorSearch"
  2505. @Next "EditorPrint"
  2506. @Prev "EditorNew"
  2507. @Toc "DFAEditor"
  2508. Search
  2509. ======
  2510. You may enter several search criteria in this window.
  2511.    @{b}*@{ub}     @{b}Search for@{ub}
  2512.      Here you may enter the search pattern. You may (and must) use the
  2513.      known @{b}AMIGA@{ub} patterns.  It is needed to enter infront of and behind
  2514.      the search string either a @{b}#?@{ub} or a @{b}*@{ub} if you want to look for
  2515.      partial strings!  This means, you have to input @{b}#?PartialString#?@{ub}
  2516.      instead of @{b}PartialString@{ub}. Let's say you want to search for first
  2517.      names that start with @{b}Mi@{ub}, you have to enter @{b}Mi#?@{ub}. If you want to
  2518.      look for cities that end in @{b}town@{ub}, you have to enter @{b}#?town@{ub}.
  2519.      The following patterns are supported:
  2520.     ?
  2521.           The question mark matches any single character. For example,
  2522.           the pattern matching string @{b}A?B@{ub} matches any string that is
  2523.           three letters long, that starts with an @{b}A@{ub} and ends with a @{b}B@{ub}.
  2524.     #
  2525.           The number sign matches strings containing zero or more
  2526.           repetitions of the expression that immediately follows the @{b}#@{ub}
  2527.           in the pattern matching string.  For example, the pattern
  2528.           matching string @{b}#A@{ub} matches any string that consists of one or
  2529.           more of the @{b}A@{ub} character.  The pattern matching string @{b}#?@{ub}
  2530.           matches any non-NULL string.  The @{b}#@{ub} can apply to entire
  2531.           substrings delimited by parentheses.  For example, the
  2532.           pattern string @{b}#(AB)@{ub} matches any string consisting of one or
  2533.           more repetitions of the substring @{b}AB@{ub} (@{b}AB@{ub}, @{b}ABAB@{ub}, @{b}ABABAB@{ub},...).
  2534.     %
  2535.           Matches the NULL string.
  2536.     |
  2537.           This is the OR symbol.  This matches strings that contain the
  2538.           expressions on either side of the OR sign.  The expressions
  2539.           and the OR symbol need to be enclosed in parentheses.  For
  2540.           example, the pattern matching string @{b}(A|B)@{ub} matches the string
  2541.           @{b}A@{ub} or the string @{b}B@{ub}.  The pattern matching string @{b}A(B|%|C)@{ub}
  2542.           matches the strings @{b}AB@{ub}, @{b}A@{ub}, and @{b}AC@{ub}.
  2543.     ~
  2544.           The tilde negates the expression that follows it.  All
  2545.           strings that do not match the expression that follows the
  2546.           tilde will match the expression with the tilde.  For example,
  2547.           the pattern matching string @{b}~(#?.info)@{ub} matches any string that
  2548.           does not match the string @{b}#?.info@{ub} (does not end with the
  2549.           substring @{b}.info@{ub}).
  2550.     *
  2551.           The star is provided as an synonym to @{b}#?@{ub}.
  2552.     [ ]
  2553.           All characters within brackets indicate a character class.
  2554.           Any character in the character class qualifies.  Within a
  2555.           character class, a character range can be indicated by
  2556.           specifing the start and stop character, separated with a
  2557.           minus sign.  Note that character classes are case sensitive.
  2558.           If character classes are to be used in a case insensitive
  2559.           form, they should be translated to uppercase.  Here are some
  2560.           examples:
  2561.          [ACF]#?
  2562.                matches strings starting with @{b}A@{ub}, @{b}C@{ub}, or @{b}F@{ub}
  2563.          [A-D]#?
  2564.                matches strings starting with @{b}A@{ub}, @{b}B@{ub}, @{b}C@{ub} or @{b}D@{ub}
  2565.          [~ACF]#?
  2566.                matches strings @{b}not@{ub} starting with @{b}A@{ub}, @{b}C@{ub} or @{b}F@{ub}
  2567.     '
  2568.           The quote character neutralizes the special meaning of a
  2569.           special character.  Here are some examples:
  2570.          '#'?
  2571.                matches only the literal string @{b}#?@{ub}
  2572.          '?(A|B|C|%)'# matches the literal strings @{b}?#@{ub}, @{b}?A#@{ub},
  2573.                @{b}?B#@{ub}, @{b}?C#@{ub}
  2574.          "
  2575.                The quote itself
  2576.     ( )
  2577.           Parentheses group special characters.  The expression within
  2578.           the parentheses is a subpattern.
  2579.    @{b}*@{ub}     @{b}Ignore case@{ub}
  2580.      If the box is "checked", the search will not be case sensitive. If
  2581.      the box is empty however, case will be noticed.
  2582.    @{b}*@{ub}     @{b}All@{ub}
  2583.      Select all fields.
  2584.    @{b}*@{ub}     @{b}None@{ub}
  2585.      Deselects all fields.
  2586.    @{b}*@{ub}     @{b}Fields to search@{ub}
  2587.      You may select which fields you would like to search through. It is
  2588.      possible to toggle each single field. The default is to search
  2589.      trough all fields.
  2590.    @{b}*@{ub}     @{b}Search@{ub}
  2591.      @{b}Search@{ub} starts the searching. If a matching item is found, the
  2592.      address listview scrolls to the corresponding place and the
  2593.      matching entry becomes the current one.
  2594.    @{b}*@{ub}     @{b}Cancel@{ub}
  2595.      @{b}Cancel@{ub} terminates the search.
  2596. @EndNode
  2597. @Node "EditorPrint" "dfa.guide/EditorPrint"
  2598. @Next "EditorDial"
  2599. @Prev "EditorSearch"
  2600. @Toc "DFAEditor"
  2601. Print
  2602. =====
  2603. This window contains all functions that may be used to print the
  2604. addresses.
  2605.    @{b}*@{ub}     @{b}Print@{ub}
  2606.      You can choose between all (@{b}All@{ub}), the marked (@{b}Selected@{ub}) and the
  2607.      active address (@{b}Active@{ub}).  If there is an active item, it will be
  2608.      shown in the @{b}Active Item@{ub} field.
  2609.    @{b}*@{ub}     @{b}Print to@{ub}
  2610.      You can either print to the printer (@{b}PRT:@{ub}) or to a file (@{b}File@{ub}). If
  2611.      you print your addresses to a file, the settings below don't take
  2612.      effect. Notice that always all parts of an address are written to
  2613.      the file!
  2614.    @{b}*@{ub}     @{b}Print style@{ub}
  2615.      You may choose, whether the addresses are to be printed in @{b}NLQ@{ub} or
  2616.      @{b}Condensed@{ub} style (or both).
  2617.      If you select @{b}Formfeed@{ub}, a formfeed is performed after the very
  2618.      @{b}last@{ub} printed address entry.  To switch this off will be useful,
  2619.      if you want to print a few address labels only and you don't want
  2620.      to waste these sheets.
  2621.    @{b}*@{ub}     @{b}Print form@{ub}
  2622.      There are five different forms, between which you may choose:
  2623.         - Short address list
  2624.         - Full address list
  2625.         - Phonelist (fixed columns)
  2626.         - Mailing labels (70mm x 36mm)
  2627.         - Address cards
  2628.    @{b}*@{ub}     @{b}Print@{ub}
  2629.      If you did select @{b}File@{ub} for output, a file requester will be
  2630.      opened, which allows you to enter the filename.  Be careful!  This
  2631.      output file is @{b}not@{ub} compatible to the internal address file format
  2632.      (default: @{b}s:adr.file@{ub}); so don't overwrite this (these) file(s). To
  2633.      write the addresses to a file may be useful if you want to export
  2634.      addresses, but don't wan't to use AREXX.
  2635.      If you send your addresses to the printer (@{b}PRT:@{ub}), another window
  2636.      is opened that displays the progress of printing. You may stop the
  2637.      output after every complete address (@{b}Cancel@{ub}). If only the active
  2638.      item is printed, no progress indicator is shown.
  2639.    @{b}*@{ub}     @{b}Cancel@{ub}
  2640.      @{b}Cancel@{ub} terminates the complete printing process.
  2641. Please notice:
  2642. Of course the possibilities of @{b}DFA@{ub} to print addresses are a bit limited
  2643. and don't have any chance to compete with the facilities given by e.g.
  2644. a DTP program. I think however that it does make much more sense to let
  2645. programs print your addresses that are specialized in printing. Such
  2646. programs give you much more features and often result in a much better
  2647. printing quality than an address utility could ever reach. So @{b}DFA@{ub}
  2648. should be used to supply the stored addresses to (spezialized) printing
  2649. programs and not not print the addresses by itself. An ideal mean for
  2650. this purpose is the AREXX port for sure, which is not only part of @{b}DFA@{ub},
  2651. but of many printing programs as well.
  2652. Even if your favourite printing program doesn't have an AREXX port, you
  2653. may use @{b}DFA@{ub}'s AREXX interface to export and format the address, so
  2654. other programs can easily use them.
  2655. @EndNode
  2656. @Node "EditorDial" "dfa.guide/EditorDial"
  2657. @Prev "EditorPrint"
  2658. @Toc "DFAEditor"
  2659. For owners of modems only!
  2660. If you have a modem connected to your computer, it will be possible to
  2661. let the computer dial the phone number(s). If you have entered more
  2662. than one number, it is @{b}strictly@{ub} recommended that you seperate them by a
  2663. @{b}pipe@{ub} sign (@{b}|@{ub}). When you start dialing (hit @{b}Dial@{ub}), a window pops up that
  2664. displays who is called. You can cancel the dialing at every time
  2665. (@{b}Cancel@{ub}) or skip the current number (@{b}Skip@{ub}). The modem settings
  2666. can be changed in the @{b}DFA-Preferences@{ub} program.
  2667. @EndNode
  2668. @Node "DFAPrefs" "dfa.guide/DFAPrefs"
  2669. @Toc "Main"
  2670. The DFA-Preferences Program
  2671. ***************************
  2672. The @{b}DFA-Preferences@{ub} program (filename: @{b}DFAPrefs@{ub}) may be used to
  2673. configure @{b}DFA@{ub}. It can be started from the @{b}DFA-Editor@{ub} (menu item
  2674. @{b}Settings->Preferences@{ub}) as well as directly from the Workbench or the
  2675. Shell.
  2676.  @{"    Tooltypes     " Link "PrefsTooltypes"}                
  2677.  @{"  CLI parameter   " Link "PrefsCLIParams"}                
  2678.  @{" The main window  " Link "PrefsMainWindow"}                 
  2679.  @{"  Miscellaneous   " Link "PrefsMisc"}                     AppIcon, Autosave,
  2680.                                         icon generation, network support
  2681.  @{" Address listview " Link "PrefsAList"}                     Format of the DFAEditor main
  2682.                                         (address) listview
  2683.  @{"  Panel Listview  " Link "PrefsPList"}                     Format of the "Panel" listview
  2684.  @{"      Groups      " Link "PrefsGroups"}                     Title and shortcut for the groups
  2685.  @{"      Fonts       " Link "PrefsFonts"}                     Fonts for the @{b}DFA-Editor@{ub}
  2686.                                         and the  @{b}DFA-Preferences@{ub} program
  2687.  @{"      Modem       " Link "PrefsModem"}                     Modem configuration
  2688.  @{"       Paths      " Link "PrefsPaths"}                     File- and pathnames used by @{b}DFA@{ub}
  2689.  @{"  Arexx-Commands  " Link "PrefsArexxCmds"}                     Binding of AREXX scripts
  2690.                                         to function keys
  2691.  @{"       Sort       " Link "PrefsSort"}                     sort criteria for the addresses
  2692. @EndNode
  2693. @Node "PrefsTooltypes" "dfa.guide/PrefsTooltypes"
  2694. @Next "PrefsCLIParams"
  2695. @Toc "DFAPrefs"
  2696. Tooltypes
  2697. =========
  2698. If you click on the @{b}DFA-Editor@{ub} icon once and then activate the
  2699. Information program of the Workbench, you may adjust the following
  2700. tooltypes:
  2701.    @{b}*@{ub}     @{b}@{b}PUBSCREEN@{ub}@{ub}
  2702.      If you enter the @{b}name@{ub} of a public screen together with this
  2703.      tooltype, you may select an alternate (public) screen for the
  2704.      @{b}DFA-Preferences@{ub} program to open on.
  2705.      For example:
  2706.               PUBSCREEN=TERM
  2707.      If the given public screen exists when the @{b}DFA-Preferences@{ub} program
  2708.      comes up, it opens its window(s) on this screen, otherwise on the
  2709.      default public screen, usually the Workbench screen.
  2710.    @{b}*@{ub}     @{b}@{b}UPPERPUBSCREEN@{ub}@{ub}
  2711.      If you enter @{b}UPPERPUBSCREEN=YES@{ub}, you tell the @{b}DFA-Prefs@{ub} program to
  2712.      open its window(s) on the frontmost @{b}public@{ub} screen. If the current
  2713.      frontmost screen isn't public, the @{b}DFA-Preferences@{ub} program comes
  2714.      up on the screen you selected with the tooltype @{b}PUBSCREEN@{ub}; if this
  2715.      fails as well, the @{b}DFA-Preferences@{ub} program opens its window(s) on
  2716.      the default public screen.
  2717.    @{b}*@{ub}     @{b}@{b}GUIDEFILE@{ub}@{ub}
  2718.      To make the online help work, the @{b}DFA-Preferences@{ub} program has to
  2719.      know where to find the online help file. This can be done via the
  2720.      tooltype @{b}GUIDEFILE@{ub}. This tooltype is usually already set by the
  2721.      install program.
  2722. @EndNode
  2723. @Node "PrefsCLIParams" "dfa.guide/PrefsCLIParams"
  2724. @Next "PrefsMainWindow"
  2725. @Prev "PrefsTooltypes"
  2726. @Toc "DFAPrefs"
  2727. CLI-Parameter
  2728. =============
  2729. If you start the @{b}DFA-Preferences@{ub} program from the shell (or the CLI),
  2730. it uses the @{b}tooltypes@{ub} of the corresponding @{b}.info@{ub} file! However, you may
  2731. overwrite these setting by giving one or more of the following CLI
  2732. parameters:
  2733.      PUBSCREEN/K, UPPERPUBSCREEN/K, GUIDEFILE/K
  2734. This means, you may use...
  2735.    ...   @{b}DFAPrefs PUBSCREEN=TERM@{ub} to make the @{b}DFA-Preferences@{ub} program
  2736.      open its window(s) on the public screen named @{b}TERM@{ub}.
  2737.    ...   @{b}DFAPrefs UPPERPUBSCREEN=YES@{ub} to make the @{b}DFA-Preferences@{ub}
  2738.      program open its window(s) on the frontmost screen, as long as
  2739.      this is a public screen.
  2740.    ...   @{b}DFAPrefs GUIDEFILE=Help:DFAPrefs.guide@{ub} to set another path for
  2741.      the online help file.
  2742. @EndNode
  2743. @Node "PrefsMainWindow" "dfa.guide/PrefsMainWindow"
  2744. @Next "PrefsMisc"
  2745. @Prev "PrefsCLIParams"
  2746. @Toc "DFAPrefs"
  2747. The DFA-Preferences Main Window
  2748. ===============================
  2749. From the main window you can reach all subwindows. You may either open
  2750. one subwindow at a time or several subwindows at the same time.
  2751. Furthermore the following functions may be reached via buttons:
  2752.    @{b}*@{ub}     @{b}Save@{ub}
  2753.      Saves the preferences.
  2754.    @{b}*@{ub}     @{b}Use@{ub}
  2755.      Saves the preferences temporarily to @{b}ENV:@{ub}, i.e. the preferences
  2756.      stay active until you reboot the computer.
  2757.    @{b}*@{ub}     @{b}Remove DFA@{ub}
  2758.      Removes a running @{b}DFA@{ub} application, i.e. the @{b}DFA-Server@{ub} @{b}and@{ub} the
  2759.      @{b}DFA-Editor@{ub} will be terminated, if they are currently running.
  2760.    @{b}*@{ub}     @{b}Quit@{ub}
  2761.      Quits the @{b}DFA-Preferences@{ub} program.
  2762. You may reach the following functions via the @{b}Project@{ub} menu:
  2763.    @{b}*@{ub}     @{b}About@{ub}
  2764.      In the @{b}About@{ub} window you'll find something useful about the program
  2765.      itself and the author:
  2766.         - the version number as well as a notice, if you are a
  2767.           registered user.
  2768.         - The copyright notice and the address of the author (incl.
  2769.           email address(es)).
  2770.         - Your name, address and the serial number if you are a
  2771.           registered user.
  2772.    @{b}*@{ub}     @{b}Save@{ub}
  2773.      See above.
  2774.    @{b}*@{ub}     @{b}Remove DFA@{ub}
  2775.      See above.
  2776.    @{b}*@{ub}     @{b}Quit@{ub}
  2777.      See above.
  2778. @EndNode
  2779. @Node "PrefsMisc" "dfa.guide/PrefsMisc"
  2780. @Next "PrefsAList"
  2781. @Prev "PrefsMainWindow"
  2782. @Toc "DFAPrefs"
  2783. Miscelleneous
  2784. =============
  2785.  @{" Application Icon  " Link "PrefsAppIcon"}              
  2786.  @{"     Auto save     " Link "PrefsAutoSave"}               
  2787.  @{"   Generate Icon   " Link "PrefsGenIcon"}              
  2788.  @{"    Secret Mode    " Link "PrefsSecretMode"}                 
  2789.  @{"     Networking    " Link "PrefsNetworking"} 
  2790. @EndNode
  2791. @Node "PrefsAppIcon" "dfa.guide/PrefsAppIcon"
  2792. @Next "PrefsAutoSave"
  2793. @Toc "PrefsMisc"
  2794. Application Icon
  2795. ----------------
  2796.      The string gadgets @{b}XPos@{ub} and @{b}YPos@{ub} make it possible to enter the
  2797.      application icon's position on the Workbench screen (referring to
  2798.      the upper left corner of the screen)
  2799.      Alternatively to this direct input of raw coordinates there is a
  2800.      more convenient possibility to change the application icon's
  2801.      position:
  2802.      As soon as you click (once) on the cycle gadget @{b}Open position
  2803.      window@{ub}, a small window (title: @{b}Move me@{ub}) is opened. This window can
  2804.      be moved (using the mouse) on the Workbench. As soon as the
  2805.      position fits your wishes you should click on the gadget @{b}Close
  2806.      position window@{ub} (the same gadget as before, just with another text
  2807.      in it). The @{b}Move Me@{ub} window is closed and the new icon position is
  2808.      displayed in the @{b}XPos@{ub} and @{b}YPos@{ub} gadgets.
  2809.      Using the checkbox gadget @{b}Show@{ub}, you can switch the application
  2810.      icon on and off. Furthermore it can be used to make a previously
  2811.      changed icon position visible, by switching the application icon
  2812.      off and then on again.
  2813. @EndNode
  2814. @Node "PrefsAutoSave" "dfa.guide/PrefsAutoSave"
  2815. @Next "PrefsGenIcon"
  2816. @Prev "PrefsAppIcon"
  2817. @Toc "PrefsMisc"
  2818. Auto Save
  2819. ---------
  2820. There are several ways to make sure that your addresses are saved
  2821. regularly:
  2822.    @{b}*@{ub}     @{b}Save always@{ub}
  2823.      If you have changed some addresses using the @{b}DFA-Editor@{ub}, the
  2824.      address file is saved as soon as you leave the @{b}DFA-Editor@{ub} -- no
  2825.      matter if using @{b}Quit@{ub} or @{b}Remove@{ub}.
  2826.    @{b}*@{ub}     @{b}Ask@{ub}
  2827.      If the addresses have been changed, a requester pops up as soon as
  2828.      you want to leave the @{b}DFA-Editor@{ub}, which asks you if you would like
  2829.      to save the addresses.
  2830.    @{b}*@{ub}     @{b}Remove only@{ub}
  2831.      The changed addresses will only be saved, if the @{b}DFA-Editor@{ub} is
  2832.      left using the @{b}Remove@{ub} function (i.e. you quit the complete @{b}DFA@{ub}
  2833.      application), but not if you use the @{b}Quit@{ub} function.
  2834.      @{b}Be careful:@{ub}
  2835.      Please notice that the functions @{b}Quit@{ub} and @{b}Remove@{ub} of the @{b}DFA-Editor@{ub}
  2836.      are exactly the same, if you @{b}don't@{ub} have the @{b}DFA-Server@{ub} program
  2837.      running at the same time! If there is running only the @{b}DFA-Editor@{ub}
  2838.      and you've choosen @{b}Remove only@{ub} for auto save mode, changed
  2839.      addresses are @{b}not@{ub} saved, if you select @{b}Quit@{ub} in the @{b}DFA-Editor@{ub}.
  2840. @EndNode
  2841. @Node "PrefsGenIcon" "dfa.guide/PrefsGenIcon"
  2842. @Next "PrefsSecretMode"
  2843. @Prev "PrefsAutoSave"
  2844. @Toc "PrefsMisc"
  2845. Icon Creation
  2846. -------------
  2847. If you want @{b}DFA@{ub} to save an icon together with the address files, you
  2848. have to switch this checkbox to @{b}ON@{ub} state. To get an icon for every
  2849. address database file make sense e.g. if you like to use @{b}DFA@{ub}'s
  2850. application window.
  2851. @EndNode
  2852. @Node "PrefsSecretMode" "dfa.guide/PrefsSecretMode"
  2853. @Next "PrefsNetworking"
  2854. @Prev "PrefsGenIcon"
  2855. @Toc "PrefsMisc"
  2856. Secret Mode
  2857. -----------
  2858. Not everyone likes @{b}DFA@{ub} informing everybody about how many addresses are
  2859. sorted, saved, loaded and so on. If you select @{b}Secret Mode@{ub}, instead of
  2860. the number of addresses, three dots are displayed.
  2861. @EndNode
  2862. @Node "PrefsNetworking" "dfa.guide/PrefsNetworking"
  2863. @Prev "PrefsSecretMode"
  2864. @Toc "PrefsMisc"
  2865. Networking
  2866. ----------
  2867. Starting with version 2.0, @{b}DFA@{ub} supplies a simple network mode. This
  2868. network mode has been developed to make it possible that several
  2869. connected computers can use the same address file. The problem that
  2870. comes up, when an address file is used by more than one user at the
  2871. same time is the following:
  2872. If several users change the address file at the same time, the last
  2873. saved address file overwrites the previously saved ones. The previously
  2874. saved changes are lost!
  2875. @{b}DFA@{ub} tries to solve this problem in the following way:
  2876. If the network mode is active, all operations that change the address
  2877. database are forbidden, i.e. saving, changing, marking of addresses is
  2878. not possible. It is allowed however, to view the addresses (@{b}Full@{ub}), to
  2879. scroll within the address list, to print the addresses and so on.
  2880. If you want to do some changes on the addresses, you have to obtain
  2881. write access to the address file. This can be done using the AREXX
  2882. command @{b}ATTEMPTLOCK@{ub} or by selecting the menu item @{b}Write Access@{ub} in the
  2883. @{b}DFA-Editor@{ub}.
  2884. If your try to get write access was successful, you may change the
  2885. addresses. If you've completed your changes, you should free the write
  2886. access using either the AREXX command @{b}FREELOCK@{ub} or the menu item @{b}Write
  2887. Access@{ub} in the @{b}DFA-Editor@{ub}. After you have done so, other members of the
  2888. LAN can get write access to this address file.
  2889.    @{b}*@{ub}     @{b}Network mode@{ub}
  2890.      The checkbox gadget @{b}Network mode@{ub} may be used to switch the network
  2891.      mode on and off. Please notice however that using this feature
  2892.      makes only sense, if you really have a network installed and want
  2893.      to access the same address file from several computers.
  2894.    @{b}*@{ub}     @{b}Retries@{ub}
  2895.      Number of retries to get write access to the current address file.
  2896.    @{b}*@{ub}     @{b}Retry delay@{ub}
  2897.      Number of seconds that may pass between two tries to get write
  2898.      access.
  2899. @EndNode
  2900. @Node "PrefsAList" "dfa.guide/PrefsAList"
  2901. @Next "PrefsPList"
  2902. @Prev "PrefsMisc"
  2903. @Toc "DFAPrefs"
  2904. Address Listview
  2905. ================
  2906. This window may be used to configure the main (address) listview of the
  2907. @{b}DFA-Editor@{ub}:
  2908. Each line of the address listview contains one address. Each line may
  2909. have up to eight columns. Each column can display any field of the
  2910. particular address.
  2911.    @{b}*@{ub}     @{b}Column@{ub}
  2912.      This cycle gadget supplies a mean to select the desired column. You
  2913.      may configure up to eight columns, i.e. @{b}Column 1@{ub} through @{b}Column 8@{ub}.
  2914.    @{b}*@{ub}     @{b}Fields@{ub}
  2915.      This listview contains the field name of all address fields that
  2916.      may be used. Please notice that the @{b}Groups@{ub} entry displays all eight
  2917.      group flags of the particular address using the following format:
  2918.           12345678
  2919.      ...if there are @{b}all@{ub} groups flags set. For every group that isn't
  2920.      set, instead of the corresponding group number there will be
  2921.      displayed a minus sign (@{b}-@{ub}).
  2922.      Some examples:
  2923.           123-----          Only the groups 1,2 and 3 are set
  2924.           1-3-5---          Only the groups 1,3 and 5 are set
  2925.           ------78          Only the groups 7 and 8 are set
  2926.           --------          No group flag is set
  2927.    @{b}*@{ub}     @{b}Weight@{ub}
  2928.      The number given here is the percentage of the particular column
  2929.      referring to the complete line. Please notice that it is possible
  2930.      to give up to 100 %, but not more than this! If there is not
  2931.      enough space left for the column you're currently working on, you
  2932.      have to reduce one or more columns accordingly.
  2933.      If you enter a number into the @{b}Weight@{ub} gadget that is too large,
  2934.      the program corrects the value and replaces it with the highest
  2935.      possible number.
  2936.      As the display of the group flags needs a fixed number of eight
  2937.      characters, it is not possible to give a weight for this field.
  2938.    @{b}*@{ub}     @{b}Free and Used@{ub}
  2939.      To give you a general view of the used and free space within the
  2940.      line, there are two gadgets, @{b}Used [%]@{ub} and @{b}Free [%]@{ub}, which display
  2941.      the used and free space respectively.
  2942.    @{b}*@{ub}     @{b}Clear Column@{ub}
  2943.      To clear a column it is @{b}not@{ub} sufficient to set its weight to @{b}0@{ub}! If
  2944.      you want to clear a column, you have to select the desired column
  2945.      (using the @{b}Column@{ub} gadget) and then hit the @{b}Clear column@{ub} gadget.
  2946.      Please notice that "empty" columns are @{b}not@{ub} possible! Only the
  2947.      columns in front of the first cleared column are displayed.
  2948.      Example:
  2949.           You have set the columns 1,2,3 and 4 to the fields @{b}Name@{ub},
  2950.           @{b}FirstName@{ub}, @{b}Phone@{ub} and @{b}Town@{ub}. If you clear column 3 (@{b}Phone@{ub}) and
  2951.           select @{b}Ok@{ub}, only columns 1 and 2 (@{b}Name@{ub} und @{b}FirstName@{ub}) are
  2952.           still visible.
  2953.    @{b}*@{ub}     @{b}Ok und Cancel@{ub}
  2954.      With @{b}Ok@{ub} you accept the changes you've done; if the @{b}DFA-Editor@{ub} is
  2955.      currently running, the changes are applied to it and are visible
  2956.      at once. @{b}Cancel@{ub} discards the changes.
  2957. This all may have sounded a bit complicated, so I'll give you an
  2958. example that shall make clear in a step by step procedure, how to
  2959. configure your "own" format for the address listview:
  2960.      Let's say, you want the following format of the listview's lines:
  2961.           <First Name> <Name> <Phone> <Group Flags>
  2962.           
  2963.               30%        30%    40%        ---
  2964.      ...then you should do like this:
  2965.      Click on the @{b}Columns@{ub} gadget until @{b}Column 1@{ub} is shown.  Now select
  2966.      @{b}First name@{ub} in the @{b}Fields@{ub} listview and enter @{b}30@{ub} into the @{b}Weight@{ub}
  2967.      string gadget. Click once on the @{b}Columns@{ub} gadget -- @{b}Column 2@{ub}
  2968.      appears. Select @{b}Name@{ub} in the @{b}Fields@{ub} listview and enter @{b}30@{ub} into the
  2969.      @{b}Weight@{ub} string gadget. Click on the @{b}Columns@{ub} gadget once again --
  2970.      @{b}Column 3@{ub} appears -- and select @{b}Phone@{ub} from the @{b}Fields@{ub} listview.
  2971.      Please enter @{b}40@{ub} into the @{b}Weight@{ub} string gadget. One more click on
  2972.      the @{b}Columns@{ub} gadget brings @{b}Column 4@{ub} to front. Now select @{b}Group
  2973.      flags@{ub} from the @{b}Fields@{ub} listview. Please notice that the @{b}Weight@{ub}
  2974.      gadget is displayed "ghosted" now and therefore no input into this
  2975.      gadget is possible; this is not needed either as the group flags
  2976.      always need eight characters. Please click on the @{b}Columns@{ub} gadget
  2977.      one more time to make @{b}Column 5@{ub} visible. Select @{b}Clear column@{ub} to make
  2978.      sure that the 5th column is "clear". Hit @{b}Ok@{ub} to make the changes
  2979.      active -- if the @{b}DFA-Editor@{ub} program is currently running, all
  2980.      changes will be visible at once.
  2981. @EndNode
  2982. @Node "PrefsPList" "dfa.guide/PrefsPList"
  2983. @Next "PrefsGroups"
  2984. @Prev "PrefsAList"
  2985. @Toc "DFAPrefs"
  2986. Panel Listview
  2987. ==============
  2988. Below the address listview of the @{b}DFA-Editor@{ub} main window there is
  2989. another listview, called "Panel listview". This is used to make further
  2990. information about the current address visible. It is possible to
  2991. display up to 16 lines. Every line can display any field of the
  2992. address; the line title may be changed as well.
  2993. Furthermore it is possible to adjust the number of lines that are
  2994. visible at a time.
  2995.    @{b}*@{ub}     @{b}Lines@{ub}
  2996.      Every click on the @{b}Lines@{ub} cycle gadget makes the next line number
  2997.      visible (@{b}Line 1@{ub} through @{b}Line 16@{ub}). After the last line number (16)
  2998.      @{b}Line 1@{ub} is displayed again.
  2999.    @{b}*@{ub}     @{b}Fields@{ub}
  3000.      This listview corresponds to the one, you already got to know in
  3001.      @{"Address Listview" Link "PrefsAList"}. Using this listview, you may select, which field
  3002.      of the particular address you want to get displayed in the
  3003.      currently selected line (cf. @{b}Lines@{ub}).
  3004.    @{b}*@{ub}     @{b}Title@{ub}
  3005.      It is possible to give any line title you like; for example @{b}Phone
  3006.      #:@{ub} for the @{b}Phone@{ub} field or @{b}Groups:@{ub} for the @{b}group selection@{ub}.
  3007.      If you want e.g. that all three email address are displayed among
  3008.      one another (i.e. Line 1 through line 3), it could be a good idea,
  3009.      to give the first line (@{b}EMail 1@{ub}) the title @{b}EMail:@{ub} and leave line 2
  3010.      and line 3 without a line title.
  3011.    @{b}*@{ub}     @{b}Clear line@{ub}
  3012.      Similarly to @{"Address Listview" Link "PrefsAList"} (see @{b}Clear Column@{ub}) is is needed here
  3013.      as well to explicitly delete lines you don't want to use any
  3014.      longer. Please notice that only lines infront of the first
  3015.      "cleared" line are displayed, even if there are lines with
  3016.      contents behind the first cleared line. This means that empty lines
  3017.      are not possible.
  3018.    @{b}*@{ub}     @{b}Visible lines@{ub}
  3019.      It is possible (within certain values) to change the size of the
  3020.      panel listview using this slider gadget. You may have up to 12
  3021.      lines visible at a time! Please notice that the @{b}DFA-Editor@{ub} reduces
  3022.      the number of visible lines automatically, if there is not enough
  3023.      space for the desired listview lines in the window.
  3024.    @{b}*@{ub}     @{b}Ok and Cancel@{ub}
  3025.      Using @{b}Ok@{ub} you accept the changes and a currently running @{b}DFA-Editor@{ub}
  3026.      program is updated at once. @{b}Cancel@{ub} discards the changes.
  3027. The following example may help you to understand the @{b}Panel@{ub} listview
  3028. configuration more easily:
  3029.      Let's say you would like to get the following format in your @{b}Panel@{ub}
  3030.      listview
  3031.                    <Title>    <Contents>
  3032.           <Line 1> EMail:     [EMail 1]
  3033.           <Line 2>            [EMail 2]
  3034.           <Line 3> Comment:   [Comment]
  3035.      Terms in @{b}[@{ub} and @{b}]@{ub} describe field names, terms in @{b}<@{ub} and @{b}>@{ub} serve as
  3036.      description.
  3037.      First click as long on the @{b}Lines@{ub} cycle gadget, until @{b}Line 1@{ub}
  3038.      appears (after the window has opened @{b}Line 1@{ub} is usually visible
  3039.      already). Now select @{b}EMail 1@{ub} from the @{b}Fields@{ub} listview and enter
  3040.      @{b}EMail:@{ub} into the @{b}Title@{ub} string gadget.  Now click on the @{b}Lines@{ub}
  3041.      gadget once -- @{b}Line 2@{ub} should become visible. Select @{b}EMail 2@{ub} from
  3042.      the @{b}Fields@{ub} listview and delete the contents of the @{b}Title@{ub} string
  3043.      gadget, if it isn't empty already. One more click on the @{b}Lines@{ub}
  3044.      gadget brings @{b}Line 3@{ub} to front. Select @{b}Comment@{ub} from the @{b}Lines@{ub}
  3045.      listview and enter @{b}Comment@{ub} into the @{b}Title@{ub} string gadget.  After
  3046.      one more click on the @{b}Lines@{ub} gadget please click on the @{b}Clear line@{ub}
  3047.      gadget, to delete line four if it isn't empty. Hit @{b}Ok@{ub} to accept
  3048.      the changes. If the @{b}DFA-Editor@{ub} is currently running, the changes
  3049.      will be made visible at once.
  3050. @EndNode
  3051. @Node "PrefsGroups" "dfa.guide/PrefsGroups"
  3052. @Next "PrefsFonts"
  3053. @Prev "PrefsPList"
  3054. @Toc "DFAPrefs"
  3055. Groups
  3056. ======
  3057. First of all a few words about the group flags and their purpose and
  3058. meaning:
  3059.      It is possible to separate your addresses into groups and set the
  3060.      different group flags for every address item. Let's say you're
  3061.      using the first three (out of a maximum of eight) group flags and
  3062.      you've named them @{b}Private@{ub}, @{b}Business@{ub} and @{b}Other@{ub} (see @{"Groups" Link "PrefsGroups"}, for
  3063.      more information).
  3064.      Now you can set the @{b}Private@{ub} flag to all private addresses, the
  3065.      @{b}Business@{ub} flag to all business related addresses and the @{b}Other@{ub} flag
  3066.      to all address that don't belong to any of these groups. Of
  3067.      course, you may set more than one flag at a time, if an address is
  3068.      a private one and business related as well, for example.
  3069.      In the main window of the @{b}DFA-Editor@{ub} you can select the groups you
  3070.      would like to see within the address listview (or use the AREXX
  3071.      command @{b}CHANGEGROUPS@{ub} accordingly). If you want to see the private
  3072.      and the business addresses, please activate both checkbox gadgets.
  3073.      Please notice that all actions, as for instance printing and
  3074.      searching is performed to the active (i.e. displayed) addresses
  3075.      only!
  3076.      In the @{b}Groups@{ub} window of the @{b}DFA-Preferences@{ub} (cf.  @{"Groups" Link "PrefsGroups"}) you may
  3077.      set which kind of relation between the groups you like. If you
  3078.      have activated more than one group at the same time (in the
  3079.      example above @{b}Private@{ub} and @{b}Other@{ub}), you may select either the
  3080.      relation @{b}via 'OR'@{ub} or the relation @{b}via 'AND'@{ub}:
  3081.         @{b}*@{ub}     @{b}via 'OR'@{ub}
  3082.           Every address that has at least one of the wanted flags set,
  3083.           is displayed. If you activate @{b}Private@{ub} and @{b}Other@{ub}, all
  3084.           addresses will be displayed that have either set the @{b}Private@{ub}
  3085.           @{b}or@{ub} the @{b}Other@{ub} flag @{b}or@{ub} both flags.
  3086.         @{b}*@{ub}     @{b}via 'AND'@{ub}
  3087.           Only those addresses are shown that have set at least the
  3088.           groups you selected in the @{b}DFA-Editor@{ub} main window. If the
  3089.           @{b}Private@{ub} and the @{b}Other@{ub} flags are both set, only addresses will
  3090.           be shown that have at least the @{b}Private@{ub} @{b}and@{ub} the @{b}Other@{ub} flag
  3091.           set; addresses that have set only one of these flags are @{b}not@{ub}
  3092.           shown.
  3093.      Groups that don't have any group flags set, can be made visible by
  3094.      deselecting all the group flags in the @{b}DFA-Editor@{ub} main window
  3095.      (i.e. all check boxes are "empty").
  3096. Lets shift to the settings that are possible here:
  3097.    @{b}*@{ub}     @{b}Groups@{ub}
  3098.      This cycle gadget allows you to set the group (@{b}Group 1@{ub} through
  3099.      @{b}Group 8@{ub}) you want to modify.
  3100.    @{b}*@{ub}     @{b}Title@{ub}
  3101.      The name of the group can be entered into this string gadget. The
  3102.      desired keyboard shortcut has to be marked with a leading
  3103.      underscore (@{b}_@{ub}), for example:
  3104.           Group _1        The group's name is @{b}Group 1@{ub}, its
  3105.                           shortcut is the digit @{b}1@{ub}
  3106.           
  3107.           Pri_vate        @{b}Private@{ub} is used for the group name, the
  3108.                           keyboard shortcut is the @{b}v@{ub}
  3109.           
  3110.           Other (_3)      @{b}Other (3)@{ub} is the group's name, the digit @{b}3@{ub}
  3111.                           its keyboard shortcut
  3112.           @{b}Please notice:@{ub}
  3113.           Even if it @{b}is@{ub} possible to use any keyboard shortcut you like,
  3114.           as long as it is an "usual" letter, you should remember that
  3115.           @{b}DFA@{ub} does not check if the keyboard shortcut you enter is
  3116.           unique within the @{b}DFA@{ub} application. Therefore you have to make
  3117.           sure by yourself that the keyboard shortcuts, you want to
  3118.           use, are not already be used by other gadgets.
  3119.           Please notice as well that the shortcut for the different
  3120.           groups are not only used within the @{b}DFA-Editor@{ub} main window,
  3121.           but have to be unique in e.g. the @{b}DFA-Editor@{ub} @{b}Edit@{ub} window as
  3122.           well.
  3123.           The shortcuts, which are guarantied to be unique within the
  3124.           complete @{b}DFA@{ub} application are the digits @{b}1@{ub} through @{b}8@{ub}, which is
  3125.           the default as well.
  3126.      The length of the group titles is limited to 15 digits, to make
  3127.      sure that no title overwrites the window contents and/or border.
  3128.    @{b}*@{ub}     @{b}Group handling@{ub}
  3129.      This cycle gadget allows you to select the kind of relation of
  3130.      several group flags (see above for details).
  3131.    @{b}*@{ub}     @{b}Ok und Cancel@{ub}
  3132.      After you've hit @{b}Ok@{ub}, the changes become active, if you hit @{b}Cancel@{ub}
  3133.      instead, all changes are lost.
  3134. @EndNode
  3135. @Node "PrefsFonts" "dfa.guide/PrefsFonts"
  3136. @Next "PrefsModem"
  3137. @Prev "PrefsGroups"
  3138. @Toc "DFAPrefs"
  3139. Fonts
  3140. =====
  3141. The fonts that shall be used by the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub}
  3142. program can be set in this window. If you don't change the default
  3143. setting (@{b}Use System Font@{ub} for every font),  all program parts use the
  3144. fonts you set in the Font Preferences program of the Workbench.
  3145. Alternatively you may set any font you like for each of the four fonts
  3146. used.
  3147.    @{b}*@{ub}     @{b}@{b}DFA-Editor@{ub}: Gadget font@{ub}
  3148.      Here you may enter the font, which is used for the gadget texts of
  3149.      the @{b}DFA-Editor@{ub}.
  3150.    @{b}*@{ub}     @{b}@{b}DFA-Editor@{ub}: List font@{ub}
  3151.      For the different listviews of the @{b}DFA-Editor@{ub} a seperate font may
  3152.      be chosen. Please notice that only non-proportional fonts are
  3153.      allowed here.
  3154.    @{b}*@{ub}     @{b}@{b}DFA-Preferences@{ub}: Gadget font@{ub}
  3155.      see above, @{b}DFA-Editor@{ub}: Gadget font.
  3156.    @{b}*@{ub}     @{b}@{b}DFA-Preferences@{ub}: List font@{ub}
  3157.      see above, @{b}DFA-Editor@{ub}: List font. Please notice, however that even
  3158.      proportional fonts are allowed here!
  3159. @EndNode
  3160. @Node "PrefsModem" "dfa.guide/PrefsModem"
  3161. @Next "PrefsPaths"
  3162. @Prev "PrefsFonts"
  3163. @Toc "DFAPrefs"
  3164. Modem
  3165. =====
  3166. The settings that can be done here, have only a meaning for you, if you
  3167. have a modem connected to your computer and plan to use @{b}DFA@{ub} to dial the
  3168. stored phone numbers.
  3169. Furthermore you should have a phone connected to your modem!
  3170. The following settings may be changed:
  3171.    @{b}*@{ub}     @{b}Baud@{ub}
  3172.      This cycle gadget may be used to set the baud rate of the serial
  3173.      port.  As the serial port is only used to send command sequences
  3174.      and not to transfer real data, the baud rate doesn't really
  3175.      matter; however, it should not be higher than the baud rate, your
  3176.      modem supports (default: @{b}1200@{ub}).
  3177.    @{b}*@{ub}     @{b}Init String@{ub}
  3178.      The string that you enter into this string gadget, is used to init
  3179.      the modem. If you have a modem that supports the "Hayes" command
  3180.      sequences, the init command is usually @{b}ATZ@{ub} (default: @{b}ATZ~~~@{ub}).
  3181.    @{b}*@{ub}     @{b}Hangup String@{ub}
  3182.      The string that is to be used to hang up the line, i.e. to
  3183.      terminate the connection, may be entered here (default:
  3184.      @{b}+++\rTH0\r@{ub})
  3185.    @{b}*@{ub}     @{b}Predial String@{ub}
  3186.      This string is sent to the modem just before the phone number
  3187.      itself.  Some examples for "Hayes" compatible modems:
  3188.              ATDP            Pulse dial (default)
  3189.              ATDT            Tone dial
  3190.              ATDP#W          Makes the modem wait for a dialtone after
  3191.                              sending a number (@{b}#@{ub}). So it is possible
  3192.                              to call from a extension line.
  3193.                              Just substitute @{b}#@{ub} by the number you would
  3194.                              usually enter to get a dialtone.
  3195.    @{b}*@{ub}     @{b}Suff. Dial String@{ub}
  3196.      The string that has to be sent just after the phone number may be
  3197.      entered here. Please notice that this string has to be @{b}at least@{ub} a
  3198.      @{b}\r@{ub}, as the dialing does not work otherwise (default: @{b}\r@{ub}).
  3199.    @{b}*@{ub}     @{b}Serial device@{ub}
  3200.      Here you may enter the name of a serial device that shall be used
  3201.      for dialing.  Usually this is the Commodore @{b}serial.device@{ub}, which
  3202.      is the default.  If you have an interface card with (an)
  3203.      additional serial interface(s), you can insert the new serial
  3204.      device here.
  3205.    @{b}*@{ub}     @{b}Select device@{ub}
  3206.      Instead of typing the name of the serial device you can comfortably
  3207.      select it from a file requester. The selected device is inserted
  3208.      into the @{b}Serial device@{ub} field.
  3209.    @{b}*@{ub}     @{b}Device unit@{ub}
  3210.      You may enter the number of the serial device here. Usually this is
  3211.      @{b}0@{ub}. However, if you have an interface card with more than one
  3212.      serial port, they are distinguishable by their numbers (@{b}0@{ub} and @{b}1@{ub}
  3213.      for example).
  3214.    @{b}*@{ub}     @{b}Retries@{ub}
  3215.      If a line is busy, it is possible to tell @{b}DFA@{ub} to retry; the number
  3216.      of retries may be entered here.
  3217.    @{b}*@{ub}     @{b}Redial delay@{ub}
  3218.      The time delay between two dial events.
  3219.    @{b}*@{ub}     @{b}Use OwnDevUnit@{ub}
  3220.      The @{b}OwnDevUnit.library@{ub} gives you the chance to use @{b}DFA@{ub} for
  3221.      dialing, even if the serial port is permanently occupied by a
  3222.      program as the @{b}getty@{ub} for example. The requirement for this to work
  3223.      is that this program supports the @{b}OwnDevUnit.library@{ub} as well of
  3224.      course. If you don't use such a program, you may deactivate the
  3225.      @{b}Use OwnDevUnit@{ub} checkbox. If there is no @{b}OwnDevUnit.library@{ub}
  3226.      installed on your computer, it can't be used of course.
  3227. The input you can do into @{b}Init String@{ub}, @{b}Hangup String@{ub}, @{b}PredialString@{ub} and
  3228. @{b}Suff. Dial String@{ub}, can be found in the manual of your modem. In
  3229. addition to the strings listed there, @{b}DFA@{ub} supports the following
  3230. command sequences:
  3231.    @{b}*@{ub}     @{b}@{b}~@{ub} (Tilde)@{ub}
  3232.      Causes a delay of about one second.
  3233.    @{b}*@{ub}     @{b}@{b}\b@{ub} (Backspace)@{ub}
  3234.      Deletes the character to its left.
  3235.    @{b}*@{ub}     @{b}@{b}\f@{ub} (Formfeed)@{ub}
  3236.      Performs a form feed.
  3237.    @{b}*@{ub}     @{b}@{b}\n@{ub} (Linefeed)@{ub}
  3238.      Produces a line feed.
  3239.    @{b}*@{ub}     @{b}@{b}\r@{ub} (Carriage return)@{ub}
  3240.      Performs a carriage return.
  3241.    @{b}*@{ub}     @{b}@{b}\t@{ub} (Tab)@{ub}
  3242.      Inserts a @{b}Tab@{ub} character.
  3243.    @{b}*@{ub}     @{b}@{b}\e@{ub} (ESC)@{ub}
  3244.      Inserts an @{b}Escape@{ub} character.
  3245. @EndNode
  3246. @Node "PrefsPaths" "dfa.guide/PrefsPaths"
  3247. @Next "PrefsArexxCmds"
  3248. @Prev "PrefsModem"
  3249. @Toc "DFAPrefs"
  3250. Paths and Filenames
  3251. ===================
  3252. The file and pathnames used by @{b}DFA@{ub} may be set here.
  3253. More comfortable than to enter the pathname into the string gadgets
  3254. manually is to hit the button just behind the corresponding string
  3255. gadget. If you do so, a file requester pops up and you may select the
  3256. desired file or pathname.
  3257.    @{b}*@{ub}     @{b}Address file@{ub}
  3258.      This is the address file that is loaded automatically during the
  3259.      startup of @{b}DFA@{ub} (default: @{b}s:adr.file@{ub}). This filename will be used
  3260.      as well, if you select @{b}Save as default@{ub}.
  3261.    @{b}*@{ub}     @{b}External files@{ub}
  3262.      The external files are saved in a directory of their own (default:
  3263.      @{b}s:DFAExternals@{ub}).
  3264.    @{b}*@{ub}     @{b}File editor@{ub}
  3265.      To modify the external files, you need an ASCII editor. The @{b}ed@{ub},
  3266.      which can usually be found in the @{b}C:@{ub} drawer of your workbench, is
  3267.      an appropriate tool for example (default: @{b}ed@{ub}).
  3268.    @{b}*@{ub}     @{b}File viewer@{ub}
  3269.      To view the external files, you need a text viewer, as for example
  3270.      the @{b}more@{ub} program that comes along with your Workbench programs
  3271.      (default: @{b}more@{ub}).
  3272. @EndNode
  3273. @Node "PrefsArexxCmds" "dfa.guide/PrefsArexxCmds"
  3274. @Next "PrefsSort"
  3275. @Prev "PrefsPaths"
  3276. @Toc "DFAPrefs"
  3277. Arexx Scripts
  3278. =============
  3279. It is possible to bind one AREXX script to every function key (@{b}F1@{ub}
  3280. through @{b}F10@{ub}). If you don't like to enter the name of the AREXX script
  3281. (including its path) by hand, you may alternatively hit the button
  3282. gadget just behind the corresponding string gadget (keyboard shortcut:
  3283. @{b}SHIFT@{ub} @{b}<digit>@{ub}). If you do so, a file requester will pop up and the
  3284. desired AREXX script can be selected.
  3285. The AREXX scripts you enter here can only be reached via the function
  3286. keys from the main window of the @{b}DFA-Editor@{ub}. In the @{b}rexx@{ub} drawer of the
  3287. @{b}DFA@{ub} distribution some example scripts can be found; all files suited
  3288. for this purpose have the extension @{b}.dfa@{ub}.
  3289. Hit @{b}Ok@{ub} to accept the changes or @{b}Cancel@{ub} to quit the window and discard
  3290. the changes.
  3291. @EndNode
  3292. @Node "PrefsSort" "dfa.guide/PrefsSort"
  3293. @Prev "PrefsArexxCmds"
  3294. @Toc "DFAPrefs"
  3295. Sorting
  3296. =======
  3297. The addresses can be sorted by (nearly) every field of an address.  To
  3298. manage this, you may enter up to four sort criteria here. The most
  3299. important one is @{b}Sort criteria 1@{ub}. If two addresses can't be
  3300. distinguished by this criteria alone (e.g. if there are identical
  3301. names), the second sort criteria (@{b}Sort criteria 2@{ub}) is used. If a
  3302. distinction is still impossible, the third sort criteria is used and so
  3303.    @{b}*@{ub}     @{b}Sort@{ub}
  3304.      Here you may choose which sort criteria you would like to change.
  3305.    @{b}*@{ub}     @{b}Fields@{ub}
  3306.      You may select one address field from this listview for every sort
  3307.      criteria (@{b}Sort criteria 1@{ub} through @{b}Sort criteria 4@{ub}).
  3308.    @{b}*@{ub}     @{b}Clear sort criteria@{ub}
  3309.      If you want to delete a sort criteria, please hit this button.
  3310.    @{b}*@{ub}     @{b}Ok and Cancel@{ub}
  3311.      @{b}Ok@{ub} accepts the changes. Please notice that the addresses are @{b}not@{ub}
  3312.      resorted automatically. To sort your addresses using the modified
  3313.      sort criteria, you have to explicetly select @{b}Sort@{ub} in the
  3314.      @{b}DFA-Editor@{ub} (or use the corresponding AREXX command).  @{b}Cancel@{ub}
  3315.      ignores the changes.
  3316. @EndNode
  3317. @Node "Legal" "dfa.guide/Legal"
  3318. @Toc "Main"
  3319. Legal stuff
  3320. ***********
  3321.  @{"   Licence   " Link "Licence"}         
  3322.  @{"  Warranty   " Link "Warranty"}          
  3323.  @{"  Copyright  " Link "Copyright"} 
  3324. @EndNode
  3325. @Node "Licence" "dfa.guide/Licence"
  3326. @Next "Warranty"
  3327. @Toc "Legal"
  3328. Licence
  3329. =======
  3330.   1. This licence applies to the product called @{b}DFA@{ub}, a package for the
  3331.      @{b}AMIGA@{ub} computer, published by Dirk Federlein under the concepts of
  3332.      @{b}Shareware@{ub}. The terms "Package", "@{b}DFA@{ub}" and "Archive" refer to this
  3333.      product. The licensee is addressed as "you".  This license does
  3334.      not apply to third party supplied programs, found e.g. in the @{b}c@{ub} or
  3335.      @{b}libs@{ub} drawer of the original distribution archive.
  3336.   2. You may use @{b}DFA@{ub} for a period of up to 21 days for evaluation.
  3337.      After that, you have to register.
  3338.   3. This archive may be freely redistributed only @{b}without the keyfile@{ub},
  3339.      which you got from me when you have registered. Please remember
  3340.      that the keyfile contains your name to prevent you from giving it
  3341.      away to others.
  3342.   4. You are @{b}not allowed@{ub} to draw commercial profit out of distributing
  3343.      this package. You may charge a fee to recover distribution and
  3344.      copy costs. The fee for diskette distribution may @{b}not be more@{ub} than
  3345.      the cost to obtain a public domain diskette from Fred Fish.
  3346.   5. You are @{b}not@{ub} allowed to manipulate any file of @{b}DFA@{ub} and distribute
  3347.      it under any or no name. Compression with common archivers like
  3348.      @{b}zoo@{ub} or @{b}lharc@{ub} is allowed. You are only allowed to redistribute
  3349.      the @{b}whole@{ub} original archive (@{b}without@{ub} the keyfile however).
  3350.      Some files @{b}may be@{ub} modified for your personal use:
  3351.         @{b}*@{ub} The AREXX scripts
  3352.           The example AREXX scripts which can be found in the @{b}Rexx@{ub}
  3353.           drawer of the original distribution may be modified and/or
  3354.           enhanced.
  3355.         @{b}*@{ub} The LOCALE files
  3356.           If you adopt the catalog translation files (extension @{b}.ct@{ub}),
  3357.           you will be able to translate all program texts of @{b}DFA@{ub} into
  3358.           your native language.
  3359.      If you do such changes, you may do so for your personal use;
  3360.      redistribution of modified files is not allowed.  (Nevertheless
  3361.      the author would be happy, if you'd sent him your modified files,
  3362.      so that they may serve as a basis for an inclusion into future
  3363.      versions of @{b}DFA@{ub})
  3364.   6. If developers of commercial software would like to include certain
  3365.      parts of @{b}DFA@{ub} in their commercial products, they will have to
  3366.      contact the author of @{b}DFA@{ub} first, to ask for permission.
  3367.   7. You agree to cease distributing @{b}DFA@{ub} if requested to do so by the
  3368.      author.
  3369.   8. By copying, distributing and/or using @{b}DFA@{ub} you indicate your
  3370.      acceptance of this license to do so, and all its terms and
  3371.      conditions.
  3372.   9. Each time you redistribute this package, the recipient
  3373.      automatically receives a license from the original licensor to
  3374.      copy, distribute and/or use this package subject to these terms
  3375.      and conditions.  @{b}You may not impose any further restrictions on
  3376.      the recipients' exercise of the rights granted herin@{ub}.
  3377.  10. As always, Fred Fish has got explicit permission to include this
  3378.      package into his wonderful "Fish Disk" collection, no matter if it
  3379.      is on floppy or compact disk.
  3380. @EndNode
  3381. @Node "Warranty" "dfa.guide/Warranty"
  3382. @Next "Copyright"
  3383. @Prev "Licence"
  3384. @Toc "Legal"
  3385. Warranty
  3386. ========
  3387. This software is provided @{b}as is@{ub} without warranty of any kind, either
  3388. expressed or implied. By using @{b}DFA@{ub}, you agree to accept the entire risk
  3389. as to the quality and performance of this package.
  3390. In no event (unless required by applicable law or agreed to in writing)
  3391. will any copyright holder, or any other party who may redistribute this
  3392. package as permitted above, be liable to you for damages, including any
  3393. general, special, incidental or consequential damages arising out of the
  3394. use or inability to use this package (including but not limited to loss
  3395. of data or data being rendered inaccurate or losses sustained by you or
  3396. third parties), even if such holder or other party has been advised of
  3397. the possibility of such damages.
  3398. Of course, @{b}DFA@{ub} has been tested rather extensively before it was
  3399. released. In case you find any bugs in @{b}DFA@{ub} I please you to send me a
  3400. bug report. See @{"Bugreports" Link "Bugreports"}.
  3401. @EndNode
  3402. @Node "Copyright" "dfa.guide/Copyright"
  3403. @Prev "Warranty"
  3404. @Toc "Legal"
  3405. Copyright
  3406. =========
  3407. GUI created using Gadtoolsbox (37.300) (C) 1991-93 Jan van den Baard.
  3408. AREXX interface created using Arexxbox (V1.12) (C) 1992-93 Michael
  3409. Balzer.
  3410. The MagicWB icons are (C) Copyright 1993-94 Martin Huttenloher
  3411. Installer and Installer project icon (C) Copyright 1991-93
  3412. Commodore-Amiga, Inc.  All Rights Reserved.  Reproduced and distributed
  3413. under license from Commodore.
  3414. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO
  3415. WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY OR
  3416. RESPONSIBILITY IS ASSUMED.
  3417. Registered trademarks are @{b}not@{ub} marked separately.  Therefore absence of
  3418. a trademark does not imply they are free.
  3419. @EndNode
  3420. @Node "Registration" "dfa.guide/Registration"
  3421. @Toc "Main"
  3422. Registration
  3423. ************
  3424. Since Version 2.1 of @{b}DFA@{ub} has been finished, it is an product with the
  3425. @{b}SASG@{ub} quality brand.
  3426. The advantages, which grow out of this can be looked up within the @{"
  3427. Registration/Information " system DFA:C/Registration} program.
  3428. Information about registration sites, the @{b}SASG@{ub}, the shareware fee,
  3429. payment methods etc. can be found there as well.
  3430. The registration program can be started either seperately or directly
  3431. out of the about requester of @{b}DFA@{ub}.
  3432. Before you register, you have the opportunity to test @{b}DFA@{ub} in great
  3433. detail.  However, when using the unregistered version you can't save
  3434. the preferences (this feature is disabled); all changes you perform
  3435. using the @{b}DFA-Preferences@{ub} program stay active only until you reboot
  3436. your computer. The window positions are therefore @{b}not@{ub} saved as well.
  3437. In spite of all this restrictions it should be possible to see if @{b}DFA@{ub}
  3438. is what you expect. As soon as you use @{b}DFA@{ub} regularly, however not later
  3439. than after 21 days, you have to register!
  3440. You'll get your personal keyfile, a TeX manual (in German @{b}and@{ub} English)
  3441. and an AMIGAGUIDE manual (German @{b}and@{ub} English). All manual files are on
  3442. the disk only and @{b}not@{ub} printed!
  3443. You'll find my address below, see @{"Important Addresses" Link "Addresses"}.
  3444. @EndNode
  3445. @Node "Updates" "dfa.guide/Updates"
  3446. @Toc "Main"
  3447. Updates
  3448. *******
  3449. I'm continuously working on @{b}DFA@{ub} and I'll publish small updates from
  3450. time to time. These updates will be fed into the following electronic
  3451. nets:
  3452.    @{b}*@{ub} ADS Filenet
  3453.    @{b}*@{ub} AmiNet FTP Server
  3454. If you have access to such a electronic net, you can get the latest
  3455. version of @{b}DFA@{ub} quickly and cheaply. Many electronic mailboxes supply
  3456. the latest version of @{b}DFA@{ub} as well, e.g.
  3457.      @{b}Publisher's Treff@{ub}
  3458.      63739 Aschaffenburg
  3459.      Tel.: Germany-(0)6021-93435
  3460.     @{b}Publisher's Treff@{ub}
  3461.           SASG Support BBS - All SASG products available
  3462.           63739 Aschaffenburg
  3463.           Tel.: Germany-(0)6021-93435
  3464.           Fido: 2:244/6302.0
  3465.      You may get the latest version of @{b}DFA@{ub} off from that @{b}BBS@{ub} via
  3466.      FileRequest. The magic for the FileRequest is @{b}DFA@{ub}. Any other @{b}SASG@{ub}
  3467.      product may be requested as well.
  3468.      @{b}Incubus@{ub}
  3469.      97074 W
  3470. rzburg
  3471.      Tel.: Germany-(0)931-781464, -781465, -781467, -781468, -72695,
  3472.      -884703, -884726
  3473. Alternatively you may order your update directly from me. Please use
  3474. the registration program for this purpose -- as you've already done
  3475. when you've registered.
  3476. Fred Fish will get @{b}DFA@{ub} to include it in his library. However, it will
  3477. last a few weeks until @{b}DFA@{ub} finds its was on these floppy or compact
  3478. disks respectively.
  3479. @EndNode
  3480. @Node "Bugreports" "dfa.guide/Bugreports"
  3481. @Toc "Main"
  3482. Bug Reports
  3483. ***********
  3484. Coming with version  2.0 I did many significant changes to @{b}DFA@{ub}. Usually
  3485. this means that compared to @{b}DFA@{ub} V1.2x there will be some new bugs in it
  3486. -- in spite of a long beta testing phase! This fact can be understood
  3487. more easily, if you know that the source code of @{b}DFA@{ub} takes up about 1.2
  3488. MB up to now!
  3489. So I ask you to report any bugs you discover.  If you have any ideas
  3490. what should be improved in future versions of @{b}DFA@{ub}, please feel free to
  3491. write, (mail or email, doesn't matter) giving me any suggestions.
  3492. Bug reports can be sent by ordinary or elecronic mail. The address can
  3493. be found in @{"Important Addresses" Link "Addresses"}.
  3494. @EndNode
  3495. @Node "Addresses" "dfa.guide/Addresses"
  3496. @Toc "Main"
  3497. Important Addresses
  3498. *******************
  3499.  @{"   The author's address     " Link "MyAddress"}           
  3500.  @{" Registration in Australia  " Link "AustraliaRegSite"}                  
  3501.  @{"  Registration in England   " Link "EnglishRegSite"}                
  3502.  @{"  Registration in France    " Link "FrenchRegSite"}               
  3503.  @{"  Registration in Germany   " Link "GermanRegSite"}               
  3504.  @{"  Registration in the USA   " Link "USARegSite"} 
  3505. @EndNode
  3506. @Node "MyAddress" "dfa.guide/MyAddress"
  3507. @Next "AustraliaRegSite"
  3508. @Toc "Addresses"
  3509. The author's address
  3510. ====================
  3511. @{b}Home address:@{ub}
  3512.      Dirk Federlein
  3513.      Brunnengasse 11a
  3514.      63741 Aschaffenburg
  3515.      Germany
  3516. @{b}Study address:@{ub}
  3517.      Dirk Federlein
  3518.      Am Sonnenberg 34
  3519.      97078 W
  3520. rzburg
  3521.      Germany
  3522. @{b}E-Mail:@{ub}
  3523.      UUCP: @{b}dirkf@alcmy.franken.de@{ub} @{b}or@{ub} @{b}dirk@alcmy.adsp.sub.org@{ub}
  3524.      FIDO: @{b}2:244/6302.12@{ub}
  3525. E-mail reaches me always, no matter to which of the above addresses you
  3526. write. If you prefer to send "normal" mail, you should send it to
  3527. Aschaffenburg.
  3528. @{b}Bank address:@{ub}
  3529.      Bayerische Vereinsbank Aschaffenburg
  3530.      Sort code: 795 200 70
  3531.      Accont: 160 6 140
  3532.      Germany
  3533. @EndNode
  3534. @Node "AustraliaRegSite" "dfa.guide/AustraliaRegSite"
  3535. @Next "EnglishRegSite"
  3536. @Prev "MyAddress"
  3537. @Toc "Addresses"
  3538. Registration in Australia
  3539. =========================
  3540. @{b}Andre Lackmann@{ub}
  3541.      PO Box 259
  3542.      Newport NSW 2106
  3543.      Australia
  3544. @{b}E-Mail:@{ub}
  3545.      UUCP: @{b}76711.710@compuserve.com@{ub}
  3546. @EndNode
  3547. @Node "EnglishRegSite" "dfa.guide/EnglishRegSite"
  3548. @Next "FrenchRegSite"
  3549. @Prev "AustraliaRegSite"
  3550. @Toc "Addresses"
  3551. Registration in England
  3552. =======================
  3553. @{b}Paul Jewell@{ub}
  3554.      7 Fairfield Avenue
  3555.      Victoria Park
  3556.      Cardiff
  3557.      Great Britain (Wales)
  3558. @{b}E-Mail:@{ub}
  3559.      UUCP: @{b}Paul_Jewell@savanna.exnet.com@{ub}
  3560. @{b}Bankverbindung:@{ub}
  3561.      Lloyds Bank
  3562.      Sort code: 30-98-94
  3563.      Account: 7574426
  3564. @EndNode
  3565. @Node "FrenchRegSite" "dfa.guide/FrenchRegSite"
  3566. @Next "GermanRegSite"
  3567. @Prev "EnglishRegSite"
  3568. @Toc "Addresses"
  3569. Registration in France
  3570. ======================
  3571. @{b}Etienne Schneider@{ub}
  3572.      1 impasse des Sans Boutons
  3573.      F-80000 Amiens
  3574.      France
  3575. @{b}E-Mail:@{ub}
  3576.      UUCP: @{b}etienne.schneider@ramses.fdn.org@{ub}
  3577. @EndNode
  3578. @Node "GermanRegSite" "dfa.guide/GermanRegSite"
  3579. @Next "USARegSite"
  3580. @Prev "FrenchRegSite"
  3581. @Toc "Addresses"
  3582. Registration in Germany
  3583. =======================
  3584. @{b}Christoph Reichert@{ub}
  3585.      Am Hasenkopf 4
  3586.      63739 Aschaffenburg
  3587.      Deutschland
  3588. @{b}E-Mail:@{ub}
  3589.      UUCP: @{b}chris@ptreff.ab.mayn.sub.de@{ub}
  3590. @{b}Bank address:@{ub}
  3591.      Sparkasse Aschaffenburg - Alzenau
  3592.      Sort code: 795 500 00
  3593.      Account: 528 01 77
  3594.      Germany
  3595. @EndNode
  3596. @Node "USARegSite" "dfa.guide/USARegSite"
  3597. @Prev "GermanRegSite"
  3598. @Toc "Addresses"
  3599. Registration in the USA
  3600. =======================
  3601. @{b}Robert Blayzor@{ub}
  3602.      PO Box 807
  3603.      Johnstown, NY 12095-0807
  3604.      U.S.A.
  3605. @{b}E-Mail:@{ub}
  3606.      UUCP: @{b}die@lsd.org@{ub}
  3607. @EndNode
  3608. @Node "Internal" "dfa.guide/Internal"
  3609. @Toc "Main"
  3610. Internal
  3611. ********
  3612.  @{"       Locale Support       " Link "IntLocaleSupport"}                    Native language support
  3613.  @{" The CheckBirthday Program  " Link "CheckBirthday"}                    Never ever forget a birthday!
  3614. @EndNode
  3615. @Node "IntLocaleSupport" "dfa.guide/IntLocaleSupport"
  3616. @Next "CheckBirthday"
  3617. @Toc "Internal"
  3618. Locale Support
  3619. ==============
  3620. While @{b}DFA@{ub} V1.2x supported seven different languages, version 2.0 of @{b}DFA@{ub}
  3621. comes along only with english and german language support. This
  3622. restriction has several reasons:
  3623.   1. The english and german version of the catalog files can be done by
  3624.      myself. Therefore I am no longer -- especially when creating updates --
  3625.      forced to get updated locale files from many different parts of
  3626.      this world @{b}in time@{ub}.
  3627.   2. For version 2.0 of @{b}DFA@{ub} I enlarged the locale files by a big
  3628.      amount. To translate these files is a lot of work that I don't
  3629.      want to be done by other people than by myself.
  3630.   3. The enormous effort to adopt the locale files (for updates),
  3631.      prevented me a long time from doing a major update at all. Please
  3632.      notice that all locale files have to be changed, even if I add
  3633.      only one single sentence or word! Now there is no longer such a
  3634.      reason (for me) to delay updates!
  3635.   4. The number of registered users that prefer other languages than
  3636.      german or english is still quite low. This has been the reason not
  3637.      to put a french locale into @{b}DFA@{ub} V1.2x, as in the beginning there
  3638.      was no registered french user at all. Furthermore -- most people
  3639.      prefer the english program texts even if English isn't their
  3640.      native language.
  3641. Since version 2.1 has been finished, the french program texts are
  3642. available as well!
  3643. @EndNode
  3644. @Node "CheckBirthday" "dfa.guide/CheckBirthday"
  3645. @Prev "IntLocaleSupport"
  3646. @Toc "Internal"
  3647. The CheckBirthday Program
  3648. =========================
  3649. Since @{b}DFA@{ub} got its Arexx-Port, it comes along with an Arexx script that
  3650. displays coming birthdays. This script had, besides several pros, one
  3651. real con: It needed much time to process a (long) address list.
  3652. Out of this reason @{b}DFA@{ub} now comes along with an addition tool that does
  3653. the same job, but much faster.
  3654. It can be started out of the shell, with the command:
  3655.      CheckBirthday ADR=ADRESSFILE/A BEFORE=DAYSBEFORE/N AFTER=DAYSAFTER/N DELAY/N
  3656. The meaning of the different parameters:
  3657. @{b}ADDRESSFILE@{ub}
  3658.      The address database file
  3659. @{b}BEFORE@{ub}
  3660.      Number of days before the birthday
  3661. @{b}AFTER@{ub}
  3662.      Number of days after the birthday
  3663. @{b}DELAY@{ub}
  3664.      Delay in seconds after the output of all birthdays
  3665. Starting from Workbench is possible as well! Please notice that you
  3666. have to make sure that you have adjusted the tooltypes to your needs.
  3667. These tooltypes have the same names as the shell parameter.
  3668. Additionally the @{b}WINDOW@{ub} tooltype is available that gives you the chance
  3669. to set the output window position and size, like:
  3670.      WINDOW=CON:20/20/400/200/Geburtstage/AUTO/CLOSE/WAIT
  3671. @EndNode
  3672. @Node "MinConfig" "dfa.guide/MinConfig"
  3673. @Toc "Main"
  3674. Needed Configuration
  3675. ********************
  3676. The minimum configuration for the usage of @{b}DFA@{ub} consists of any @{b}AMIGA@{ub}
  3677. computer that runs at least @{b}AMIGA-OS 2.0@{ub} and 1 MB RAM.
  3678. As the addresses are completely kept in RAM, as more you have as better
  3679. it is.
  3680. A harddisk is not needed, but recommended.
  3681. If you run (at least) Workbench 2.1 on your system, you may change the
  3682. native language if you like (use the Locale preferences program of the
  3683. Workbench to do so).
  3684. If you run version 3.x of the operating system, you can enjoy some
  3685. additional (mostly optical) features of this OS version.
  3686. @EndNode
  3687. @Node "Tips" "dfa.guide/Tips"
  3688. @Toc "Main"
  3689. Hints and Tips
  3690. **************
  3691. Question:
  3692.      After I restarted the computer, @{b}DFA@{ub} has "forgotten" all window
  3693.      positions I'd adjusted before -- why?
  3694. @{b}Answer:@{ub}
  3695.      To save the window positions, you have to save the @{b}DFA@{ub}
  3696.      preferences. This can be done for example by selecting the
  3697.      appropriate menu item (@{b}Settings->Save Preferences@{ub}) of the
  3698.      @{b}DFA-Editor@{ub}.
  3699.      Please remember that the settings and as a consequence of this the
  3700.      window positions as well, can only be saved in the registered
  3701.      version of @{b}DFA@{ub} (see @{"Registration" Link "Registration"}, for details).
  3702. Question:
  3703.      After I entered another position for the application icon, it
  3704.      stayed on the same place as before.
  3705. @{b}Answer:@{ub}
  3706.      Click on the @{b}Show@{ub} check box gadget in the Miscellaneous Window of
  3707.      the @{b}DFA-Preferences@{ub} program (cf. @{"Miscellaneous" Link "PrefsMisc"}) @{b}twice@{ub}. Now the
  3708.      application icon should appear on the desired position, as long as
  3709.      there is no other icon that occupies this position on the
  3710.      Workbench.
  3711. Question:
  3712.      As soon as I want to modify anything, a requester appears which
  3713.      tells me that I need "write access" before I may change my
  3714.      addresses.
  3715. @{b}Answer:@{ub}
  3716.      Switch off the network mode (see @{"Miscellaneous" Link "PrefsMisc"}). If you need the
  3717.      network mode, select @{b}Write Access@{ub} in the @{b}Settings@{ub} menu of the
  3718.      @{b}DFA-Editor@{ub}.
  3719. Question:
  3720.      If I hit the @{b}HELP@{ub} key, I get no online help at all -- nothing
  3721.      happens!
  3722. @{b}Answer:@{ub}
  3723.      Make sure that the online help files (@{b}DFAEditor.guide@{ub} and
  3724.      @{b}DFAPrefs.guide@{ub}) exist and the corresponding tooltypes of the
  3725.      @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program are set correctly (cf.
  3726.      @{"Tooltypes" Link "PrefsTooltypes"}).
  3727. Question:
  3728.      I appended an old @{b}DFA@{ub} file to the current address database, but
  3729.      the appended addresses are not displayed within the address
  3730.      listview!
  3731. @{b}Answer:@{ub}
  3732.      Make sure that you activated the correct group flags. It might be
  3733.      that the appended addresses don't have any group flags set. If
  3734.      this is the case, you will have to @{b}deactivate@{ub} all group check
  3735.      boxes in the @{b}DFA-Editor@{ub} main window, to see these addresses.
  3736. Question:
  3737.      If I access my addresses via AREXX, @{b}DFA@{ub} seems to find not all
  3738.      addresses -- sometimes it even finds no addresses at all!
  3739. @{b}Answer:@{ub}
  3740.      Please notice that the AREXX commands access only the addresses
  3741.      that correspond to the current group selection! To make sure that
  3742.      all addresses can be reached by AREXX, you should either select all
  3743.      group flags in the @{b}DFA-Editor@{ub} main window or use the AREXX command
  3744.      @{b}CHANGEGROUPS@{ub} accordingly.
  3745. Question:
  3746.      After I've entered a new address containing group flags that did
  3747.      @{b}not@{ub} match the current group selection, it was nevertheless
  3748.      displayed in the @{b}DFA-Editor@{ub}'s main window listview. Isn't this
  3749.      behaviour a bit inconsequent?
  3750. @{b}Answer:@{ub}
  3751.      Yes, indeed. However, for many people it would be even more
  3752.      confusing, if the new address which they've just entered, would no
  3753.      be displayed.
  3754. Question:
  3755.      After I've entered a new address, for the present it was displayed
  3756.      in the @{b}DFA-Editor@{ub}'s main window corretly. After I've resized the
  3757.      window, however, the address has disappeared!
  3758. @{b}Answer:@{ub}
  3759.      This problem should be seen together with the previous question.
  3760.      After a new address is entered, it is shown in the listview, no
  3761.      matter if the group selection fits or not. As soon as the window
  3762.      is resized, however, the listview entries are reformatted and the
  3763.      group selection is noticed! This causes all entries to disappear
  3764.      that do not match the current group selection.
  3765. Question:
  3766.      Although I have set the modem preferences as it is needed, my modem
  3767.      does not dial any telephone numbers. The phone number of the
  3768.      address to dial is displayed within the dial window, but the modem
  3769.      does nothing that looks like dialing!
  3770. @{b}Answer:@{ub}
  3771.      Under some circumstances your modem does not like the baud rate you
  3772.      set in the @{b}System Preferences@{ub} (Serial). Decrease the baud rate (in
  3773.      the System Preferences!), until your modem dials correctly.
  3774. @EndNode
  3775. @Node "Thanks" "dfa.guide/Thanks"
  3776. @Toc "Main"
  3777. Thanks to...
  3778. ************
  3779. Many people helped me to make @{b}DFA@{ub} what it is today. Therefore I would
  3780. like to thank...
  3781.    ...   @{b}Robert Blayzor@{ub}
  3782.      For supplying the registration site in the USA.
  3783.    ...   @{b}Michael 'Mick' Hohmann@{ub}
  3784.      Tested the user aspects of @{b}DFA@{ub}.
  3785.    ...   @{b}Martin 'XEN' Huttenloher@{ub}
  3786.      Painted the wonderful MagicWB icons (8 colors)
  3787.      If you like the icons coming with this distribution of @{b}DFA@{ub}, take a
  3788.      look at the complete collection of MagicWB icons by Martin
  3789.      Huttenloher.
  3790.    ...   @{b}Kai Iske@{ub}
  3791.      My "oldest" beta tester. He already tested @{b}DFA@{ub} before version 1.0
  3792.      has been published! For version 2.0 of @{b}DFA@{ub} he supplied me a fast
  3793.      sort routine. The @{b}RemindBirthday@{ub} utility is done by him as well.
  3794.    ...   @{b}Katja and Paul Jewell@{ub}
  3795.      For the proof reading of the english manual and the english
  3796.      registration site.
  3797.    ...   @{b}Andre Lackmann@{ub}
  3798.      For supplying the registration site in Australia.
  3799.    ...   @{b}Etienne Schneider@{ub}
  3800.      For the french locale files and the french registration site.
  3801.    ...   @{b}Stefan Stuntz@{ub}
  3802.      For many telephone chats and his understanding that @{b}DFA@{ub} still
  3803.      doesn't support his @{b}Magic User Interface@{ub} (@{b}MUI@{ub}).
  3804.    ...   @{b}all others,@{ub} that are not explicitly listed here and have sent
  3805.      me bug reports and/or suggestions for improving @{b}DFA@{ub}
  3806. Thanks a lot to all @{b}DFA@{ub} users to be so patient while waiting for @{b}DFA@{ub}
  3807. V2.0 such a long time. I do really hope it is worth the time you've
  3808. waited for it!
  3809. @EndNode
  3810. @Node "Index" "dfa.guide/Index"
  3811. @Toc "Main"
  3812. Index
  3813. *****
  3814. @Index "Index"
  3815.  @{" (Un)set Groups " Link "EditorMenuSetGroups"}                       EditorMenuSetGroups
  3816.  @{" (Un)set Groups " Link "EditorMenuSetGroups"}                       EditorMenuSetGroups
  3817.  @{" ADDRESSFILE " Link "ServerTooltypes"}                          ServerTooltypes
  3818.  @{" ADDRESSFILE " Link "ServerCLIParams"}                          ServerCLIParams
  3819.  @{" CX_POPKEY " Link "ServerTooltypes"}                            ServerTooltypes
  3820.  @{" CX_POPKEY " Link "ServerCLIParams"}                            ServerCLIParams
  3821.  @{" CX_POPUP " Link "ServerCLIParams"}                             ServerCLIParams
  3822.  @{" CX_POPUP " Link "ServerTooltypes"}                             ServerTooltypes
  3823.  @{" CX_PRIORITY " Link "ServerCLIParams"}                          ServerCLIParams
  3824.  @{" CX_PRIORITY " Link "ServerTooltypes"}                          ServerTooltypes
  3825.  @{" DFAEDITOR " Link "ServerCLIParams"}                            ServerCLIParams
  3826.  @{" DFAEDITOR " Link "ServerTooltypes"}                            ServerTooltypes
  3827.  @{" DFAPREFS " Link "EditorTooltypes"}                             EditorTooltypes
  3828.  @{" DFAPREFS " Link "EditorCLIParams"}                             EditorCLIParams
  3829.  @{" DONOTWAIT " Link "ServerTooltypes"}                            ServerTooltypes
  3830.  @{" GUIDEFILE " Link "EditorCLIParams"}                            EditorCLIParams
  3831.  @{" GUIDEFILE " Link "EditorTooltypes"}                            EditorTooltypes
  3832.  @{" GUIDEFILE " Link "PrefsCLIParams"}                            PrefsCLIParams
  3833.  @{" GUIDEFILE " Link "PrefsTooltypes"}                            PrefsTooltypes
  3834.  @{" PORTNAME " Link "ServerTooltypes"}                             ServerTooltypes
  3835.  @{" PORTNAME " Link "ServerCLIParams"}                             ServerCLIParams
  3836.  @{" PUBSCREEN " Link "EditorTooltypes"}                            EditorTooltypes
  3837.  @{" PUBSCREEN " Link "PrefsCLIParams"}                            PrefsCLIParams
  3838.  @{" PUBSCREEN " Link "PrefsTooltypes"}                            PrefsTooltypes
  3839.  @{" PUBSCREEN " Link "EditorCLIParams"}                            EditorCLIParams
  3840.  @{" UPPERPUBSCREEN " Link "PrefsTooltypes"}                       PrefsTooltypes
  3841.  @{" UPPERPUBSCREEN " Link "PrefsCLIParams"}                       PrefsCLIParams
  3842.  @{" UPPERPUBSCREEN " Link "EditorCLIParams"}                       EditorCLIParams
  3843.  @{" UPPERPUBSCREEN " Link "EditorTooltypes"}                       EditorTooltypes
  3844.  @{" AREXX SCRIPTS " Link "Installation"}                        Installation
  3845.  @{" AREXX documentation " Link "ArexxBasics"}                  ArexxBasics
  3846.  @{" AREXX error codes " Link "ArexxErrorCodes"}                    ArexxErrorCodes
  3847.  @{" AREXX port name " Link "ArexxBasics"}                      ArexxBasics
  3848.  @{" AREXX scripts " Link "Installation"}                        Installation
  3849.  @{" AREXX scripts " Link "Installation"}                        Installation
  3850.  @{" About " Link "PrefsMainWindow"}                                PrefsMainWindow
  3851.  @{" About " Link "EditorMenuAbout"}                                EditorMenuAbout
  3852.  @{" About " Link "EditorMenuAbout"}                                EditorMenuAbout
  3853.  @{" Address " Link "Addresses"}                              Addresses
  3854.  @{" Address file " Link "PrefsPaths"}                         PrefsPaths
  3855.  @{" address file format " Link "EditorMenuOpen"}                  EditorMenuOpen
  3856.  @{" address files " Link "ArexxBasics"}                        ArexxBasics
  3857.  @{" Address list " Link "EditorMainWindow"}                         EditorMainWindow
  3858.  @{" Address listview " Link "EditorMainWindow"}                     EditorMainWindow
  3859.  @{" Address Listview " Link "PrefsAList"}                     PrefsAList
  3860.  @{" Address of the author " Link "EditorMenuAbout"}                EditorMenuAbout
  3861.  @{" Address of the author " Link "PrefsMainWindow"}                PrefsMainWindow
  3862.  @{" Addresses " Link "EditorMenuInfo"}                            EditorMenuInfo
  3863.  @{" Adress of the author " Link "MyAddress"}                 MyAddress
  3864.  @{" All " Link "EditorSearch"}                                  EditorSearch
  3865.  @{" AMIGA pattern " Link "EditorSearch"}                        EditorSearch
  3866.  @{" Append " Link "EditorMenuAppend"}                               EditorMenuAppend
  3867.  @{" Append " Link "EditorMenuAppend"}                               EditorMenuAppend
  3868.  @{" AppIcon " Link "EditorMenuQuit"}                              EditorMenuQuit
  3869.  @{" AppIcon " Link "EditorMainWindow"}                              EditorMainWindow
  3870.  @{" Application Icon " Link "PrefsAppIcon"}                     PrefsAppIcon
  3871.  @{" Application Icon " Link "EditorMenuQuit"}                     EditorMenuQuit
  3872.  @{" Application icon " Link "EditorMainWindow"}                     EditorMainWindow
  3873.  @{" Application Icon Position " Link "PrefsAppIcon"}            PrefsAppIcon
  3874.  @{" Application Window " Link "EditorMainWindow"}                   EditorMainWindow
  3875.  @{" Application-Icon " Link "AppIcon"}                     AppIcon
  3876.  @{" Arexx " Link "Arexx"}                                Arexx
  3877.  @{" Arexx Basics " Link "ArexxBasics"}                         ArexxBasics
  3878.  @{" Arexx commands " Link "ArexxCommands"}                       ArexxCommands
  3879.  @{" Arexx Port " Link "EditorMenuInfo"}                           EditorMenuInfo
  3880.  @{" Arexx return value " Link "ArexxReturnAddress"}                   ArexxReturnAddress
  3881.  @{" Arexx Scripts " Link "PrefsArexxCmds"}                        PrefsArexxCmds
  3882.  @{" ASCII editor " Link "PrefsPaths"}                         PrefsPaths
  3883.  @{" ASCII Viewer " Link "PrefsPaths"}                         PrefsPaths
  3884.  @{" Author's address " Link "PrefsMainWindow"}                     PrefsMainWindow
  3885.  @{" Auto Save " Link "PrefsAutoSave"}                            PrefsAutoSave
  3886.  @{" backup " Link "ArexxBasics"}                               ArexxBasics
  3887.  @{" Bank address " Link "GermanRegSite"}                         GermanRegSite
  3888.  @{" Bank address " Link "EnglishRegSite"}                         EnglishRegSite
  3889.  @{" Bank address " Link "MyAddress"}                         MyAddress
  3890.  @{" bank transfer " Link "GermanRegSite"}                        GermanRegSite
  3891.  @{" bank transfer " Link "MyAddress"}                        MyAddress
  3892.  @{" bank transfer " Link "EnglishRegSite"}                        EnglishRegSite
  3893.  @{" Baud " Link "PrefsModem"}                                 PrefsModem
  3894.  @{" Bug Reports " Link "Bugreports"}                          Bugreports
  3895.  @{" Bug Reports " Link "Bugreports"}                          Bugreports
  3896.  @{" Button gadget " Link "UsingDFA"}                        UsingDFA
  3897.  @{" Calling " Link "EditorMenuDial"}                              EditorMenuDial
  3898.  @{" Calling " Link "PrefsModem"}                              PrefsModem
  3899.  @{" Calling " Link "EditorTools"}                              EditorTools
  3900.  @{" Cancel (Edit) " Link "EditorEdit"}                        EditorEdit
  3901.  @{" Cancel (Print) " Link "EditorPrint"}                       EditorPrint
  3902.  @{" Cancel (Search) " Link "EditorSearch"}                      EditorSearch
  3903.  @{" Change Templates " Link "EditorMenuEditTemplate"}                     EditorMenuEditTemplate
  3904.  @{" Check Box " Link "UsingDFA"}                            UsingDFA
  3905.  @{" CheckBirthday " Link "CheckBirthday"}                        CheckBirthday
  3906.  @{" Clear Column " Link "PrefsAList"}                         PrefsAList
  3907.  @{" Clear line " Link "PrefsPList"}                           PrefsPList
  3908.  @{" Clear mark " Link "EditorMainWindow"}                           EditorMainWindow
  3909.  @{" Clear sort criteria " Link "PrefsSort"}                  PrefsSort
  3910.  @{" CLI parameter of the DFA-Editor program " Link "EditorCLIParams"} EditorCLIParams
  3911.  @{" CLI-Parameter des DFA-Preferences-Programms " Link "PrefsCLIParams"} PrefsCLIParams
  3912.  @{" CLI-Parameter des DFA-Servers " Link "ServerCLIParams"}        ServerCLIParams
  3913.  @{" Column " Link "PrefsAList"}                               PrefsAList
  3914.  @{" Commodity " Link "Commodity"}                            Commodity
  3915.  @{" Copy to Clipboard " Link "EditorMenuCopyToClip"}                    EditorMenuCopyToClip
  3916.  @{" Copy to Clipboard " Link "EditorMenuCopyToClip"}                    EditorMenuCopyToClip
  3917.  @{" Copyright " Link "Copyright"}                            Copyright
  3918.  @{" Copyright " Link "PrefsMainWindow"}                            PrefsMainWindow
  3919.  @{" Copyright " Link "EditorMenuAbout"}                            EditorMenuAbout
  3920.  @{" Cycle Gadget " Link "UsingDFA"}                         UsingDFA
  3921.  @{" default settings " Link "Quick Start"}                     Quick Start
  3922.  @{" Device unit " Link "PrefsModem"}                          PrefsModem
  3923.  @{" Dial " Link "EditorMenuDial"}                                 EditorMenuDial
  3924.  @{" Dial " Link "EditorDial"}                                 EditorDial
  3925.  @{" Dial " Link "EditorTools"}                                 EditorTools
  3926.  @{" Dialing " Link "PrefsModem"}                              PrefsModem
  3927.  @{" Documentation for using AREXX " Link "ArexxBasics"}        ArexxBasics
  3928.  @{" Edit " Link "EditorTools"}                                 EditorTools
  3929.  @{" Edit " Link "EditorEdit"}                                 EditorEdit
  3930.  @{" Edit " Link "EditorEdit"}                                 EditorEdit
  3931.  @{" Edit " Link "EditorMenuEdit"}                                 EditorMenuEdit
  3932.  @{" Edit " Link "EditorFull"}                                 EditorFull
  3933.  @{" Edit " Link "EditorMenuEdit"}                                 EditorMenuEdit
  3934.  @{" Edit Template " Link "EditorMenuEditTemplate"}                        EditorMenuEditTemplate
  3935.  @{" EMail address of the author " Link "EditorMenuAbout"}          EditorMenuAbout
  3936.  @{" Error codes of AREXX " Link "ArexxErrorCodes"}                 ArexxErrorCodes
  3937.  @{" Exchange program " Link "Commodity"}                     Commodity
  3938.  @{" External " Link "EditorEdit"}                             EditorEdit
  3939.  @{" External file " Link "EditorEdit"}                        EditorEdit
  3940.  @{" External files " Link "PrefsPaths"}                       PrefsPaths
  3941.  @{" Features " Link "Features"}                             Features
  3942.  @{" Fields " Link "PrefsSort"}                               PrefsSort
  3943.  @{" Fields " Link "PrefsPList"}                               PrefsPList
  3944.  @{" Fields " Link "PrefsAList"}                               PrefsAList
  3945.  @{" Fields to search " Link "EditorSearch"}                     EditorSearch
  3946.  @{" File editor " Link "PrefsPaths"}                          PrefsPaths
  3947.  @{" file format " Link "EditorMenuOpen"}                          EditorMenuOpen
  3948.  @{" File Viewer " Link "PrefsPaths"}                          PrefsPaths
  3949.  @{" Filename " Link "ArexxBasics"}                             ArexxBasics
  3950.  @{" Find " Link "EditorMenuSearch"}                                 EditorMenuSearch
  3951.  @{" find " Link "EditorTools"}                                 EditorTools
  3952.  @{" First " Link "EditorFull"}                                EditorFull
  3953.  @{" Fonts " Link "PrefsFonts"}                                PrefsFonts
  3954.  @{" Format of the Address Field " Link "ArexxReturnAddress"}          ArexxReturnAddress
  3955.  @{" format of the address file " Link "EditorMenuOpen"}           EditorMenuOpen
  3956.  @{" Formfeed " Link "EditorPrint"}                             EditorPrint
  3957.  @{" Free " Link "PrefsAList"}                                 PrefsAList
  3958.  @{" Full " Link "EditorMenuFull"}                                 EditorMenuFull
  3959.  @{" Full " Link "EditorMenuFull"}                                 EditorMenuFull
  3960.  @{" Full " Link "EditorFull"}                                 EditorFull
  3961.  @{" Full " Link "EditorTools"}                                 EditorTools
  3962.  @{" Generate Icon " Link "PrefsGenIcon"}                        PrefsGenIcon
  3963.  @{" Giving a filename " Link "ArexxBasics"}                    ArexxBasics
  3964.  @{" Group handling " Link "PrefsGroups"}                       PrefsGroups
  3965.  @{" Groups " Link "PrefsGroups"}                               PrefsGroups
  3966.  @{" Groups " Link "PrefsGroups"}                               PrefsGroups
  3967.  @{" Hangup String " Link "PrefsModem"}                        PrefsModem
  3968.  @{" Hardware " Link "MinConfig"}                             MinConfig
  3969.  @{" Hayes compatible " Link "PrefsModem"}                     PrefsModem
  3970.  @{" Hints and Tips " Link "Tips"}                       Tips
  3971.  @{" hotkey " Link "Commodity"}                               Commodity
  3972.  @{" hotkey " Link "ServerTooltypes"}                               ServerTooltypes
  3973.  @{" Hotkey " Link "EditorMenuQuit"}                               EditorMenuQuit
  3974.  @{" Hotkey " Link "EditorMainWindow"}                               EditorMainWindow
  3975.  @{" Ignore case " Link "EditorSearch"}                          EditorSearch
  3976.  @{" Important addresses " Link "Addresses"}                  Addresses
  3977.  @{" Info " Link "EditorMenuInfo"}                                 EditorMenuInfo
  3978.  @{" Information " Link "EditorMenuInfo"}                          EditorMenuInfo
  3979.  @{" Init String " Link "PrefsModem"}                          PrefsModem
  3980.  @{" Installation " Link "Installation"}                         Installation
  3981.  @{" Installer " Link "Installation"}                            Installation
  3982.  @{" Installieren " Link "Installation"}                         Installation
  3983.  @{" interface card " Link "PrefsModem"}                       PrefsModem
  3984.  @{" interface card " Link "PrefsModem"}                       PrefsModem
  3985.  @{" Internal " Link "Internal"}                             Internal
  3986.  @{" keyboard usage " Link "UsingDFA"}                       UsingDFA
  3987.  @{" Kill " Link "EditorMenuKill"}                                 EditorMenuKill
  3988.  @{" Kill " Link "EditorTools"}                                 EditorTools
  3989.  @{" Kill " Link "EditorMenuKill"}                                 EditorMenuKill
  3990.  @{" language " Link "Top"}                             Top
  3991.  @{" language " Link "Installation"}                             Installation
  3992.  @{" Last " Link "EditorFull"}                                 EditorFull
  3993.  @{" Legal stuff " Link "Legal"}                          Legal
  3994.  @{" Licence " Link "Licence"}                              Licence
  3995.  @{" Lines " Link "PrefsPList"}                                PrefsPList
  3996.  @{" Listview " Link "UsingDFA"}                             UsingDFA
  3997.  @{" Listview (main window) " Link "EditorMainWindow"}               EditorMainWindow
  3998.  @{" Load " Link "EditorMenuOpen"}                                 EditorMenuOpen
  3999.  @{" Locale " Link "IntLocaleSupport"}                               IntLocaleSupport
  4000.  @{" locale support " Link "Installation"}                       Installation
  4001.  @{" Mark all " Link "EditorMainWindow"}                             EditorMainWindow
  4002.  @{" Mark by name " Link "EditorMainWindow"}                         EditorMainWindow
  4003.  @{" Marking addresses " Link "EditorMainWindow"}                    EditorMainWindow
  4004.  @{" Memory Condition " Link "EditorMenuInfo"}                     EditorMenuInfo
  4005.  @{" Menus " Link "EditorMenus"}                                EditorMenus
  4006.  @{" Miscelleneous " Link "PrefsMisc"}                        PrefsMisc
  4007.  @{" Modem " Link "PrefsModem"}                                PrefsModem
  4008.  @{" Native languages " Link "IntLocaleSupport"}                     IntLocaleSupport
  4009.  @{" Needed Configuration " Link "MinConfig"}                 MinConfig
  4010.  @{" network mode " Link "EditorMenuWriteAccess"}                         EditorMenuWriteAccess
  4011.  @{" Network mode " Link "PrefsNetworking"}                         PrefsNetworking
  4012.  @{" Networking " Link "PrefsNetworking"}                           PrefsNetworking
  4013.  @{" New " Link "EditorMenuNew"}                                  EditorMenuNew
  4014.  @{" New " Link "EditorTools"}                                  EditorTools
  4015.  @{" New " Link "EditorNew"}                                  EditorNew
  4016.  @{" New " Link "EditorNew"}                                  EditorNew
  4017.  @{" New " Link "EditorMenuNew"}                                  EditorMenuNew
  4018.  @{" New address file " Link "EditorMenuNewFile"}                     EditorMenuNewFile
  4019.  @{" New file " Link "EditorMenuNewFile"}                             EditorMenuNewFile
  4020.  @{" New since version 1.2x " Link "ArexxImportant"}               ArexxImportant
  4021.  @{" Next " Link "EditorFull"}                                 EditorFull
  4022.  @{" Next Sel. " Link "EditorFull"}                            EditorFull
  4023.  @{" None " Link "EditorSearch"}                                 EditorSearch
  4024.  @{" Ok (Edit) " Link "EditorEdit"}                            EditorEdit
  4025.  @{" Ok (Full) " Link "EditorFull"}                            EditorFull
  4026.  @{" Online Help " Link "UsingDFA"}                          UsingDFA
  4027.  @{" Open " Link "EditorMenuOpen"}                                 EditorMenuOpen
  4028.  @{" order of the address fields " Link "ArexxImportant"}          ArexxImportant
  4029.  @{" OwnDevUnit " Link "PrefsModem"}                           PrefsModem
  4030.  @{" Panel Listview " Link "PrefsPList"}                       PrefsPList
  4031.  @{" Panel-Listview " Link "EditorMainWindow"}                       EditorMainWindow
  4032.  @{" Paths and Filenames " Link "PrefsPaths"}                  PrefsPaths
  4033.  @{" Pattern " Link "EditorSearch"}                              EditorSearch
  4034.  @{" Phone " Link "PrefsModem"}                                PrefsModem
  4035.  @{" Phone " Link "EditorDial"}                                EditorDial
  4036.  @{" Phone " Link "EditorMenuDial"}                                EditorMenuDial
  4037.  @{" Phone " Link "EditorTools"}                                EditorTools
  4038.  @{" Port name for AREXX " Link "ArexxBasics"}                  ArexxBasics
  4039.  @{" Position of the Application Icon " Link "PrefsAppIcon"}     PrefsAppIcon
  4040.  @{" Predial String " Link "PrefsModem"}                       PrefsModem
  4041.  @{" Preferences " Link "EditorMenuPreferences"}                          EditorMenuPreferences
  4042.  @{" Preferences " Link "EditorMenuPreferences"}                          EditorMenuPreferences
  4043.  @{" Presets " Link "EditorMenuEditTemplate"}                              EditorMenuEditTemplate
  4044.  @{" presets " Link "EditorNew"}                              EditorNew
  4045.  @{" Prev. " Link "EditorFull"}                                EditorFull
  4046.  @{" Prev. Sel. " Link "EditorFull"}                           EditorFull
  4047.  @{" Print " Link "EditorPrint"}                                EditorPrint
  4048.  @{" Print " Link "EditorMenuPrint"}                                EditorMenuPrint
  4049.  @{" Print " Link "EditorPrint"}                                EditorPrint
  4050.  @{" Print " Link "EditorMenuPrint"}                                EditorMenuPrint
  4051.  @{" Print " Link "EditorPrint"}                                EditorPrint
  4052.  @{" Print " Link "EditorTools"}                                EditorTools
  4053.  @{" Print " Link "EditorPrint"}                                EditorPrint
  4054.  @{" Print form " Link "EditorPrint"}                           EditorPrint
  4055.  @{" Print style " Link "EditorPrint"}                          EditorPrint
  4056.  @{" Print to " Link "EditorPrint"}                             EditorPrint
  4057.  @{" program language " Link "Top"}                     Top
  4058.  @{" program texts " Link "Top"}                        Top
  4059.  @{" Public Screen " Link "PrefsTooltypes"}                        PrefsTooltypes
  4060.  @{" Public Screen " Link "EditorTooltypes"}                        EditorTooltypes
  4061.  @{" Quick Start " Link "Quick Start"}                          Quick Start
  4062.  @{" Quit " Link "EditorMenuQuit"}                                 EditorMenuQuit
  4063.  @{" Quit (DFA-Editor main window) " Link "EditorMainWindow"}        EditorMainWindow
  4064.  @{" Quit Preferences " Link "PrefsMainWindow"}                     PrefsMainWindow
  4065.  @{" Radio button " Link "UsingDFA"}                         UsingDFA
  4066.  @{" Receiving AREXX commands " Link "ArexxBasics"}             ArexxBasics
  4067.  @{" Redial delay " Link "PrefsModem"}                         PrefsModem
  4068.  @{" Registration " Link "Registration"}                         Registration
  4069.  @{" Registration " Link "Registration"}                         Registration
  4070.  @{" Registration in Australia " Link "AustraliaRegSite"}            AustraliaRegSite
  4071.  @{" Registration in England " Link "EnglishRegSite"}              EnglishRegSite
  4072.  @{" Registration in France " Link "FrenchRegSite"}               FrenchRegSite
  4073.  @{" Registration in Germany " Link "GermanRegSite"}              GermanRegSite
  4074.  @{" Registration in the USA " Link "USARegSite"}              USARegSite
  4075.  @{" Remove " Link "EditorMenuRemove"}                               EditorMenuRemove
  4076.  @{" Remove " Link "EditorMenuRemove"}                               EditorMenuRemove
  4077.  @{" Remove (DFA-Editor main window) " Link "EditorMainWindow"}      EditorMainWindow
  4078.  @{" Remove (DFA-Editor main window) " Link "EditorMenuRemove"}      EditorMenuRemove
  4079.  @{" Remove DFA " Link "PrefsMainWindow"}                           PrefsMainWindow
  4080.  @{" Retries " Link "PrefsModem"}                              PrefsModem
  4081.  @{" Retries " Link "PrefsNetworking"}                              PrefsNetworking
  4082.  @{" Retry delay " Link "PrefsNetworking"}                          PrefsNetworking
  4083.  @{" Return of address items " Link "ArexxReturnAddress"}              ArexxReturnAddress
  4084.  @{" RXERR_APPENDFAILED " Link "ArexxErrorCodes"}                   ArexxErrorCodes
  4085.  @{" RXERR_CRTEXTIO " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4086.  @{" RXERR_CRTPORT " Link "ArexxErrorCodes"}                        ArexxErrorCodes
  4087.  @{" RXERR_ENVCHANGED " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4088.  @{" RXERR_MODIFIED " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4089.  @{" RXERR_NOCURRENT " Link "ArexxErrorCodes"}                      ArexxErrorCodes
  4090.  @{" RXERR_NODIR " Link "ArexxErrorCodes"}                          ArexxErrorCodes
  4091.  @{" RXERR_NOEXTERNAL " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4092.  @{" RXERR_NOFILE " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4093.  @{" RXERR_NOFILENAME " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4094.  @{" RXERR_NOFIRST " Link "ArexxErrorCodes"}                        ArexxErrorCodes
  4095.  @{" RXERR_NOICONIFY " Link "ArexxErrorCodes"}                      ArexxErrorCodes
  4096.  @{" RXERR_NOLAST " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4097.  @{" RXERR_NOLOAD " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4098.  @{" RXERR_NOMEM " Link "ArexxErrorCodes"}                          ArexxErrorCodes
  4099.  @{" RXERR_NONETWORKAPPEND " Link "ArexxErrorCodes"}                ArexxErrorCodes
  4100.  @{" RXERR_NONETWORKCLEAR " Link "ArexxErrorCodes"}                 ArexxErrorCodes
  4101.  @{" RXERR_NONETWORKEDIT " Link "ArexxErrorCodes"}                  ArexxErrorCodes
  4102.  @{" RXERR_NONETWORKKILL " Link "ArexxErrorCodes"}                  ArexxErrorCodes
  4103.  @{" RXERR_NONETWORKNEW " Link "ArexxErrorCodes"}                   ArexxErrorCodes
  4104.  @{" RXERR_NONETWORKSAVE " Link "ArexxErrorCodes"}                  ArexxErrorCodes
  4105.  @{" RXERR_NONETWORKSELECT " Link "ArexxErrorCodes"}                ArexxErrorCodes
  4106.  @{" RXERR_NONETWORKSORT " Link "ArexxErrorCodes"}                  ArexxErrorCodes
  4107.  @{" RXERR_NONEXT " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4108.  @{" RXERR_NONEXTSEL " Link "ArexxErrorCodes"}                      ArexxErrorCodes
  4109.  @{" RXERR_NOPHONENUM " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4110.  @{" RXERR_NOPREV " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4111.  @{" RXERR_NOPREVSEL " Link "ArexxErrorCodes"}                      ArexxErrorCodes
  4112.  @{" RXERR_NORELOAD " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4113.  @{" RXERR_NOSAVE " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4114.  @{" RXERR_NOSERIALDEV " Link "ArexxErrorCodes"}                    ArexxErrorCodes
  4115.  @{" RXERR_NOTFOUND " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4116.  @{" RXERR_NOWRITELOCK " Link "ArexxErrorCodes"}                    ArexxErrorCodes
  4117.  @{" RXERR_OPNPRT " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4118.  @{" RXERR_SERBUSY " Link "ArexxErrorCodes"}                        ArexxErrorCodes
  4119.  @{" RXERR_SERCONNECT " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4120.  @{" RXERR_SERERROR " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4121.  @{" RXERR_SERNOCARRIER " Link "ArexxErrorCodes"}                   ArexxErrorCodes
  4122.  @{" RXERR_SERNODIALTONE " Link "ArexxErrorCodes"}                  ArexxErrorCodes
  4123.  @{" RXERR_SEROK " Link "ArexxErrorCodes"}                          ArexxErrorCodes
  4124.  @{" RXERR_SERRING " Link "ArexxErrorCodes"}                        ArexxErrorCodes
  4125.  @{" RXERR_SERUNKNOWN " Link "ArexxErrorCodes"}                     ArexxErrorCodes
  4126.  @{" RXERR_SERVOICE " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4127.  @{" RXERR_SYNTAX " Link "ArexxErrorCodes"}                         ArexxErrorCodes
  4128.  @{" RXERR_WRITEALL " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4129.  @{" RXERR_WRITECURRENT " Link "ArexxErrorCodes"}                   ArexxErrorCodes
  4130.  @{" RXERR_WRITESEL " Link "ArexxErrorCodes"}                       ArexxErrorCodes
  4131.  @{" Save " Link "EditorMenuSave"}                                 EditorMenuSave
  4132.  @{" Save " Link "EditorMenuSave"}                                 EditorMenuSave
  4133.  @{" Save as default " Link "EditorMenuSaveasdefault"}                      EditorMenuSaveasdefault
  4134.  @{" Save as default " Link "EditorMenuSaveasdefault"}                      EditorMenuSaveasdefault
  4135.  @{" Save as... " Link "EditorMenuSaveas"}                           EditorMenuSaveas
  4136.  @{" Save as... " Link "EditorMenuSaveas"}                           EditorMenuSaveas
  4137.  @{" Save Preferences " Link "EditorMenuSavePrefs"}                     EditorMenuSavePrefs
  4138.  @{" Save Preferences " Link "PrefsMainWindow"}                     PrefsMainWindow
  4139.  @{" Save Preferences " Link "EditorMenuSavePrefs"}                     EditorMenuSavePrefs
  4140.  @{" Search " Link "EditorMenuSearch"}                               EditorMenuSearch
  4141.  @{" Search " Link "EditorMenuSearch"}                               EditorMenuSearch
  4142.  @{" Search " Link "EditorSearch"}                               EditorSearch
  4143.  @{" Search " Link "EditorTools"}                               EditorTools
  4144.  @{" Search " Link "EditorSearch"}                               EditorSearch
  4145.  @{" search " Link "EditorTools"}                               EditorTools
  4146.  @{" Search criteria " Link "EditorMenuSearch"}                      EditorMenuSearch
  4147.  @{" search criteria " Link "EditorTools"}                      EditorTools
  4148.  @{" Search for " Link "EditorSearch"}                           EditorSearch
  4149.  @{" Search Next " Link "EditorMenuSearchNext"}                          EditorMenuSearchNext
  4150.  @{" Search Next " Link "EditorTools"}                          EditorTools
  4151.  @{" Secret Mode " Link "PrefsSecretMode"}                          PrefsSecretMode
  4152.  @{" Select device " Link "PrefsModem"}                        PrefsModem
  4153.  @{" Selection " Link "EditorMainWindow"}                            EditorMainWindow
  4154.  @{" Selection: All " Link "EditorMainWindow"}                       EditorMainWindow
  4155.  @{" Selection: By name " Link "EditorMainWindow"}                   EditorMainWindow
  4156.  @{" Selection: Clear " Link "EditorMainWindow"}                     EditorMainWindow
  4157.  @{" Selection: Jump to " Link "EditorMainWindow"}                   EditorMainWindow
  4158.  @{" Serial device " Link "PrefsModem"}                        PrefsModem
  4159.  @{" serial interface " Link "PrefsModem"}                     PrefsModem
  4160.  @{" serial interface " Link "PrefsModem"}                     PrefsModem
  4161.  @{" Serial number " Link "EditorMenuAbout"}                        EditorMenuAbout
  4162.  @{" Serial number " Link "PrefsMainWindow"}                        PrefsMainWindow
  4163.  @{" Serielles Ger
  4164. t " Link "PrefsModem"}                     PrefsModem
  4165.  @{" shared access " Link "EditorMenuWriteAccess"}                        EditorMenuWriteAccess
  4166.  @{" shortcut " Link "UsingDFA"}                             UsingDFA
  4167.  @{" Show Application Icon " Link "PrefsAppIcon"}                PrefsAppIcon
  4168.  @{" Software " Link "MinConfig"}                             MinConfig
  4169.  @{" Sort " Link "EditorTools"}                                 EditorTools
  4170.  @{" Sort " Link "PrefsSort"}                                 PrefsSort
  4171.  @{" Sort " Link "EditorMenuSort"}                                 EditorMenuSort
  4172.  @{" Sorting " Link "PrefsSort"}                              PrefsSort
  4173.  @{" String Gadget " Link "UsingDFA"}                        UsingDFA
  4174.  @{" Suff. Dial String " Link "PrefsModem"}                    PrefsModem
  4175.  @{" Syntax " Link "ArexxBasics"}                               ArexxBasics
  4176.  @{" Templates " Link "EditorNew"}                            EditorNew
  4177.  @{" Templates " Link "EditorMenuEditTemplate"}                            EditorMenuEditTemplate
  4178.  @{" Text Gadget " Link "UsingDFA"}                          UsingDFA
  4179.  @{" Text Viewer " Link "PrefsPaths"}                          PrefsPaths
  4180.  @{" Thanks to... " Link "Thanks"}                         Thanks
  4181.  @{" The CheckBirthday Program " Link "CheckBirthday"}            CheckBirthday
  4182.  @{" The concept of DFA " Link "Concept"}                   Concept
  4183.  @{" The DFA-Editor program " Link "DFAEditor"}               DFAEditor
  4184.  @{" The DFA-Preferences Main Window " Link "PrefsMainWindow"}      PrefsMainWindow
  4185.  @{" The DFA-Server program " Link "DFAServer"}               DFAServer
  4186.  @{" The Main Window " Link "EditorMainWindow"}                      EditorMainWindow
  4187.  @{" The Menu Items of the DFA-Editor " Link "EditorMenus"}     EditorMenus
  4188.  @{" Then DFA-Preferences Program " Link "DFAPrefs"}         DFAPrefs
  4189.  @{" Title " Link "PrefsGroups"}                                PrefsGroups
  4190.  @{" Title " Link "PrefsPList"}                                PrefsPList
  4191.  @{" Tool Gadgets " Link "EditorTools"}                         EditorTools
  4192.  @{" Tool Gadgets " Link "EditorTools"}                         EditorTools
  4193.  @{" Tooltypes " Link "ServerTooltypes"}                            ServerTooltypes
  4194.  @{" Tooltypes " Link "ServerTooltypes"}                            ServerTooltypes
  4195.  @{" Tooltypes for the DFA-Editor " Link "EditorTooltypes"}         EditorTooltypes
  4196.  @{" Tooltypes of the DFA-Preferences programms " Link "PrefsTooltypes"} PrefsTooltypes
  4197.  @{" Updates " Link "Updates"}                              Updates
  4198.  @{" Usage of DFA " Link "UsingDFA"}                         UsingDFA
  4199.  @{" Use Preferences " Link "PrefsMainWindow"}                      PrefsMainWindow
  4200.  @{" Used " Link "PrefsAList"}                                 PrefsAList
  4201.  @{" Verbergen " Link "EditorMenuQuit"}                            EditorMenuQuit
  4202.  @{" Version number " Link "PrefsMainWindow"}                       PrefsMainWindow
  4203.  @{" version number " Link "EditorMenuAbout"}                       EditorMenuAbout
  4204.  @{" Visible lines " Link "PrefsPList"}                        PrefsPList
  4205.  @{" Warranty " Link "Warranty"}                             Warranty
  4206.  @{" Weight " Link "PrefsAList"}                               PrefsAList
  4207.  @{" Write Access " Link "EditorMenuWriteAccess"}                         EditorMenuWriteAccess
  4208.  @{" Write Access " Link "EditorMenuWriteAccess"}                         EditorMenuWriteAccess
  4209. @EndNode
  4210.