From owner-freebsd-doc Wed May 29 14:55:34 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 997E637B400; Wed, 29 May 2002 14:55:30 -0700 (PDT) Received: from unknown (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.12.3/8.12.3) with SMTP id g4TLtS4T092584; Wed, 29 May 2002 17:55:28 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Wed, 29 May 2002 17:57:29 -0400 From: Tom Rhodes To: Giorgos Keramidas Cc: freebsd-doc@FreeBSD.org Subject: Re: (man page || manpage) => manual page Message-Id: <20020529175729.23b01633.trhodes@FreeBSD.org> In-Reply-To: <20020529214746.GA67346@hades.hell.gr> References: <20020529214746.GA67346@hades.hell.gr> X-Mailer: Sylpheed version 0.7.5claws (GTK+ 1.2.10; i386-portbld-freebsd4.6) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 On Thu, 30 May 2002 00:47:47 +0300 Giorgos Keramidas wrote: > Hello there, > > Nice to see someone has taken it upon himself to finish the job I left > in the middle (by completing only the articles/ part) a while ago. > > > config file with the appropriate entries. See the > > - stl(4) man page and the appropriate section of > > the+ stl(4) manual page and the appropriate > > section of the > > When &man.xxx.y; references are being made I prefer the style that > Jeroen suggested to me a long time ago. Instead of writing: > > "see the foo(n) manpage" > > You can simply use "see foo(n)", since it should be apparent that this > is a reference to a manual page. Repeating in every such place that > it "is a manual page" is a bit of an overkill. My point here was NOT to reword things, so that we may be nicer to the translators... And then reword them later, but try to get all instances at the same time... I feel smacking them all right now would be best, and then perhaps reword things later. What do you think? I agree that ``please review the manual page for more options.'' Or ``see blah(1)'' Opinion? -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message