- remove inconsistent/obsolete comments

- update rfc references - make the Rs/Re blocks more consistent
author: jmc <> 2012-08-21 16:35:16 +0000
committer: jmc <> 2012-08-21 16:35:16 +0000
commit: 10130c12761620d6e028abed0e57c43e84bded29 (patch)
tree: 0f7c667f659c151951f517bed0bf91a386210856 /src/lib
parent: cb428ea1808d4c914382afbfab31a0ed7753f99e (diff)
download: openbsd-10130c12761620d6e028abed0e57c43e84bded29.tar.gz
openbsd-10130c12761620d6e028abed0e57c43e84bded29.tar.bz2
openbsd-10130c12761620d6e028abed0e57c43e84bded29.zip
4 files changed, 35 insertions, 48 deletions
diff --git a/src/lib/libc/net/inet6_opt_init.3 b/src/lib/libc/net/inet6_opt_init.3
index 21880a6382..644f984e09 100644
--- a/src/lib/libc/net/inet6_opt_init.3
+++ b/src/lib/libc/net/inet6_opt_init.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: inet6_opt_init.3,v 1.3 2007/05/31 19:19:30 jmc Exp $
+.\"     $OpenBSD: inet6_opt_init.3,v 1.4 2012/08/21 16:35:16 jmc Exp $
 .\"     $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 21 2012 $
 .Dt INET6_OPT_INIT 3
 .Os
 .\"
@@ -65,13 +65,6 @@ complicated.
 The advanced sockets API defines a set of functions to
 help applications create and manipulate Hop-by-Hop and Destination
 options.
-.\"This man page describes the functions specified in
-.\"IETF Draft RFC 3542 while the
-.\".Xr inet6_options_space 3
-.\"man page documents the functions defined in RFC 2292.
-.\"It is expected
-.\"that this set of functions will supersede those in RFC 2292 but for
-.\"the time being both APIs are retained.
 These functions use the
 formatting rules specified in Appendix B in RFC 2460, i.e. that the
 largest field is placed last in the option.
@@ -314,20 +307,20 @@ on an error.
 .\"
 .Sh SEE ALSO
 .Rs
+.%A S. Deering
+.%A R. Hinden
+.%D December 1998
+.%R RFC 2460
+.%T Internet Protocol, Version 6 (IPv6) Specification
+.Re
+.Rs
 .%A W. Stevens
 .%A M. Thomas
 .%A E. Nordmark
 .%A T. Jinmei
-.%T "Advanced Sockets API for IPv6"
+.%D May 2003
-.%N RFC 3542
+.%R RFC 3542
-.%D October 2002
+.%T Advanced Sockets Application Program Interface (API) for IPv6
-.Re
-.Rs
-.%A S. Deering
-.%A R. Hinden
-.%T "Internet Protocol, Version 6 (IPv6) Specification"
-.%N RFC 2460
-.%D December 1998
 .Re
 .Sh STANDARDS
 The functions are documented in
diff --git a/src/lib/libc/net/inet6_option_space.3 b/src/lib/libc/net/inet6_option_space.3
index 8aa79a6d0b..9eab87f225 100644
--- a/src/lib/libc/net/inet6_option_space.3
+++ b/src/lib/libc/net/inet6_option_space.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: inet6_option_space.3,v 1.21 2007/05/31 19:19:30 jmc Exp $
+.\"     $OpenBSD: inet6_option_space.3,v 1.22 2012/08/21 16:35:16 jmc Exp $
 .\"     $KAME: inet6_option_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 21 2012 $
 .Dt INET6_OPTION_SPACE 3
 .Os
 .\"
@@ -422,16 +422,16 @@ value.
 .Rs
 .%A W. Stevens
 .%A M. Thomas
-.%T "Advanced Sockets API for IPv6"
-.%N RFC 2292
 .%D February 1998
+.%R RFC 2292
+.%T Advanced Sockets API for IPv6
 .Re
 .Rs
 .%A S. Deering
 .%A R. Hinden
