Changes between Initial Version and Version 1 of Documentation/ARexxAPI/ADDRLOAD


Ignore:
Timestamp:
Sep 22, 2013 9:27:14 PM (11 months ago)
Author:
AmigaPhil
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/ARexxAPI/ADDRLOAD

    v1 v1  
     1== ADDRLOAD 
     2 
     3'''NAME''' 
     4     AddrLoad -- Load an address book from disk.  (V2.0) 
     5 
     6'''TEMPLATE''' 
     7     FILENAME/A 
     8 
     9'''FUNCTION''' 
     10     Loads the specified address book from disk, replacing the 
     11     current address book in RAM. 
     12 
     13'''INPUTS''' 
     14     FILENAME/A   - address book to be loaded 
     15 
     16'''RETURNS''' 
     17     RC is set to 10 if the filename cannot be opened. 
     18 
     19     As of V2.4, this condition also triggers an error requester. 
     20 
     21'''NOTES''' 
     22     Loading a new address book from disk does not count as a change 
     23     in the address book itself, which means you won't be warned if 
     24     you try to quit YAM after loading that file, and thus will lose 
     25     the new information if you forget to save it. 
     26 
     27     As of V2.4, YAM pays attention to the contents of the supplied file. 
     28     If the file is not recognised as a valid address book, a requester 
     29     will open to let the user select whether he wants it to be loaded 
     30     as a list of email addresses where items can be specified as 
     31 
     32      <email@example.com> Real name 
     33 
     34     or 
     35 
     36      email@example.com 
     37 
     38     because names are optional.  YAM will automatically create aliases 
     39     for the new items, and the command will not return until the 
     40     requester is satisfied. 
     41 
     42'''EXAMPLE''' 
     43         /* Load an address book from disk */ 
     44 
     45         ADDRLOAD 'mail:addresslist' 
     46 
     47'''BUGS''' 
     48 
     49'''SEE ALSO'''