From owner-freebsd-current Mon Jun 29 02:48:12 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id CAA11829 for freebsd-current-outgoing; Mon, 29 Jun 1998 02:48:12 -0700 (PDT) (envelope-from owner-freebsd-current@FreeBSD.ORG) Received: from oslo.geco-prakla.slb.com (geos01.oslo.geco-prakla.slb.com [134.32.44.131]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id CAA11759 for ; Mon, 29 Jun 1998 02:47:56 -0700 (PDT) (envelope-from smoergrd@oslo.geco-prakla.slb.com) Received: from sunw157.oslo.Geco-Prakla.slb.com (sunw157 [192.23.231.83]) by oslo.geco-prakla.slb.com (8.8.8/8.6.9) with SMTP id LAA13892 ; Mon, 29 Jun 1998 11:47:18 +0200 (MET DST) Received: by sunw157.oslo.Geco-Prakla.slb.com (SMI-8.6/SMI-SVR4) id LAA07333; Mon, 29 Jun 1998 11:47:17 +0200 To: Doug Rabson Cc: Thomas Dean , current@FreeBSD.ORG Subject: Re: Draft manpages available for review References: Organization: Schlumberger Geco-Prakla X-Disclaimer: I speak only for myself. From: smoergrd@oslo.geco-prakla.slb.com (Dag-Erling Coidan Smørgrav) Date: 29 Jun 1998 11:47:16 +0200 In-Reply-To: Doug Rabson's message of Mon, 29 Jun 1998 09:16:02 +0100 (BST) Message-ID: Lines: 13 X-Mailer: Gnus v5.3/Emacs 19.34 Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Doug Rabson writes: > > Some man pages do not have 'Return Values' sections. > > [...] > I didn't bother with a 'Return Values' section for functions which were > void or where the return value was described in the 'Description' section. Bzzzt, if you basically know what the function does but are unsure about the return values, having a separate RETURN VALUES section is very useful since it makes finding this information much quicker. DES (who can never remember what fgets() returns...) -- Dag-Erling Smørgrav - smoergrd@oslo.geco-prakla.slb.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message