Bug 186797 – Gentoo home-router how to out of date: inexistent option for ppp

• Product: [OLD] Docs on www.gentoo.org
• Status: RESOLVED NEEDINFO

[Description Pablo De Nápoli 2007-07-27 13:33:43 UTC]

It seems to me that the Gentoo home-router how-to documentation
http://www.gentoo.org/doc/en/home-router-howto.xml
is out out date. I've edited my /etc/conf.d/net file as indicated in the "ADSL" section

config_ppp0=( "ppp" )
link_ppp0="eth1"
plugins_ppp0=( "pppoe" )
pppd_ppp0=(
	"defaultroute"
	"usepeerdns"
	There may be other settings you want, see /etc/conf.d/net.example
)
username_ppp0="vla9h924"
password_ppp0="boogie"

and ppp claims there is no such an option as "userpeerdns"

some comments on this:

1) please specify in the documentation for which version of the documented package
things are supposed to work like this (I'm using /net-dialup/ppp-2.4.4-r9/)

2) (I know this is not related to the documentation itself) 
 please do not change the user interfaces to something so critical as the  network subsystem every time.

Users would like to install the system once, and kepp it running through the updates.
If  something do change (as the change from rp-pppoe to pppoe integrated into ppp)
please notify the user, and try to provide a smooth upgrading path.

Reproducible: Couldn't Reproduce

[Comment 1 nm (RETIRED) 2007-07-27 17:47:01 UTC]

"ppp claims there is no such an option as "userpeerdns""

If you put userpeerdns in your config, then this is incorrect; you made a typo of the correct option "usepeerdns". please report back as to what you actually have in the file; right now you're providing conflicting information.

1) version pretty much shouldn't matter

2) you're right, it's not a problem with the documentation, so there's nothing that can be done about it.

[Comment 2 SpanKY 2007-07-28 05:18:36 UTC]

rp-pppoe should still work fine if users had that old stuff running

however, i dont know what you're talking about wrt userpeerdns ... the doc is not out of date and that option works perfectly fine on my ADSL system (baselayout-1.12.9-r2 / ppp-2.4.4-r4)

our documentation always reflects current stable by default and if it requires something newer than stable, it will say so