home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / MUI / AM_Mui1.3.lha / AM_Mui1.3 / Docs / English / AM_Mui_E.doc < prev    next >
Encoding:
Text File  |  2008-10-04  |  13.0 KB  |  342 lines
  1.                     The  documentation of
  2.  
  3.                       ADDRESSMANAGER for MUI V1.3
  4.  
  5. Chapters:
  6.  
  7. 1) IMPORTANT!!!
  8. 2) WHAT IS ADDRESSMANAGER FOR MUI
  9. 3) INSTALLATION
  10. 4) USING ADDRESSMANAGER FOR MUI:
  11.    I)   GENERAL INFORMATION
  12.    II)  STARTING
  13.    III) CONFIGURATION
  14.    IV)  EDITING
  15.    V)   SAVING, LOADING, PRINTING...
  16.    VI)  SEARCHING
  17. 5) HISTORY
  18. 6) FUTURE-PLANS
  19. 7) CREDITS
  20.  
  21. -------------------------------------------------------------------------------
  22.  
  23. 1) IMPORTANT
  24.  
  25. - AddressManager for MUI and the files which belong to the program may be 
  26.   copied if they are not changed. All changes concerning the program, the     
  27.   catalogs or the documentation have to be allowed by the author.
  28. - AddressManager for MUI may be copied and used freely.
  29.   If you think that AddressManager for MUI is a good program and its
  30.   development should be continued, you can send me some money, a small gift,
  31.   a letter or a postcard. In this way you can show me, that there are people
  32.   using this software, and I will be more motivated to keep on developing it.
  33.   (see also CREDITS)
  34. - Commercial  usage or  distribution without a licence from the author is not 
  35.   allowed!
  36. - AddressManager for MUI may be distributed on Public-Domain-Disks and through
  37.   E-Mail if the program and all files of the distribution-package are included
  38.   and not changed.
  39. - The program and all files which belong to it were developed and tested very
  40.   carefully, so you should have no problems using them. But anyway:
  41.   THE  AUTHOR CAN NOT BE  MADE  RESPONSIBLE FOR ANY  DAMAGE ON  YOUR SOFT- OR
  42.   HARDWARE CAUSED BY ADDRESSMANAGER AND THE FILES COMING ALONG WITH IT.
  43.  
  44. -----------------------------------------------------------------------------
  45.  
  46. 2) WHAT IS ADDRESSMANAGER
  47.  
  48. AddressManager is an utillity which makes it easier for you to master all the
  49. information you have  about your friends, familly, business partners or pets.
  50.  
  51. AddressManager for MUI is different from most other similar programs, because
  52. it uses Stefan Stuntz`s Magic User Interface. This great user interface gives
  53. you the possibilty to configure you application as you like it.
  54.  
  55. AM is not a professional Data-Banking-System, but it has a lot of advantages
  56. if you just want to manage names, telephone numbers etc. of some people:
  57. - AddressManager is very easy to use.You can learn all the functions in a few
  58.   minutes.
  59. - AddressManager supports MUI and therefore you can configurate its user 
  60.   interface
  61. - AddressManager for MUI has:
  62.   - AppIcons and AppWindows
  63.   - Commodity support
  64.   - Online-Help
  65.   - Asl- or Reqtools-Requester
  66.   - if you own WB 2.1 or higher you can use it in English or German language
  67. - AddressManager for MUI is PD. You can copy and use it freely.
  68.   If you want to "reward" me for my work and increase my motivation to keep
  69.   on developing this software, you can send me something nice (letters, 
  70.   postcards, money, gifts etc.). (see also CREDITS)
  71.  
  72. -----------------------------------------------------------------------------
  73.  
  74. 3) INSTALLATION
  75.  
  76. To use AddressManager for MUI you will need an AMIGA with Kickstart and 
  77. Workbench 2.0 or better. You also need MUI 2.0 or better. It should already
  78. be installed on your system-disk.
  79.  
  80. If you don`t have MUI you can:
  81. - get MUI (more abou this in the file ReadMe.MUI)
  82. - get AddressManager 2.2. This is a program which has almost all features of
  83.   AM for MUI, but works without MUI. You will have to do without some user-
  84.   interface-features like online-help or font-sensitivity.
  85.  
  86. AddressManager for MUI supports the Reqtools.library (v38 or higher). It will
  87. be used automatically unless you wish to use asl instead. (read CONFIGURATION
  88. for more)
  89.  
  90. If you own the Commodore-INSTALLER, you can use one of the scripts in the 
  91. INSTALL directory. It will do all the work for you. 
  92. Otherwise:
  93.  
  94. AddressManager for MUI and the docs can be copied to any directory.
  95.  
  96. If you have WB2.1 or better, you can also use AddressManager in german. In 
  97. this case you should copy the file
  98.  
  99.     Catalogs/deutsch/Am_Mui.catalog
  100.  
  101. to
  102.  
  103.     Locale:Catalogs/deutsch
  104.  
  105. If the amigaguide.library is installed on your system you can use AM`s online
  106. help. Then you should copy the file 
  107.  
  108.     Help/xxx/Am_Mui.help
  109.  
  110. to  
  111.  
  112.     Help:xxx
  113.  
  114. XXX should be replaced by the language you want to use. (english or deutsch)
  115.  
  116. -----------------------------------------------------------------------------
  117.  
  118. 4) USING ADDRESSMANAGER FOR MUI
  119.  
  120. I) General information
  121. When you work in the main window of AddressManager for MUI you can use the
  122. online-help. (If you have the amigaguide.library and if you installed the 
  123. AM_Mui.help file)
  124. If you need some information about a gadget, just place the mouse-pointer 
  125. above this gadget and press HELP. Now a new window appears, in which you can
  126. read a description of the gadget. After you finished reading, just close the
  127. window to come back to the AddressManager-window.
  128.  
  129. AddressManager for MUI is a commodity. It can be manipulated with the program
  130. EXCHANGE.
  131.  
  132. AddressManager`s main window is an AppWindow. That means that you can "throw"
  133. files (data-, parameters- or preferences-files) into this window to load them.
  134. If you iconify the program, there is an AppIcon which has exactly the same
  135. function as the AppWindow.
  136. The AppIcon can be defined by creating a file called "env:AMM_AppIcon.info".
  137. Otherweise either AM_Mui1.3.info or the default icon will be used.
  138.  
  139. II) Starting 
  140. - from the WB:
  141.  
  142.   Just double-click the AddressManager-icon to start the program. If you want
  143.   to load some data at the same time just click the AM-icon once, press SHIFT
  144.   and double-click the icon of the data-file. 
  145.  
  146. - from the Shell:
  147.   
  148.   AM_Mui1.3 [FILE]
  149.  
  150.   FILE can be some data-file which you want to be loaded together with AM.
  151.  
  152.  
  153. III) Configuration
  154. There are several possibilities of configuring AddressManager for MUI:
  155.  
  156. - MUI-Prefs
  157.   Here you can set up many features of the application, such as which font is
  158.   used, how the gadgets look like and many more... (included in the MUI 
  159.   archive)
  160.  
  161. - WB-Prefs
  162.   AddressManager for MUI uses the same Locale,Printer,Screen etc. preferences
  163.   as the Workbench
  164.  
  165. - Tooltypes
  166.   If you click on the Am_Mui1.2 icon and then select INFORMATION form WB`s
  167.   ICON-menu you can set up the tooltypes. Additionally to standard tooltypes
  168.   as DONOTWAIT, AddressManager for MUI has 2 own tooltypes:
  169.   - ASL_FILEREQ forces the program to use asl-filerequester even if the 
  170.     reqtools.library is there.
  171.   - STD_MSGREQ does the same with message-requesters.
  172.  
  173. - intern prefs:
  174.   On the PREFERENCES-page you can set up lots of features. If you want the 
  175.   program to use the new prefs you have to press USE or SAVE. The differnce
  176.   is that in the second case the prefs will be also available after you 
  177.   reboot the system. If you want to save the prefs to use them later and not
  178.   immediatly you can do it by pressing SAVE AS. If you want to use the saved
  179.   prefs you have to load the file with the LOAD gadget. 
  180.   The gadget RESTORE resets the prefs to the values which existed when you 
  181.   pressed SAVE or USE for the last time. 
  182.   Now the different things you can set up:
  183.  
  184.   - DIRECTORY. Here you can define the working directory of AM for MUI. This
  185.     directory will be activated automatically in all requesters until you
  186.     select an other drawer.
  187.  
  188.   - the part HOW TO PRINT consists of 4 gadgets:
  189.     - HORIZONTAL
  190.       Here you can decide if you want horizontal, for example:
  191.  
  192. Surname    Name       | Street             City         | Telephone
  193.  
  194.       or vertical, for example:
  195.  
  196. Surname Name
  197. Street
  198. City
  199. Telephone
  200.  
  201.        output.
  202.     - SURNAME FIRST decides whether the surname or the firts name is printed
  203.       firts
  204.     - HEADERS decides whether every line/column begins with NAME:, STREET...
  205.     - ONLY EXISTING... (only in VERTICAL-mode) makes the program NOT print 
  206.       empty lines like
  207.       
  208.      Remarks:
  209.     
  210.     - The part WHAT TO PRINT changes the way items are printed.
  211.       The first gadget selects the item (NAME,SURNAME...) you want to set up.
  212.       The next gadget decides whether the item is printed and in which style.
  213.       If you activate SEPARATE, the item will be separated from the next one
  214.       by " | " otherwise only by " ". (only in HORIZONTAL-mode)
  215.       CHARS (only in HORIZONTAL-mode) decides how many chars of a line will
  216.       be allocated for this item. The total of all items and the chars 
  217.       separating them cannot be higher then the lenght of a line of your 
  218.       printer (which can be set up in the PRINTER-prefs).
  219.  
  220. EXAMPLE:
  221. Your PRINTER-prefs look like this:
  222. Pica (10cpi)
  223. Left margin : 2
  224. Right margin: 78
  225. So there are 76 columns free for AddressManager output.
  226.  
  227.  
  228. Surname    Name       | Street               City            | Telephone     
  229. ----------------------------------------------------------------------------
  230. Xxxx       Xxxxx      | Xxxxx Xxx x          XXXXX XXXXXX    | XXXX/XXXXXX
  231. Yyyyyyy    Yyyyyy     | YYYY Yyy y           YYYYY Yyyyyyyy  | YYYYY/YYY
  232.                                                             
  233.    10         10      ^        20                 15         ^     12
  234.               |                      |
  235.                   Separation                  Separation
  236.  
  237. To get this output you have to set the PRINT gadget to "Do not print" in
  238. BIRTHDAY, COUNTRY and REMARKS. You should set CHARS to the following vallues:
  239. Surname   : 10
  240. Name      : 10
  241. Street      : 20
  242. City      : 15
  243. Telephone : 12
  244. Also you should activate Separate in NAME and CITY.
  245.        
  246.       CHARS FREE shows you how many chars are still free.
  247.  
  248. IV) Editing data
  249. - Adding new entries: Enter the data in the string-gadgets on the MAIN-Page.
  250.   If you finished editing them just press NEW PERSON. The person will be 
  251.   added to the list and you will see the name in the listview-gadget.
  252. - Viewing data: Just click on the name of the person in the listview-gadget.
  253. - Changing data: Click on the name of the person in the listview-gadget. Then
  254.   edit the data in the string-gadgets. After finishing it just press UPDATE.
  255. - Deleting data: Select one or more entries and then press DELETE.
  256. - CLEAR deletes the contents of the string-gadgets without removing the entry
  257.   from the list. Useful if you want to enter a new person.
  258.  
  259. V) Loading, saving, printing...
  260. - NEW delets all data.
  261. - With LOAD you can restore saved data. If there are already some entries in
  262.   the list you can select whether you want to add the new data to the old or
  263.   to replace the old by the new.
  264. - SAVE AS and SAVE write the data into a file. The difference is that SAVE
  265.   tries to save under the old filename,while SAVE AS always opens a requester
  266.   Also SAVE AS is able to save only the selected entries.
  267. - PRINT lets you choose whether you want to print all data or only the 
  268.   selected entries. What the outputs looks like you can be set up on the
  269.   PREFERENCES-page.
  270.   You can also "print" into a file by clicking on "In file..." in the 
  271.   requester.
  272.   You can also print on a letter envelope. The printing is than centered and
  273.   consists only of the name, and the address. Also the country is printed
  274.   unless you have selected DO NOT PRINT for it on the PREFERENCES-page.
  275.  
  276. IV) Searching
  277. - on the page called SEARCHING PARAMETERS you can edit the parameters in the
  278.   string-gadgets. The parameters may contain jokers like #? (more about this
  279.   in your AMIGA-manual). The capitalization is ignored.
  280.   On this page you can also save and load the parameters and CLEAR the string
  281.   gadgets.
  282. - To start searching using the parameters you have edited on the PARAMETERS
  283.   page just press SEARCH. The program always starts with the first entry. If
  284.   a person which fits all parameters is found, it will be displayed in the 
  285.   string-gadgets, otherwise the message "NOT FOUND!" will be shown. If you
  286.   want to continue searching, just press GO ON.
  287.   
  288. -----------------------------------------------------------------------------
  289.  
  290. 5) HISTORY
  291.  
  292. - AddressManager for MUI 1.0 (04.07.1994):
  293.   - first release
  294. - AddressManager for MUI 1.1 (27.07.1994):
  295.   - fixed a major bug in the print-function and some minor in the prefs
  296. - AddressManager for MUI 1.2 (20.08.1994):
  297.   - fixed a major bug in the name-list
  298.   - the list is now built up faster
  299.   - improved the Installer-script
  300. - AddressManager for MUI 1.3 (27.09.1994) (all changes suggested by Eirik
  301.   Bogsnes):
  302.   - fixed a bug in the print-function
  303.   - you can print into an ASCII-file now
  304.   - env:AMM_AppIcon.info can be used as the AppIcon-image
  305.  
  306. -----------------------------------------------------------------------------
  307.  
  308. 6) FUTURE PLANS
  309.  
  310. - use good ideas, which I hope to get from you
  311. - a complete AREXX-Port
  312. - editing of several files at the same time
  313.  
  314. I will of course double my efforts if I know that there are people who use the
  315. programm. You can show me that you use AddressManager for MUI by sending me
  316. some money, a small gift or a letter (see also CREDITS).
  317.  
  318. -----------------------------------------------------------------------------
  319.  
  320. 7) CREDITS
  321.  
  322. AddressManager for MUI and all files coming along with it were developed by:
  323.  
  324.               MICHAEL SCHIKORA
  325.                 CHEMNITZER WEG 1
  326.                 53119 BONN
  327.               GERMANY
  328.  
  329. Send all bug-reports, ideas, letters, postcards, money, gifts etc. to this
  330. address. 
  331.  
  332. Testing:
  333. THORSTEN SCHULZ
  334. MICHAEL SCHIKORA
  335.  
  336. Thanks to:
  337. NORBERT PÜSCHEL for his help
  338.  
  339. -----------------------------------------------------------------------------
  340.  
  341. ©1994 Michael Schikora
  342.