Return to macros.tex CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / manual

Annotation of 43BSDReno/contrib/isode-beta/doc/manual/macros.tex, revision 1.1.1.1

1.1       root        1: % run this through LaTeX with the appropriate wrapper
                      2: 
                      3: \chapter      {The ISO Macros Database}\label{isomacros}
                      4: The database \file{isomacros} in the ISODE \verb"ETCDIR" directory
                      5: (usually \file{/usr/etc/})
                      6: contains a simple mapping between
                      7: user-friendly strings and network addresses.
                      8: This database is used by when trying to resolve textual respresentations of
                      9: network addresses
                     10: (as desccribed in Section~\ref{addr:encodings}) for use with the network.
                     11: 
                     12: The database itself is an ordinary ASCII text file containing an entry for
                     13: each locally defined macro.
                     14: Each entry contains
                     15: \begin{itemize}
                     16: \item  the macro, a simple string; and,
                     17: 
                     18: \item  the prefix of the corresponding network address.
                     19: \end{itemize}
                     20: Blanks and/or tab characters are used to seperate items.
                     21: However, double-quotes may be used to prevent separation for items containing
                     22: embedded whitspace.
                     23: The sharp character (`\verb"#"') at the beginning of a line indicates a
                     24: commentary line.
                     25: 
                     26: Unlike the other databases in the ISODE,
                     27: the user may not directly access this file.
                     28: The routine \verb"str2paddr" and \verb"paddr2str" use this automatically.
                     29: 
                     30: \section      {User-Specific Macros}
                     31: By default a user-specific macros database is consulted before the
                     32: system-wide macros file.
                     33: The user-specific file is called \file{\$HOME/.isode\_macros} in the user's
                     34: home directory.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.