From eagle@gioria.dyndns.org  Wed Dec 18 15:31:49 2002
Return-Path: <eagle@gioria.dyndns.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 547D237B401; Wed, 18 Dec 2002 15:31:49 -0800 (PST)
Received: from gioria.dyndns.org (AFontenayssB-104-1-1-242.abo.wanadoo.fr [217.128.58.242])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 7D12243EA9; Wed, 18 Dec 2002 15:31:48 -0800 (PST)
	(envelope-from eagle@gioria.dyndns.org)
Received: from bushmills.intra.thorm.net (bushmills.intra.thorm.net [192.168.0.3])
	by gioria.dyndns.org (Postfix) with ESMTP
	id 2068437485; Thu, 19 Dec 2002 00:40:53 +0100 (CET)
Received: by bushmills.intra.thorm.net (Postfix, from userid 501)
	id EF6A2B3DF; Thu, 19 Dec 2002 00:31:53 +0100 (CET)
Message-Id: <20021218233153.EF6A2B3DF@bushmills.intra.thorm.net>
Date: Thu, 19 Dec 2002 00:31:53 +0100 (CET)
From: Sebastien Gioria <gioria@FreeBSD.ORG>
Reply-To: Sebastien Gioria <gioria@FreeBSD.ORG>
To: FreeBSD-gnats-submit@freebsd.org
Cc: alfred@FreeBSD.ORG
Subject: there is no documentation on getosreldate(3)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         46365
>Category:       docs
>Synopsis:       there is no documentation on getosreldate(3)
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Dec 18 15:40:01 PST 2002
>Closed-Date:    Sat Feb 01 19:14:32 PST 2003
>Last-Modified:  Sat Feb 01 19:14:32 PST 2003
>Originator:     Sebastien Gioria
>Release:        FreeBSD 5.0-RC i386
>Organization:
FreeBSD.ORG
>Environment:
System: FreeBSD bushmills.intra.thorm.net 5.0-RC FreeBSD 5.0-RC #16: Mon Dec 9 18:34:49 CET 2002 gioria@FreeBSD.ORG@bushmills.intra.thorm.net:/usr/obj/usr/src/sys/bushmills i386
>Description:
	The getosreldate(3) function is not documented in the manual pages
>How-To-Repeat:
	do a man getosreldate
>Fix:
	This is a roff file documenting the getosreldate function

--- getosreldate.3 begins here ---
.\" Copyright (c) 2002
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd May 28, 2002
.Dt GETOSRELDATE 3
.Os
.Sh NAME
.Nm getosreldate
.Nd get the value of __FreeBSD_Version
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In osreldate.h
.Ft int
.Fn getosreldate void
.Sh DESCRIPTION
.Fn getosreldate
return a 32-bit integer who determine the version of FreeBSD that
a program was compiled on, and maybe running on (if 2.0 or better).
Definitions of the values can be found on the porters handbook
at http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/freebsd-versions.html
.Sh HISTORY
The
.Fn getosreldate
appeared in
.Fx 2.0.
--- getosreldate.3 ends here ---


>Release-Note:
>Audit-Trail:

From: Sebastien Gioria <gioria@FreeBSD.ORG>
To: FreeBSD-gnats-submit@FreeBSD.ORG, freebsd-doc@FreeBSD.org
Cc: Sebastien Gioria <gioria@FreeBSD.ORG>, alfred@FreeBSD.ORG
Subject: Re: docs/46365: there is no documentation on getosreldate(3)
Date: Thu, 19 Dec 2002 00:43:40 +0100

 --r5Pyd7+fXNt84Ff3
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Oups..... did not include the good man page....
 
 
 -- 
 Sebastien Gioria(48.8147,2.3622)   gioria@{FreeBSD,FreeBSD-FR}.ORG
 French FreeBSD User Group    	         http://www.FreeBSD-FR.ORG
 FreeBSD committer			    http://www.FreeBSD.ORG
 *-> FreeBSD + RollerBlade + Scuba Diving; What need you more ? <-*
 
 --r5Pyd7+fXNt84Ff3
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="getosreldate.3"
 
 .\" Copyright (c) 2002
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. All advertising materials mentioning features or use of this software
 .\"    must display the following acknowledgement:
 .\"	This product includes software developed by the University of
 .\"	California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd May 28, 2002
 .Dt GETOSRELDATE 3
 .Os
 .Sh NAME
 .Nm getosreldate
 .Nd get the value of __FreeBSD_version
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In osreldate.h
 .Ft int
 .Fn getosreldate void
 .Sh DESCRIPTION
 .Fn getosreldate
 return a 32-bit integer who determine the version of FreeBSD that
 a program was compiled on, and maybe running on (if 2.0 or better).
 Definitions of the values can be found on the porters handbook
 at http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/freebsd-versions.html
 .Sh EXAMPLES
 An example can be found in /usr/share/examples/FreeBSD_version
 .Sh HISTORY
 The
 .Fn getosreldate
 appeared in
 .Fx 2.0.
 
 --r5Pyd7+fXNt84Ff3--

