| 1 | == ADDRNEW |
| 2 | |
| 3 | '''NAME''' |
| 4 | AddrNew -- Create a new entry in the address book. (V2.0) |
| 5 | |
| 6 | '''TEMPLATE''' |
| 7 | VAR/K,STEM/K,TYPE,ALIAS,NAME,EMAIL |
| 8 | |
| 9 | '''FUNCTION''' |
| 10 | Creates a new entry in the address book and inserts it below |
| 11 | the last active entry. If the address book window has not yet |
| 12 | been opened in the current session, the new entry will be added |
| 13 | below the first entry. |
| 14 | |
| 15 | '''INPUTS''' |
| 16 | VAR/K - variable where the alias of the resulting entry will be stored\\ |
| 17 | STEM/K - base name used for the stem where the alias of the resulting entry will be stored\\ |
| 18 | TYPE - type of entry, may be one of G (group), L (distribution list) or P (person, the default value)\\ |
| 19 | ALIAS - alias for the new entry\\ |
| 20 | NAME - real name for the new entry\\ |
| 21 | EMAIL - email address for the new entry\\ |
| 22 | |
| 23 | '''RETURNS''' |
| 24 | VAR - alias of the resulting entry\\ |
| 25 | <STEM>ALIAS - alias of the resulting entry\\ |
| 26 | |
| 27 | '''NOTES''' |
| 28 | At least one of ALIAS, NAME or EMAIL should be specified. Bogus |
| 29 | types are simply ignored. |
| 30 | |
| 31 | If the provided alias exists already, a new alias will be used |
| 32 | instead by taking the supplied string and adding a trailing |
| 33 | number until no clash is produced. String limits are also taken |
| 34 | into account. |
| 35 | |
| 36 | If no alias is provided, one will be created automatically by |
| 37 | using a cut-down version of the NAME or EMAIL arguments; for |
| 38 | instance, "Jose Luis Feliciano" would turn into "J_Feliciano", |
| 39 | or "Jose" if Jose@example.com was the only argument provided. |
| 40 | The rule mentioned above is also applied. |
| 41 | |
| 42 | If the address book window is closed at the time the new entry |
| 43 | is added, it won't count as a change in the address book, which |
| 44 | means you won't be warned if you try to quit YAM afterwards |
| 45 | without saving the address book. |
| 46 | |
| 47 | While using spaces in aliases is possible, it is discouraged. |
| 48 | |
| 49 | '''EXAMPLE''' |
| 50 | /* Create a new group */ |
| 51 | |
| 52 | ADDRNEW G 'Singers' |
| 53 | |
| 54 | /* Create a new distribution list */ |
| 55 | |
| 56 | ADDRNEW L 'Spanish' |
| 57 | |
| 58 | '''BUGS''' |
| 59 | |
| 60 | '''SEE ALSO''' |
| 61 | [[rx_addredit| ADDREDIT ]] |