Jason L Tibbitts III <tibbs@hpc.uh.edu> wrote:
> >>>>> "DP" == David Potter <potter@csuite.chebucto.ns.ca> writes:
>
> DP> I recommend real examples...
>
> Of course, you then have to be sure that you don't use real machines, list
> names or addresses, because then they'll neglect to change them.
>
> You can't win.
>
> BTW, I do use real examples in the mj_shell manpage. I also make certain
> that all addresses are someuser@example.com, because example.com has been
> reserved for use in example addresses.
There's another approach, which is used in the mh documentation and
in the document I wrote and put up on the net at
http://medstat.med.utah.edu/medstat_ops
That is to have the relevant hostnames and directories represented in
the document as parameters, and have the installation procedure configure
them to the real hostname and directories of the target machine.
Personally I like this approach since it presents the list administrator,
who is probably expert in the subject of the list but not necessarily
expert in computer arcana, with a minimum of symbols that are subject
to intepretation.
Of course the user who subscribes would still be joe@example.com or
something like that ...
-- Walt
-------
"If this is comfortable for you, you aren't pushing yourself hard enough."
- Lonnie Burton
"If you don't like those ideas, I got others." - Marshall McLuhan
Follow-Ups:
References:
|
|
