Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 24 May 2021 08:40:09 -0600
From:      Alan Somers <asomers@freebsd.org>
To:        Santiago Martinez <sm@codenetworks.net>
Cc:        Steve Kargl <sgk@troutmask.apl.washington.edu>,  freebsd-current <freebsd-current@freebsd.org>
Subject:   Re: FreeBSD - rc.conf man page splitting.
Message-ID:  <CAOtMX2ifpZCeAqOKpmTN53uGWE-AYVYoUNCSssRj87m%2Bo_TuSQ@mail.gmail.com>
In-Reply-To: <eb155956-b557-fe0f-b378-7e262d2a752c@codenetworks.net>
References:  <a16fb970-930f-1d78-7f4a-3a925c622563@codenetworks.net> <20210523202622.GA26188@troutmask.apl.washington.edu> <eb155956-b557-fe0f-b378-7e262d2a752c@codenetworks.net>

next in thread | previous in thread | raw e-mail | index | archive | help

[-- Attachment #1 --]
That man page is getting pretty big.  However, it's not always obvious
which section a particular setting should be in.  Right now, you can always
just search through the entire thing.  But searching would be harder if it
were split up.  So I vote to keep it together.
-Alan

On Mon, May 24, 2021 at 8:28 AM Santiago Martinez <sm@codenetworks.net>
wrote:

> Ok, noted. my proposal come after looking for network parameters (which
> also is a topic to talk about) the list is so huge that it doesn't not
> make it simple.  But if this work for most, then i have to accommodate
> to that!
>
> Thanks for your feedback!
>
> Santi
>
>
>
> On 5/23/21 9:26 PM, Steve Kargl wrote:
> > On Sun, May 23, 2021 at 09:20:45PM +0100, Santiago Martinez wrote:
> >> Just wondering whats your view on splitting rc.conf man pages (per
> >> section/topic), something similar to what it was done with zfs.
> >>
> >> For example rc.conf-fw, rc.conf-network and so on. And yes if people
> think
> >> is a good idea im happy to take the task.
> >>
> > IMO, Bad idea (tm).
> >
>
>

[-- Attachment #2 --]
<div dir="ltr"><div>That man page is getting pretty big.  However, it&#39;s not always obvious which section a particular setting should be in.  Right now, you can always just search through the entire thing.  But searching would be harder if it were split up.  So I vote to keep it together.</div><div>-Alan<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, May 24, 2021 at 8:28 AM Santiago Martinez &lt;<a href="mailto:sm@codenetworks.net">sm@codenetworks.net</a>&gt; wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Ok, noted. my proposal come after looking for network parameters (which <br>
also is a topic to talk about) the list is so huge that it doesn&#39;t not <br>
make it simple.  But if this work for most, then i have to accommodate <br>
to that!<br>
<br>
Thanks for your feedback!<br>
<br>
Santi<br>
<br>
<br>
<br>
On 5/23/21 9:26 PM, Steve Kargl wrote:<br>
&gt; On Sun, May 23, 2021 at 09:20:45PM +0100, Santiago Martinez wrote:<br>
&gt;&gt; Just wondering whats your view on splitting rc.conf man pages (per<br>
&gt;&gt; section/topic), something similar to what it was done with zfs.<br>
&gt;&gt;<br>
&gt;&gt; For example rc.conf-fw, rc.conf-network and so on. And yes if people think<br>
&gt;&gt; is a good idea im happy to take the task.<br>
&gt;&gt;<br>
&gt; IMO, Bad idea (tm).<br>
&gt;<br>
<br>
</blockquote></div></div>

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAOtMX2ifpZCeAqOKpmTN53uGWE-AYVYoUNCSssRj87m%2Bo_TuSQ>