[Bug 200501] Clarity improvement in section "31.9.2 Configuring IPv6"

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=200501

            Bug ID: 200501
           Summary: Clarity improvement in section "31.9.2 Configuring
                    IPv6"
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: pablo at pablobm.com

I was recently configuring IPv6 on a FreeBSD, following the Handbook. I found
something that could be made clearer for a novice like me (coming to FreeBSD
from Linux). I hope it makes sense.

In the section 31.9.2 (Configuring IPv6) the configured network device is first
referred to as "em0", but then as "fxp0" immediately after. I understand that
these are shown in italics, denoting a changeable parameter, but I think many
people may be confused by this.

I would suggest phrasing the section slightly differently. For example, the
first paragraph could start by saying "Let's assume that your network device is
named 'em0'". Then the examples further below could refer to 'em0' instead of
'fxp0', maintaining consistency.

I would have provided a patch for the appropriate Docbook source, but after
spending an hour with it, I find myself unable to compile the source :-( Sorry!

-- 
You are receiving this mail because:
You are the assignee for the bug.