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
"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.
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