Bugzilla Bug 213988

This bug is intended to track any and all documentation changes that need to
happen to successfully land OpenRC into Gentoo. It's also a meta bug for a
migration guide that I would like to write with a member of the docs team. I've
already shot an e-mail off to nightmorph about that.

softlevel= as a kernel parameter will be replaced by rc_runlevel= in OpenRC
0.2.2 and higher

(In reply to comment #1)
> softlevel= as a kernel parameter will be replaced by rc_runlevel= in OpenRC
> 0.2.2 and higher

Will softlevel= still work until some version X (backward compatibility)?

of course

When I said "replaced", I meant in a documentation stand point that we should
be promoting this as a the default parameter to set.

I'm just trying to keep notes on this bug rather then in my head or on a piece
of paper or a file that only I can access. That way, if I miss something.. or I
get something wrong.. someone else can contribute.

We only mention softlevel in two documents:

http://www.gentoo.org/doc/en/power-management-guide.xml, which has two related
open bugs already (bug #205117 and bug #209258) -- this definitely needs some
fixes, which no one's coherently provided thus far.

http://www.gentoo.org/doc/en/handbook/hb-working-rcscripts.xml

Please look through these docs and figure out what needs to be changed to what.
Our documentation will *not* be split into "stable baselayout-1" and "~arch
openrc" bits. I'd prefer to just default all instructions to OpenRC once it's
stable, since it doesn't look like baselayout-1 will be maintained after that
point.

All that being said, we're closer to fixing this tracker bug, as the openrc
migration guide is complete.

The documentation net.example in particular needs to be updated.  Apparently
comments inside /etc/conf.d/net commands foul them up.

Example:

pppd_ppp0="
#       maxfail 0       # WARNING: It's not recommended you use this
#                       # if you don't specify maxfail then we assume 0
#       updetach        # If not set, "/etc/init.d/net.ppp0 start" will return
"

"/etc/init.d/net.ppp0 start" will cause it to not parse properly.

Also could you add documentation on what the syntax is for setting up two phone
numbers for dial up?

#phone_number_ppp0="12345689" # Maximum 2 phone numbers are supported

Used to be: 

phone_number_ppp0=( "12345689 "12345678")


Is it now this?

phone_number_ppp0="'12345689' '12345678'"

or?

phone_number_ppp0="12345689 12345678"

Sorry old style syntax was this:

phone_number_ppp0=( "12345689" "12345678" )

(In reply to comment #6)
> The documentation net.example in particular needs to be updated.

(This is a tracker so being brief.)  Note that the network config is still in
flux.  As the current GMN announcement states, this is ~arch for a reason. 
GMANE link to discussion thread with the details: 

http://thread.gmane.org/gmane.linux.gentoo.devel/55824

Does anyone know where I can find the (official) developer docs for openrc. I'm
trying to find out the purpose of all the directories in /lib/rc/init.d. I'm
not sure about things such as "exclusive", "scheduled", etc.

Not the bug for this..

May be bug 240984 could became addition here. At least part on
"The cold/hotplugging has now been moved into one variable - rc_hotplug"

*** Bug 246119 has been marked as a duplicate of this bug. ***

*** Bug 260761 has been marked as a duplicate of this bug. ***

*** Bug 266785 has been marked as a duplicate of this bug. ***

Not sure wether this is the right place for this (otherwise please point me to
the right place). 

I noticed in the gentoo handbook, the page on configuring your system
(http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=8) still
mentions that rc.conf has the EDITOR and DISPLAYMANAGER variables.

Also, the migration guide mentions to set the EDITOR variable in /etc/env.d
while the comments in /etc/profile suggest setting a system default for this in
/etc/profile.d.