Date: 27 Mar 2002 11:16:05 -0800 From: swear@blarg.net (Gary W. Swearingen) To: Danny Howard <dannyman@toldme.com> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/35575: Pw(8) man page makes no mention of /var/log/userlog Message-ID: <bhvgbhizyi.gbh@localhost.localdomain> In-Reply-To: <200203270310.g2R3A2W60789@freefall.freebsd.org> References: <200203270310.g2R3A2W60789@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Danny Howard <dannyman@toldme.com> writes:
> Well, in pw(8) there is a list of 9 files that pw uses to go about its
> business. Even temporary files are documented. One would expect if so
> many files are listed, but no log file is mentioned, that there is no
> log file.
Yes, especially since the file is written even if the rw.conf doesn't
exist and/or the user as never had reason to read its manual.
And I just noticed a bunch of files with strange names like
"/etc/pw.DCCtvU~". Are those coming from "pw" or "vipw", the manuals
of which don't mention "/etc/pw.*~" files, or what?
But I'm sure that the issue of which info goes in which of the two
manuals is a very troublesome one and it's probably not worth worrying
a lot about. Just say in each manual:
This manual omits some relevant information which is covered by the
other_manual() manual to avoid duplication, so both manuals should
be consulted.
How would you propose listing "logfile"? Just list the default file,
or somehow mention the configuration-named file or both?
> Pw.conf(5) on the other hand, lists four files, with no descriptions,
> and does not mention the log in the files section.
It's debatable whether it should mention anything EXCEPT "logfile" and
its default.
> Also, at least as of 4.5-RELEASE, the default log file is not mentioned
> in pw.conf(5) either. The logfile config is mentioned, but no default
> value is specified. The logical conclusion being that if you want pw to
> log anything, you need to explicitly spell it out, although it has
> already been logging to the unobviously-named /var/log/userlog all
> along!
I infer from the "logfile" description, that there IS no default file,
but I find no "userlog" under /etc and yet the file is used anyway.
What does "leave the field blank" mean? Use "logfile=" or not use
"logfile" at all or both?
(If you change the description, please change "field" too; I guess it's
not totally inappropriate, but it sounds weird for a configuration file
variable=value kind of thing.)
P.S. I just noticed
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bhvgbhizyi.gbh>