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
--0000000000008f8c3d05c3146344
Content-Type: text/plain; charset="UTF-8"

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

--0000000000008f8c3d05c3146344
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>That man page is getting pretty big.=C2=A0 However, i=
t&#39;s not always obvious which section a particular setting should be in.=
=C2=A0 Right now, you can always just search through the entire thing.=C2=
=A0 But searching would be harder if it were split up.=C2=A0 So I vote to k=
eep it together.</div><div>-Alan<br></div><br><div class=3D"gmail_quote"><d=
iv dir=3D"ltr" class=3D"gmail_attr">On Mon, May 24, 2021 at 8:28 AM Santiag=
o Martinez &lt;<a href=3D"mailto:sm@codenetworks.net">sm@codenetworks.net</=
a>&gt; wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0p=
x 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.=C2=A0 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 peop=
le 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>

--0000000000008f8c3d05c3146344--



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