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


Ignore:
Timestamp:
Sep 22, 2013, 9:27:14 PM (15 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'''