From owner-freebsd-doc Wed Mar 27 11:17:31 2002 Delivered-To: freebsd-doc@freebsd.org Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id B852937B41A for ; Wed, 27 Mar 2002 11:17:24 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id B3B84BD8C; Wed, 27 Mar 2002 11:17:23 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id LAA29860; Wed, 27 Mar 2002 11:17:23 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id g2RJG5p73276; Wed, 27 Mar 2002 11:16:05 -0800 (PST) (envelope-from swear@blarg.net) To: Danny Howard Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/35575: Pw(8) man page makes no mention of /var/log/userlog References: <200203270310.g2R3A2W60789@freefall.freebsd.org> From: swear@blarg.net (Gary W. Swearingen) Date: 27 Mar 2002 11:16:05 -0800 In-Reply-To: <200203270310.g2R3A2W60789@freefall.freebsd.org> Message-ID: Lines: 48 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Danny Howard 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