-.%T "Internet Protocol, Version 6 (IPv6) Specification"
-.%N RFC 2460
 .%D December 1998
+.%R RFC 2460
+.%T Internet Protocol, Version 6 (IPv6) Specification
 .Re
 .\"
 .Sh STANDARDS
diff --git a/src/lib/libc/net/inet6_rth_space.3 b/src/lib/libc/net/inet6_rth_space.3
index 326521def7..fdd9e67c2d 100644
--- a/src/lib/libc/net/inet6_rth_space.3
+++ b/src/lib/libc/net/inet6_rth_space.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: inet6_rth_space.3,v 1.3 2007/05/31 19:19:30 jmc Exp $
+.\"     $OpenBSD: inet6_rth_space.3,v 1.4 2012/08/21 16:35:16 jmc Exp $
 .\"     $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 21 2012 $
 .Dt INET6_RTH_SPACE 3
 .Os
 .\"
@@ -200,20 +200,20 @@ functions return 0 on success, or \-1 upon an error.
 .\"
 .Sh SEE ALSO
 .Rs
+.%A S. Deering
+.%A R. Hinden
+.%D December 1998
+.%R RFC 2460
+.%T Internet Protocol, Version 6 (IPv6) Specification
+.Re
+.Rs
 .%A W. Stevens
 .%A M. Thomas
 .%A E. Nordmark
 .%A T. Jinmei
-.%T "Advanced Sockets API for IPv6"
-.%N RFC 3542
 .%D May 2003
-.Re
+.%R RFC 3542
-.Rs
+.%T Advanced Sockets Application Programming Interface (API) for IPv6
-.%A S. Deering
-.%A R. Hinden
-.%T "Internet Protocol, Version 6 (IPv6) Specification"
-.%N RFC 2460
-.%D December 1998
 .Re
 .Sh HISTORY
 The implementation first appeared in KAME advanced networking kit.
diff --git a/src/lib/libc/net/inet6_rthdr_space.3 b/src/lib/libc/net/inet6_rthdr_space.3
index 3287bfe009..f3b8edd7ba 100644
--- a/src/lib/libc/net/inet6_rthdr_space.3
+++ b/src/lib/libc/net/inet6_rthdr_space.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: inet6_rthdr_space.3,v 1.20 2007/05/31 19:19:30 jmc Exp $
+.\"     $OpenBSD: inet6_rthdr_space.3,v 1.21 2012/08/21 16:35:16 jmc Exp $
 .\"     $KAME: inet6_rthdr_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 21 2012 $
 .Dt INET6_RTHDR_SPACE 3
 .Os
 .\"
@@ -64,12 +64,6 @@
 .Fn inet6_rthdr_getflags "const struct cmsghdr *cmsg" "int index"
 .\"
 .Sh DESCRIPTION
-.\"The RFC 2292 IPv6 Advanced API has been deprecated in favor of the
-.\"newer, RFC 3542 APIs.
-.\"On platforms that support it, currently only
-.\"FreeBSD, please use the newer API to manipulate routing header
-.\"options.
-.\".Pp
 Note:
 RFC 2292 has been superseded by RFC 3542.
 The use of functions described in this page is deprecated.
@@ -288,16 +282,16 @@ functions return \-1 on error.
 .Rs
 .%A W. Stevens
 .%A M. Thomas
-.%T "Advanced Sockets API for IPv6"
-.%N RFC 2292
 .%D February 1998
+.%R RFC 2292
+.%T Advanced Sockets API for IPv6
 .Re
 .Rs
 .%A S. Deering
 .%A R. Hinden
-.%T "Internet Protocol, Version 6 (IPv6) Specification"
-.%N RFC 2460
 .%D December 1998
+.%R RFC 2460
+.%T Internet Protocol, Version 6 (IPv6) Specification
 .Re
 .\"
 .Sh HISTORY
