From owner-freebsd-doc Thu Sep 26 11:55:52 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6E2BE37B401; Thu, 26 Sep 2002 11:55:51 -0700 (PDT) Received: from rwcrmhc52.attbi.com (rwcrmhc52.attbi.com [216.148.227.88]) by mx1.FreeBSD.org (Postfix) with ESMTP id 04E1E43E6A; Thu, 26 Sep 2002 11:55:51 -0700 (PDT) (envelope-from swear@attbi.com) Received: from localhost.localdomain ([12.242.158.67]) by rwcrmhc52.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020926185550.WTLM1696.rwcrmhc52.attbi.com@localhost.localdomain>; Thu, 26 Sep 2002 18:55:50 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) by localhost.localdomain (8.12.5/8.12.5) with ESMTP id g8QIwG3q092438; Thu, 26 Sep 2002 11:58:16 -0700 (PDT) (envelope-from swear@attbi.com) Received: (from jojo@localhost) by localhost.localdomain (8.12.5/8.12.5/Submit) id g8QIwA9r092435; Thu, 26 Sep 2002 11:58:10 -0700 (PDT) (envelope-from swear@attbi.com) X-Authentication-Warning: localhost.localdomain: jojo set sender to swear@attbi.com using -f To: Ceri Davies Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/43364: Man page for hier(7) doesn' have /var/empty References: <200209261710.g8QHA3MC055583@freefall.freebsd.org> From: swear@attbi.com (Gary W. Swearingen) Date: 26 Sep 2002 11:58:10 -0700 In-Reply-To: <200209261710.g8QHA3MC055583@freefall.freebsd.org> Message-ID: Lines: 11 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 Ceri Davies writes: > I think it's reasonable to expect users to cross-reference manuals. > With the privilege separation pointer, they'll know what they are looking for > when they fire up the sshd manual as well. I think it's reasonable to expect users to search for "/var/empty" in the sshd manual when the "/var/empty" description says "see sshd(8)". Giving them some nonsense string to also search for (and find in multiple places (only one right), in this case) is less than helpful. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message