I use it regularily too, I don't like talking about stuff I don't use.
Downsides I could see is just the general fun of moving documentation,
which can be a huge problem for me and I'm guessing you too.
Upsides are slightly, ever so small decrease in clutter and better
access for the new age of open source types.
I'm not pinning for a change, raising an idea that might help others
but will hurt me when I forget the syntax of doas *and* to pull down
www.
After all I know for a fact I'm that much of an idiot.
PS;
apologies to Theo, as demonstrated I am a colossal moron.
On Sun, Apr 26, 2020 at 10:52 AM Theo de Raadt wrote:
>
> My position is that the directory is fine, and helpful.
>
> I use it all the time to setup machines quickly.
>
> Maybe you don't. Then you can ignore it.
>
>
> Louis Fredrickson wrote:
>
> > Was it ever floated to remove examples entirely and move them to www?
> > I think it would be easier for the forgetful, new and muh power use types
> > all alike, as worthless and unneccesary as my opinion may be.
> >
> > On Sun, 26 Apr 2020, 10:08 Ingo Schwarze, wrote:
> >
> > > Hi,
> > >
> > > clematis wrote on Sat, Apr 25, 2020 at 11:34:14PM +0200:
> > >
> > > > But then based on your feedback I wonder if there's even any
> > > > value of an example file which gives not much more than an already
> > > > well documented manpage?
> > >
> > > We had that discussion among developers at least twice in the past.
> > >
> > > If i were the only developer, which very fortunately i'm not,
> > > i would probably go for fewer files in /etc/examples/.
> > >
> > > But there are also several developers who find it quite
> > > convenient to have a larger number of small example files
> > > around, for various reasons, for example because it is often
> > > quicker to get a general feeling for the basic syntax by looking
> > > at a concise example file compared to reading an abstract
> > > description in the manual page, and because copy and paste
> > > from manual pages is somewhat hindered by indentation (don't
> > > suggest solutions for that, it is not really an issue that
> > > needs solving).
> > >
> > > It hasn't been very productive when i proposed such files
> > > for deletion, so i tend to not press such issues again.
> > >
> > > But that doesn't mean i'd gladly agree to start tripling or
> > > quadrupling the sizes of existing files without good reasons.
> > >
> > > > And again, please don't get me wrong, I don't
> > > > mean to play devil's advocate but do we even need an
> > > > /etc/examples/doas.conf?
> > > > (for all the very valid reasons you've mentioned as well, clarity,
> > > > existing documentation etc...)
> > >
> > > If i remember correctly, there were quite a few developers
> > > who considered it useful to keep a short examples/doas.conf
> > > around and didn't like the idea of deleting it.
> > >
> > > > I would be tempted to put a few others in the same boat:
> > >
> > > Yes, there are certainly a few others were more or less the
> > > same arguments apply like for doas.conf.
> > >
> > > Yours,
> > > Ingo
> > >
> > >
