Bug 234249

Summary:	rc.conf(5): incorrect sentence parallelism in description of ip6addrctl_policy
Product:	Documentation	Reporter:	David Fiander <david>
Component:	Manual Pages	Assignee:	Chris Rees <crees>
Status:	Closed FIXED
Severity:	Affects Only Me	CC:	crees, doc, rc
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

Description David Fiander 2018-12-21 15:15:26 UTC

The description of the rc.conf variable ip6addrctl_enable contains the only documentation for the variable ip6addrctl_policy (which is another problem, but I'm not going to open a but report for that).

The description of the ip6addrctl_policy says:

If ``ipv4_prefer'' or ``ipv6_prefer'' is specified, ip6addrctl(8) installs a pre-defined policy table described in Section 2.1 (IPv6-preferred) or 10.3 (IPv4-preferred) of RFC 3484.

A strict reading of this suggests that setting ip6addrctl_policy to "ipv4_prefer" will install a "pre-defined policy table described in Section 2.1 (IPv6-preferred)". The second part of this sentence needs to be reversed so that the correct tables correspond to the correct policy values.

Comment 1 Chris Rees freebsd_committer

2018-12-26 20:16:28 UTC

I'll take it.

Comment 2 commit-hook freebsd_committer

2019-09-09 20:48:30 UTC

A commit references this bug:

Author: crees
Date: Mon Sep  9 20:48:12 UTC 2019
New revision: 352107
URL: https://svnweb.freebsd.org/changeset/base/352107

Log:
  Reverse the referenced tables.

  If ipv4_prefer is specified, Section 10.3 is relevant.
  If ipv6_prefer is specified, Section  2.1 is relevant.

  This change makes the corresponding options/sections 'respective'

  PR:		docs/234249
  Submitted by:	David Fiander <david@fiander.info>

Changes:
  head/share/man/man5/rc.conf.5

Comment 3 Chris Rees freebsd_committer

2019-09-09 20:48:39 UTC

Thanks, and I'm sorry this trivial change took so long.