author	jmc <>	2012-08-21 16:35:16 +0000
committer	jmc <>	2012-08-21 16:35:16 +0000
commit	10130c12761620d6e028abed0e57c43e84bded29 (patch)
tree	0f7c667f659c151951f517bed0bf91a386210856 /src/lib
parent	cb428ea1808d4c914382afbfab31a0ed7753f99e (diff)
download	openbsd-10130c12761620d6e028abed0e57c43e84bded29.tar.gz openbsd-10130c12761620d6e028abed0e57c43e84bded29.tar.bz2 openbsd-10130c12761620d6e028abed0e57c43e84bded29.zip

diff --git a/src/lib/libc/net/inet6_opt_init.3 b/src/lib/libc/net/inet6_opt_init.3 index 21880a6382..644f984e09 100644 --- a/src/lib/libc/net/inet6_opt_init.3 +++ b/src/lib/libc/net/inet6_opt_init.3
@@ -1,4 +1,4 @@
1	.\" $OpenBSD: inet6_opt_init.3,v 1.3 2007/05/31 19:19:30 jmc Exp $	1	.\" $OpenBSD: inet6_opt_init.3,v 1.4 2012/08/21 16:35:16 jmc Exp $
2	.\" $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $	2	.\" $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $
3	.\"	3	.\"
4	.\" Copyright (C) 2004 WIDE Project.	4	.\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF	28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29	.\" SUCH DAMAGE.	29	.\" SUCH DAMAGE.
30	.\"	30	.\"
31	.Dd $Mdocdate: May 31 2007 $	31	.Dd $Mdocdate: August 21 2012 $
32	.Dt INET6_OPT_INIT 3	32	.Dt INET6_OPT_INIT 3
33	.Os	33	.Os
34	.\"	34	.\"
@@ -65,13 +65,6 @@ complicated.
65	The advanced sockets API defines a set of functions to	65	The advanced sockets API defines a set of functions to
66	help applications create and manipulate Hop-by-Hop and Destination	66	help applications create and manipulate Hop-by-Hop and Destination
67	options.	67	options.
68	.\"This man page describes the functions specified in
69	.\"IETF Draft RFC 3542 while the
70	.\".Xr inet6_options_space 3
71	.\"man page documents the functions defined in RFC 2292.
72	.\"It is expected
73	.\"that this set of functions will supersede those in RFC 2292 but for
74	.\"the time being both APIs are retained.
75	These functions use the	68	These functions use the
76	formatting rules specified in Appendix B in RFC 2460, i.e. that the	69	formatting rules specified in Appendix B in RFC 2460, i.e. that the
77	largest field is placed last in the option.	70	largest field is placed last in the option.
@@ -314,20 +307,20 @@ on an error.
314	.\"	307	.\"
315	.Sh SEE ALSO	308	.Sh SEE ALSO
316	.Rs	309	.Rs
		310	.%A S. Deering
		311	.%A R. Hinden
		312	.%D December 1998
		313	.%R RFC 2460
		314	.%T Internet Protocol, Version 6 (IPv6) Specification
		315	.Re
		316	.Rs
317	.%A W. Stevens	317	.%A W. Stevens
318	.%A M. Thomas	318	.%A M. Thomas
319	.%A E. Nordmark	319	.%A E. Nordmark
320	.%A T. Jinmei	320	.%A T. Jinmei
321	.%T "Advanced Sockets API for IPv6"	321	.%D May 2003
322	.%N RFC 3542	322	.%R RFC 3542
323	.%D October 2002	323	.%T Advanced Sockets Application Program Interface (API) for IPv6
324	.Re
325	.Rs
326	.%A S. Deering
327	.%A R. Hinden
328	.%T "Internet Protocol, Version 6 (IPv6) Specification"
329	.%N RFC 2460
330	.%D December 1998
331	.Re	324	.Re
332	.Sh STANDARDS	325	.Sh STANDARDS
333	The functions are documented in	326	The functions are documented in


diff --git a/src/lib/libc/net/inet6_option_space.3 b/src/lib/libc/net/inet6_option_space.3 index 8aa79a6d0b..9eab87f225 100644 --- a/src/lib/libc/net/inet6_option_space.3 +++ b/src/lib/libc/net/inet6_option_space.3
@@ -1,4 +1,4 @@
1	.\" $OpenBSD: inet6_option_space.3,v 1.21 2007/05/31 19:19:30 jmc Exp $	1	.\" $OpenBSD: inet6_option_space.3,v 1.22 2012/08/21 16:35:16 jmc Exp $
2	.\" $KAME: inet6_option_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $	2	.\" $KAME: inet6_option_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
3	.\"	3	.\"
4	.\" Copyright (C) 2004 WIDE Project.	4	.\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF	28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29	.\" SUCH DAMAGE.	29	.\" SUCH DAMAGE.
30	.\"	30	.\"
31	.Dd $Mdocdate: May 31 2007 $	31	.Dd $Mdocdate: August 21 2012 $
32	.Dt INET6_OPTION_SPACE 3	32	.Dt INET6_OPTION_SPACE 3
33	.Os	33	.Os
34	.\"	34	.\"
@@ -422,16 +422,16 @@ value.
422	.Rs	422	.Rs
423	.%A W. Stevens	423	.%A W. Stevens
424	.%A M. Thomas	424	.%A M. Thomas
425	.%T "Advanced Sockets API for IPv6"
426	.%N RFC 2292
427	.%D February 1998	425	.%D February 1998
		426	.%R RFC 2292
		427	.%T Advanced Sockets API for IPv6
428	.Re	428	.Re
429	.Rs	429	.Rs
430	.%A S. Deering	430	.%A S. Deering
431	.%A R. Hinden	431	.%A R. Hinden
432	.%T "Internet Protocol, Version 6 (IPv6) Specification"
433	.%N RFC 2460
434	.%D December 1998	432	.%D December 1998
		433	.%R RFC 2460
		434	.%T Internet Protocol, Version 6 (IPv6) Specification
435	.Re	435	.Re
436	.\"	436	.\"
437	.Sh STANDARDS	437	.Sh STANDARDS


diff --git a/src/lib/libc/net/inet6_rth_space.3 b/src/lib/libc/net/inet6_rth_space.3 index 326521def7..fdd9e67c2d 100644 --- a/src/lib/libc/net/inet6_rth_space.3 +++ b/src/lib/libc/net/inet6_rth_space.3
@@ -1,4 +1,4 @@
1	.\" $OpenBSD: inet6_rth_space.3,v 1.3 2007/05/31 19:19:30 jmc Exp $	1	.\" $OpenBSD: inet6_rth_space.3,v 1.4 2012/08/21 16:35:16 jmc Exp $
2	.\" $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $	2	.\" $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $
3	.\"	3	.\"
4	.\" Copyright (C) 2004 WIDE Project.	4	.\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF	28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29	.\" SUCH DAMAGE.	29	.\" SUCH DAMAGE.
30	.\"	30	.\"
31	.Dd $Mdocdate: May 31 2007 $	31	.Dd $Mdocdate: August 21 2012 $
32	.Dt INET6_RTH_SPACE 3	32	.Dt INET6_RTH_SPACE 3
33	.Os	33	.Os
34	.\"	34	.\"
@@ -200,20 +200,20 @@ functions return 0 on success, or \-1 upon an error.
200	.\"	200	.\"
201	.Sh SEE ALSO	201	.Sh SEE ALSO
202	.Rs	202	.Rs
		203	.%A S. Deering
		204	.%A R. Hinden
		205	.%D December 1998
		206	.%R RFC 2460
		207	.%T Internet Protocol, Version 6 (IPv6) Specification
		208	.Re
		209	.Rs
203	.%A W. Stevens	210	.%A W. Stevens
204	.%A M. Thomas	211	.%A M. Thomas
205	.%A E. Nordmark	212	.%A E. Nordmark
206	.%A T. Jinmei	213	.%A T. Jinmei
207	.%T "Advanced Sockets API for IPv6"
208	.%N RFC 3542
209	.%D May 2003	214	.%D May 2003
210	.Re	215	.%R RFC 3542
211	.Rs	216	.%T Advanced Sockets Application Programming Interface (API) for IPv6
212	.%A S. Deering
213	.%A R. Hinden
214	.%T "Internet Protocol, Version 6 (IPv6) Specification"
215	.%N RFC 2460
216	.%D December 1998
217	.Re	217	.Re
218	.Sh HISTORY	218	.Sh HISTORY
219	The implementation first appeared in KAME advanced networking kit.	219	The implementation first appeared in KAME advanced networking kit.


diff --git a/src/lib/libc/net/inet6_rthdr_space.3 b/src/lib/libc/net/inet6_rthdr_space.3 index 3287bfe009..f3b8edd7ba 100644 --- a/src/lib/libc/net/inet6_rthdr_space.3 +++ b/src/lib/libc/net/inet6_rthdr_space.3
@@ -1,4 +1,4 @@
1	.\" $OpenBSD: inet6_rthdr_space.3,v 1.20 2007/05/31 19:19:30 jmc Exp $	1	.\" $OpenBSD: inet6_rthdr_space.3,v 1.21 2012/08/21 16:35:16 jmc Exp $
2	.\" $KAME: inet6_rthdr_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $	2	.\" $KAME: inet6_rthdr_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
3	.\"	3	.\"
4	.\" Copyright (C) 2004 WIDE Project.	4	.\" Copyright (C) 2004 WIDE Project.
@@ -28,7 +28,7 @@
28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF	28	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29	.\" SUCH DAMAGE.	29	.\" SUCH DAMAGE.
30	.\"	30	.\"
31	.Dd $Mdocdate: May 31 2007 $	31	.Dd $Mdocdate: August 21 2012 $
32	.Dt INET6_RTHDR_SPACE 3	32	.Dt INET6_RTHDR_SPACE 3
33	.Os	33	.Os
34	.\"	34	.\"
@@ -64,12 +64,6 @@
64	.Fn inet6_rthdr_getflags "const struct cmsghdr *cmsg" "int index"	64	.Fn inet6_rthdr_getflags "const struct cmsghdr *cmsg" "int index"
65	.\"	65	.\"
66	.Sh DESCRIPTION	66	.Sh DESCRIPTION
67	.\"The RFC 2292 IPv6 Advanced API has been deprecated in favor of the
68	.\"newer, RFC 3542 APIs.
69	.\"On platforms that support it, currently only
70	.\"FreeBSD, please use the newer API to manipulate routing header
71	.\"options.
72	.\".Pp
73	Note:	67	Note:
74	RFC 2292 has been superseded by RFC 3542.	68	RFC 2292 has been superseded by RFC 3542.
75	The use of functions described in this page is deprecated.	69	The use of functions described in this page is deprecated.
@@ -288,16 +282,16 @@ functions return \-1 on error.
288	.Rs	282	.Rs
289	.%A W. Stevens	283	.%A W. Stevens
290	.%A M. Thomas	284	.%A M. Thomas
291	.%T "Advanced Sockets API for IPv6"
292	.%N RFC 2292
293	.%D February 1998	285	.%D February 1998
		286	.%R RFC 2292
		287	.%T Advanced Sockets API for IPv6
294	.Re	288	.Re
295	.Rs	289	.Rs
296	.%A S. Deering	290	.%A S. Deering
297	.%A R. Hinden	291	.%A R. Hinden
298	.%T "Internet Protocol, Version 6 (IPv6) Specification"
299	.%N RFC 2460
300	.%D December 1998	292	.%D December 1998
		293	.%R RFC 2460
		294	.%T Internet Protocol, Version 6 (IPv6) Specification
301	.Re	295	.Re
302	.\"	296	.\"
303	.Sh HISTORY	297	.Sh HISTORY