From owner-freebsd-stable@FreeBSD.ORG Sun Mar 30 10:27:36 2008 Return-Path: Delivered-To: freebsd-stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D7642106564A for ; Sun, 30 Mar 2008 10:27:36 +0000 (UTC) (envelope-from bms@FreeBSD.org) Received: from out4.smtp.messagingengine.com (out4.smtp.messagingengine.com [66.111.4.28]) by mx1.freebsd.org (Postfix) with ESMTP id B6CF38FC1F for ; Sun, 30 Mar 2008 10:27:36 +0000 (UTC) (envelope-from bms@FreeBSD.org) Received: from compute2.internal (compute2.internal [10.202.2.42]) by out1.messagingengine.com (Postfix) with ESMTP id 31F398F5C6; Sun, 30 Mar 2008 06:27:36 -0400 (EDT) Received: from heartbeat1.messagingengine.com ([10.202.2.160]) by compute2.internal (MEProxy); Sun, 30 Mar 2008 06:27:36 -0400 X-Sasl-enc: ZJu3BOEBgBwARR47VXht+nZ3isCfXG0zoSA/ykcCLCDH 1206872855 Received: from empiric.lon.incunabulum.net (82-35-112-254.cable.ubr07.dals.blueyonder.co.uk [82.35.112.254]) by mail.messagingengine.com (Postfix) with ESMTPSA id A1D4CACEC; Sun, 30 Mar 2008 06:27:35 -0400 (EDT) Message-ID: <47EF6B16.5010107@FreeBSD.org> Date: Sun, 30 Mar 2008 11:27:34 +0100 From: "Bruce M. Simpson" User-Agent: Thunderbird 2.0.0.9 (X11/20080207) MIME-Version: 1.0 To: "Carlos A. M. dos Santos" References: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-stable@freebsd.org Subject: Re: Missing manual pages (e.g. aio_fsync) X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 30 Mar 2008 10:27:36 -0000 Carlos A. M. dos Santos wrote: > Hello, > > It seems that the manual page of aio_fsync is missing, at least in > FreeBSD 7.0-STABLE. I have some questions regarding this: > > 1. Is there somebody working on a man page for aio_fsync? > > 2. Is there a list of missing manual pages? > > 3. What is the current status of POSIX and Unix Specification? Is > there any agreement with IEEE or Open Group allowing to cut-and-paste > from, say, http://www.opengroup.org/onlinepubs/009695399/functions/aio_fsync.html? > The way open source usually works is, it takes longer for someone to write these questions and wait for a response, than it does to just get your sleeves rolled up and run in, guns blazing, and write the man page. Of course then it's easy to waste time doing something someone already did, but that way you get experience doing it, that is after all how open source works. They ain't exactly difficult to write. Doesn't really matter what you do, as long as you do something.... and I myself do well to remember the How It Works(tm) formula from time to time. I believe there is such an agreement but you need to check with others or use the handy CVSweb commit history(tm) for other pages e.g. clock_gettime to check what you can and cannot lift. cheers BMS