From: Giorgos Keramidas <keramida@freebsd.org>
To: Sebastien Gioria <gioria@freebsd.org>
Cc: bug-followup@freebsd.org, alfred@freebsd.org
Subject: Re: docs/46365: there is no documentation on getosreldate(3)
Date: Thu, 19 Dec 2002 17:16:53 +0200

 On 2002-12-19 00:43, Sebastien Gioria <gioria@FreeBSD.ORG> wrote:
 
 > .Sh DESCRIPTION
 > .Fn getosreldate
 
 > .Sh HISTORY
 > The
 > .Fn getosreldate
 > appeared in
 > .Fx 2.0.
 
 You don't need to include the function name after .Fn here.
 These two are probably better if written as:
 
 	The
 	.Fn
 	function...
 
 > at http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/freebsd-versions.html
 > .Sh EXAMPLES
 > An example can be found in /usr/share/examples/FreeBSD_version
 
 	An example can be found in
 	.Pa /usr/share/examples/FreeBSD_version .
 
 Paths look nicer if marker up with .Pa in output formats that can use
 many fonts.  I'm not sure if the URL can be marked up with .Pa too,
 but Ruslan will probably know better.
 

From: Sebastien Gioria <gioria@FreeBSD.ORG>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/46365: there is no documentation on getosreldate(3)
Date: Thu, 2 Jan 2003 21:42:12 +0100

 This is a multi-part message in MIME format.
 
 --Multipart_Thu__2_Jan_2003_21:42:12_+0100_0819d000
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: 7bit
 
 On Thu, 19 Dec 2002 17:16:53 +0200 the keyboard of Giorgos Keramidas <keramida@freebsd.org> wrote:
 
 > On 2002-12-19 00:43, Sebastien Gioria <gioria@FreeBSD.ORG> wrote:
 > 
 > > .Sh DESCRIPTION
 > > .Fn getosreldate
 > 
 > > .Sh HISTORY
 > > The
 > > .Fn getosreldate
 > > appeared in
 > > .Fx 2.0.
 > 
 > You don't need to include the function name after .Fn here.
 > These two are probably better if written as:
 > 
 > 	The
 > 	.Fn
 > 	function...
 > 
 > > at http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/freebsd-versions.html
 > > .Sh EXAMPLES
 > > An example can be found in /usr/share/examples/FreeBSD_version
 > 
 > 	An example can be found in
 > 	.Pa /usr/share/examples/FreeBSD_version .
 > 
 > Paths look nicer if marker up with .Pa in output formats that can use
 > many fonts.  I'm not sure if the URL can be marked up with .Pa too,
 > but Ruslan will probably know better.
 
 After your remarks, the man page look like this 
 
 This seem to have some probleme doing just 
 .Fn
 function... . 
 
 So you mustdo 
 
 .Fn nameofyourfunction
 
 
 -- 
 Sebastien Gioria(48.8147,2.3622)   gioria@{FreeBSD,FreeBSD-FR}.ORG
 French FreeBSD User Group    	         http://www.FreeBSD-FR.ORG
 FreeBSD committer			    http://www.FreeBSD.ORG
 *-> FreeBSD + RollerBlade + Scuba Diving; What need you more ? <-*
 
 --Multipart_Thu__2_Jan_2003_21:42:12_+0100_0819d000
 Content-Type: application/octet-stream;
  name="getosreldate.3"
 Content-Disposition: attachment;
  filename="getosreldate.3"
 Content-Transfer-Encoding: base64
 
 LlwiIENvcHlyaWdodCAoYykgMjAwMgouXCIJVGhlIFJlZ2VudHMgb2YgdGhlIFVuaXZlcnNpdHkg
 b2YgQ2FsaWZvcm5pYS4gIEFsbCByaWdodHMgcmVzZXJ2ZWQuCi5cIgouXCIgUmVkaXN0cmlidXRp
 b24gYW5kIHVzZSBpbiBzb3VyY2UgYW5kIGJpbmFyeSBmb3Jtcywgd2l0aCBvciB3aXRob3V0Ci5c
 IiBtb2RpZmljYXRpb24sIGFyZSBwZXJtaXR0ZWQgcHJvdmlkZWQgdGhhdCB0aGUgZm9sbG93aW5n
 IGNvbmRpdGlvbnMKLlwiIGFyZSBtZXQ6Ci5cIiAxLiBSZWRpc3RyaWJ1dGlvbnMgb2Ygc291cmNl
 IGNvZGUgbXVzdCByZXRhaW4gdGhlIGFib3ZlIGNvcHlyaWdodAouXCIgICAgbm90aWNlLCB0aGlz
 IGxpc3Qgb2YgY29uZGl0aW9ucyBhbmQgdGhlIGZvbGxvd2luZyBkaXNjbGFpbWVyLgouXCIgMi4g
 UmVkaXN0cmlidXRpb25zIGluIGJpbmFyeSBmb3JtIG11c3QgcmVwcm9kdWNlIHRoZSBhYm92ZSBj
 b3B5cmlnaHQKLlwiICAgIG5vdGljZSwgdGhpcyBsaXN0IG9mIGNvbmRpdGlvbnMgYW5kIHRoZSBm
 b2xsb3dpbmcgZGlzY2xhaW1lciBpbiB0aGUKLlwiICAgIGRvY3VtZW50YXRpb24gYW5kL29yIG90
 aGVyIG1hdGVyaWFscyBwcm92aWRlZCB3aXRoIHRoZSBkaXN0cmlidXRpb24uCi5cIiAzLiBBbGwg
 YWR2ZXJ0aXNpbmcgbWF0ZXJpYWxzIG1lbnRpb25pbmcgZmVhdHVyZXMgb3IgdXNlIG9mIHRoaXMg
 c29mdHdhcmUKLlwiICAgIG11c3QgZGlzcGxheSB0aGUgZm9sbG93aW5nIGFja25vd2xlZGdlbWVu
 dDoKLlwiCVRoaXMgcHJvZHVjdCBpbmNsdWRlcyBzb2Z0d2FyZSBkZXZlbG9wZWQgYnkgdGhlIFVu
 aXZlcnNpdHkgb2YKLlwiCUNhbGlmb3JuaWEsIEJlcmtlbGV5IGFuZCBpdHMgY29udHJpYnV0b3Jz
 LgouXCIgNC4gTmVpdGhlciB0aGUgbmFtZSBvZiB0aGUgVW5pdmVyc2l0eSBub3IgdGhlIG5hbWVz
 IG9mIGl0cyBjb250cmlidXRvcnMKLlwiICAgIG1heSBiZSB1c2VkIHRvIGVuZG9yc2Ugb3IgcHJv
 bW90ZSBwcm9kdWN0cyBkZXJpdmVkIGZyb20gdGhpcyBzb2Z0d2FyZQouXCIgICAgd2l0aG91dCBz
 cGVjaWZpYyBwcmlvciB3cml0dGVuIHBlcm1pc3Npb24uCi5cIgouXCIgVEhJUyBTT0ZUV0FSRSBJ
 UyBQUk9WSURFRCBCWSBUSEUgUkVHRU5UUyBBTkQgQ09OVFJJQlVUT1JTIGBgQVMgSVMnJyBBTkQK
 LlwiIEFOWSBFWFBSRVNTIE9SIElNUExJRUQgV0FSUkFOVElFUywgSU5DTFVESU5HLCBCVVQgTk9U
 IExJTUlURUQgVE8sIFRIRQouXCIgSU1QTElFRCBXQVJSQU5USUVTIE9GIE1FUkNIQU5UQUJJTElU
 WSBBTkQgRklUTkVTUyBGT1IgQSBQQVJUSUNVTEFSIFBVUlBPU0UKLlwiIEFSRSBESVNDTEFJTUVE
 LiAgSU4gTk8gRVZFTlQgU0hBTEwgVEhFIFJFR0VOVFMgT1IgQ09OVFJJQlVUT1JTIEJFIExJQUJM
 RQouXCIgRk9SIEFOWSBESVJFQ1QsIElORElSRUNULCBJTkNJREVOVEFMLCBTUEVDSUFMLCBFWEVN
 UExBUlksIE9SIENPTlNFUVVFTlRJQUwKLlwiIERBTUFHRVMgKElOQ0xVRElORywgQlVUIE5PVCBM
 SU1JVEVEIFRPLCBQUk9DVVJFTUVOVCBPRiBTVUJTVElUVVRFIEdPT0RTCi5cIiBPUiBTRVJWSUNF
 UzsgTE9TUyBPRiBVU0UsIERBVEEsIE9SIFBST0ZJVFM7IE9SIEJVU0lORVNTIElOVEVSUlVQVElP
 TikKLlwiIEhPV0VWRVIgQ0FVU0VEIEFORCBPTiBBTlkgVEhFT1JZIE9GIExJQUJJTElUWSwgV0hF
 VEhFUiBJTiBDT05UUkFDVCwgU1RSSUNUCi5cIiBMSUFCSUxJVFksIE9SIFRPUlQgKElOQ0xVRElO
 RyBORUdMSUdFTkNFIE9SIE9USEVSV0lTRSkgQVJJU0lORyBJTiBBTlkgV0FZCi5cIiBPVVQgT0Yg
 VEhFIFVTRSBPRiBUSElTIFNPRlRXQVJFLCBFVkVOIElGIEFEVklTRUQgT0YgVEhFIFBPU1NJQklM
 SVRZIE9GCi5cIiBTVUNIIERBTUFHRS4KLlwiCi5cIiAkRnJlZUJTRCQKLlwiCi5EZCBNYXkgMjgs
 IDIwMDIKLkR0IEdFVE9TUkVMREFURSAzCi5PcwouU2ggTkFNRQouTm0gZ2V0b3NyZWxkYXRlCi5O
 ZCBnZXQgdGhlIHZhbHVlIG9mIF9fRnJlZUJTRF92ZXJzaW9uCi5TaCBMSUJSQVJZCi5MYiBsaWJj
 Ci5TaCBTWU5PUFNJUwouSW4gb3NyZWxkYXRlLmgKLkZ0IGludAouRm4gZ2V0b3NyZWxkYXRlIHZv
 aWQKLlNoIERFU0NSSVBUSU9OCi5GbiBnZXRvc3JlbGRhdGUgCnJldHVybiBhIDMyLWJpdCBpbnRl
 Z2VyIHdobyBkZXRlcm1pbmUgdGhlIHZlcnNpb24gb2YgRnJlZUJTRCB0aGF0IGEgcHJvZ3JhbSAK
 d2FzIGNvbXBpbGVkIG9uLCBhbmQgbWF5YmUgcnVubmluZyBvbiAoaWYgMi4wIG9yIGJldHRlciku
 IERlZmluaXRpb25zIG9mIHRoZSAKdmFsdWVzIGNhbiBiZSBmb3VuZCBvbiB0aGUgcG9ydGVycyBo
 YW5kYm9vayBhdCAKaHR0cDovL3d3dy5mcmVlYnNkLm9yZy9kb2MvZW5fVVMuSVNPODg1OS0xL2Jv
 b2tzL3BvcnRlcnMtaGFuZGJvb2svZnJlZWJzZC12ZXJzaW9ucy5odG1sCi5TaCBFWEFNUExFUwog
 QW4gZXhhbXBsZSBjYW4gYmUgZm91bmQgaW4gCi5QYSAvdXNyL3NoYXJlL2V4YW1wbGVzL0ZyZWVC
 U0RfdmVyc2lvbgouU2ggSElTVE9SWQogVGhlCi5GbiBnZXRvc3JlbGRhdGUgYXBwZWFyZWQgaW4K
 LkZ4IDIuMC4K
 
 --Multipart_Thu__2_Jan_2003_21:42:12_+0100_0819d000--
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Thu Jan 30 14:41:38 PST 2003 
State-Changed-Why:  
I've taken the various comments and committed a slightly different version 
of your manual page.  Thanks for doing this! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Thu Jan 30 14:41:38 PST 2003 
Responsible-Changed-Why:  
I've taken the various comments and committed a slightly different version 
of your manual page.  Thanks for doing this! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=46365 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Feb 1 19:14:07 PST 2003 
State-Changed-Why:  
Committed!  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=46365 
>Unformatted:
