Quoting David Bremner (2026-01-25 23:20:23)
> Anton Khirnov <anton@khirnov.net> writes:
> 
> >> 
> >> With my Debian maintainer hat on, is your idea that linux distros would
> >> install this? In that case I prefer not to add more things to contrib/
> >> that are really "installed sometimes". Or do we expect users to "do the
> >> right thing"?
> >
> > My intent was to install them as part of the documentation and have
> > users plug them into their setup manually, at least initially.
> 
> In that case I prefer to distribute them in doc/, either embedded in
> .rst files (perhaps as an appendix) or in some new examples/
> directory. The former sounds a bit ugly but it would have the advantage
> of reaching users without requiring any downstream packaging changes
> (e.g. would show up in the online documentation).

I agree, it does sound ugly and I'd expect it to get in the way of that
code being developed from a trivial example into something more mature.
I also don't see much benefit in having the scripts embedded in the
generated documentation, simply mentioning that they exist and where to
find them should be enough.

-- 
Anton Khirnov
_______________________________________________
notmuch mailing list -- notmuch@notmuchmail.org
To unsubscribe send an email to notmuch-leave@notmuchmail.org