From mandree@FreeBSD.org  Wed May 11 09:40:22 2011
Return-Path: <mandree@FreeBSD.org>
Received: from apollo.emma.line.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28])
	by hub.freebsd.org (Postfix) with ESMTP id EA607106564A
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 11 May 2011 09:40:21 +0000 (UTC)
	(envelope-from mandree@FreeBSD.org)
Received: from mandree by apollo.emma.line.org with local (Exim 4.75 (FreeBSD))
	(envelope-from <mandree@FreeBSD.org>)
	id 1QK5u1-000C5U-0o
	for FreeBSD-gnats-submit@freebsd.org; Wed, 11 May 2011 11:40:21 +0200
Message-Id: <E1QK5u1-000C5U-0o@apollo.emma.line.org>
Date: Wed, 11 May 2011 11:40:21 +0200
From: Matthias Andree <mandree@FreeBSD.org>
Reply-To: Matthias Andree <mandree@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: share/man/man2/setsockopt.2 
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         156955
>Category:       docs
>Synopsis:       bug in share/man/man2/setsockopt.2
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 11 09:50:08 UTC 2011
>Closed-Date:    Thu Nov 01 19:19:55 UTC 2012
>Last-Modified:  Thu Nov 01 19:19:55 UTC 2012
>Originator:     Matthias Andree
>Release:        FreeBSD 8.2-RELEASE amd64
>Organization:
>Environment:
System: FreeBSD apollo.emma.line.org 8.2-RELEASE FreeBSD 8.2-RELEASE #65: Fri Feb 25 01:47:50 CET 2011 toor@apollo.emma.line.org:/usr/obj/usr/src/sys/GENERIC amd64


	
>Description:
SO_KEEPALIVE (at least on 8.2-RELEASE) should be given a separate paragraph,
it currently runs into the previous one.
	
>How-To-Repeat:
	
>Fix:

	


>Release-Note:
>Audit-Trail:

From: Benedict Reuschling <bcr@FreeBSD.org>
To: bug-followup@FreeBSD.org, mandree@FreeBSD.org
Cc:  
Subject: Re: docs/156955: bug in share/man/man2/setsockopt.2
Date: Fri, 27 May 2011 16:24:56 +0200

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Is this still an issue? The man page looks fine on the two systems I
 checked. The SO_KEEPALIVE text is on its own line. The file in question
 is lib/libc/sys/getsockopt.2 and has the correct formatting as far as I
 can see.
 
 Benedict Reuschling
 FreeBSD Doc Committer
 
 The FreeBSD Documentation Project
 FreeBSD German Documentation Project - https://doc.bsdgroup.de
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.8 (Darwin)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAk3ftDIACgkQTSZQLkqBk0iBWACfZcm71wOuahNBcE2WMqZp35Ta
 7y0AniPh8VTFTvxvd9dtIEWzmCLa0hJC
 =0zGA
 -----END PGP SIGNATURE-----

From: Matthias Andree <mandree@FreeBSD.org>
To: bcr@FreeBSD.org
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/156955: bug in share/man/man2/setsockopt.2
Date: Fri, 27 May 2011 17:41:29 +0200

 Am 27.05.2011 16:24, schrieb Benedict Reuschling:
 > Is this still an issue? The man page looks fine on the two systems I
 > checked. The SO_KEEPALIVE text is on its own line. The file in question
 > is lib/libc/sys/getsockopt.2 and has the correct formatting as far as I
 > can see.
 > 
 > Benedict Reuschling
 > FreeBSD Doc Committer
 > 
 > The FreeBSD Documentation Project
 > FreeBSD German Documentation Project - https://doc.bsdgroup.de
 
 Yup, still broken on RELENG_8:
 
 ...
 SO_DEBUG enables debugging in the underlying protocol modules.
 SO_REUSEADDR indicates that the rules used in validating addresses sup-
 plied in a bind(2) system call should allow reuse of local addresses.
 SO_REUSEPORT allows completely duplicate bindings by multiple processes
 if they all set SO_REUSEPORT before binding the port.  This option per-
 mits multiple instances of a program to each receive UDP/IP multicast or
 broadcast datagrams destined for the bound port.  SO_KEEPALIVE enables
 the periodic transmission of messages on a connected socket.  Should the
 connected party fail to respond to these messages, the connection is con-
 sidered broken and processes using the socket are notified via a SIGPIPE
 signal when attempting to send data.  SO_DONTROUTE indicates that outgo-
 ing messages should bypass the standard routing facilities.  Instead,
 messages are directed to the appropriate network interface according to
 the network portion of the destination address.
 ...
 
 So missing paragraphs befrore SO_REUSEPORT, SO_KEEPALIVE, SO_DONTROUTE,
 SO_RCVTIMEO, possibly more.

From: Matthias Andree <mandree@FreeBSD.org>
To: bcr@FreeBSD.org
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/156955: bug in share/man/man2/setsockopt.2
Date: Fri, 27 May 2011 17:45:50 +0200

 Am 27.05.2011 16:24, schrieb Benedict Reuschling:
 > Is this still an issue? The man page looks fine on the two systems I
 > checked. The SO_KEEPALIVE text is on its own line. The file in question
 > is lib/libc/sys/getsockopt.2 and has the correct formatting as far as I
 > can see.
 
 Source-level view, looking at /usr/src/lib/libc/sys/getsockopt.2:
 
 Lots of .Dv SO_MUMBLE options, few with a precding .Pp.  I'm not talking
 about the listing, but about the run-down text further down.

From: Maxim Konovalov <maxim.konovalov@gmail.com>
To: bug-followup@freebsd.org
Cc:  
Subject: docs/156955
Date: Tue, 26 Jul 2011 19:07:24 +0400 (MSD)

 Hello,
 
 It seems for me you are looking at the different trees.
 
 The issue is definitly fixed in HEAD with r215178 but the formatting
 is still broken in stable/8.
 
 -- 
 Maxim Konovalov
State-Changed-From-To: open->patched 
State-Changed-By: eadler 
State-Changed-When: Thu Feb 23 02:51:32 UTC 2012 
State-Changed-Why:  
fixed in HEAD; needs to be MFCed. which commit tbd 

http://www.freebsd.org/cgi/query-pr.cgi?pr=156955 
State-Changed-From-To: patched->closed 
State-Changed-By: eadler 
State-Changed-When: Thu Nov 1 19:19:55 UTC 2012 
State-Changed-Why:  
MFCed some time ago 

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