/etc/defaults/rc.conf DHCP omission

[Mason Loring Bliss]

Someone just came into Freenode #freebsd asking how to run DHCP. This led to
a brief search of the docs. We could tell him to say ifconfig_some0="DHCP"
but it wasn't clear where he'd find that on his own.

It turns out that it's crazily far down the rc.conf(5) man page, and it's far
from the first hit if you search for DHCP - in the 10.1-rc2 page it's the
twelth hit, and it shows up deep down in the middle of a section. It's
effectively buried.

Also, /etc/defaults/rc.conf doesn't actually include a DHCP example at all,
although it does have several example entries:

#ifconfig_lo0="inet 127.0.0.1"  # default loopback device configuration.
#ifconfig_lo0_alias0="inet 127.0.0.254 netmask 0xffffffff" # Sample alias entry.
#ifconfig_ed0_ipx="ipx 0x00010010"      # Sample IPX address family entry.
#ifconfig_ed0_ipv6="inet6 2001:db8:1::1 prefixlen 64" # Sample IPv6 addr entry
#ifconfig_ed0_alias0="inet6 2001:db8:2::1 prefixlen 64" # Sample IPv6 alias
#ifconfig_fxp0_name="net0"      # Change interface name from fxp0 to net0.

To reiterate something I'd mentioned in another mail, I think it'd be good
for rc.conf to come pre-stocked with a pointer to /etc/defaults/rc.conf so
new folks know that's there. And to accomodate this situation, it seems like
a DHCP example should be added to the list, above. As a final suggestion, it
seems like /etc/defaults/rc.conf ought to be ordered such that it lists
critical operational items first, networking stuff being a good example of
this.

-- 
Mason Loring Bliss   ((  "In the drowsy dark cave of the mind dreams
mason at blisses.org     ))  build  their nest  with fragments  dropped
http://blisses.org/  ((   from day's caravan." - Rabindranath Tagore