Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 15 Sep 2005 19:23:13 -0400
From:      Tom Rhodes <trhodes@FreeBSD.org>
To:        garys@opusnet.com (Gary W. Swearingen)
Cc:        FreeBSD-doc@FreeBSD.org
Subject:   Re: Reordering the rc.conf manual page
Message-ID:  <20050915192313.76e9e63a@localhost>
In-Reply-To: <x2irx2fjlq.rx2@mail.opusnet.com>
References:  <20050915062312.73803494@localhost> <x2irx2fjlq.rx2@mail.opusnet.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 15 Sep 2005 08:15:13 -0700
garys@opusnet.com (Gary W. Swearingen) wrote:

> Tom Rhodes <trhodes@FreeBSD.org> writes:
> 
> > I've included a patch.  It causes a few "empty line" warnings,
> > but still gives you the general idea.  Comments and suggestions
> > are very welcome.
> 
> I got no change to my file after these messages:
> Patching file rc.conf.5 using Plan A...
> Hunk #1 succeeded at 49.
> Hunk #2 succeeded at 73.
> patch: **** malformed patch at line 261: script files -into
> individual filenames.
> 
> > ===================================================================
> > RCS file: /home/ncvs/src/share/man/man5/rc.conf.5,v
> >  Instead, it is included by the
> >  various generic startup scripts in
> 
> rm "generic".
> 
> > -.Pa /etc
> > +.Pa /etc/rc.d
> >  which conditionalize their
> 
> rm "alize".  Please.
> 
> >  internal actions according to the settings found there.
> 
> Found where?  "settings found there" -> "variables set in rc.conf".
> 
> >  .Nm
> > -file:
> > +file, classified by section.
> 
> If you think it's worth your time.  IMO, it won't help users
> much, but it WILL make it look more organized -- a good thing.

Yes, I want more organized.  It will help me, and perhaps
others, if they are looking for a specific option.  They can
just scroll quick down to the area it should be listed in.

> 
> > +When an configuration variable exists which may fit into
> 
> "an" > "a"
> 
> > +two or more catagories, it will be listed with those which
> 
> spelling
> 
> > +contain the most likeness.
> 
> That sounds like some will be listed in muliple categories.
> I hope that's not true.

Correct, there will only be one listing of every item.

> 
> > +.Ss DEBUG
> > +Configuration variables which enable or disable debugging
> > +messages or controls are defined below:
> 
> I don't like "are defined below:". Redundant or something.
> Maybe "are defined below."  or "are:"
> 
> Whoops; maybe that's not yours.  Oh well.
> 

Yea, much of this text is not originally mine.  :)

-- 
Tom Rhodes



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050915192313.76e9e63a>