Re: [gentoo-dev] [RFC] New category: dev-doc (?)

["Michał Górny" <mgorny@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1300 bytes --]

On Sun, 2024-01-07 at 17:58 +0100, Ulrich Mueller wrote:
> > > > > > On Sun, 07 Jan 2024, Michał Górny wrote:
> 
> > Here's another idea, a new dev-doc category (though I suppose we could
> > try to find a better name), dedicated to:
> 
> >   Tools to generate, convert, view and process documentation.
> 
> > This is notably meant to move software out of app-doc/ which is
> > specifically dedicated to "documentation collections".  Candidates:
> 
> > app-doc/NaturalDocs
> > app-doc/doxygen
> > app-doc/halibut
> > app-doc/psmark
> > app-doc/xmltoman
> > app-doc/zeal
> > app-text/mandoc
> > app-text/texi2html
> > app-text/xchm
> > app-text/xml2rfc
> > app-text/xmlto
> 
> I cannot really see a delineation between app-text and app-doc.
> 
> For example, packages like psmark, xmlto, or even texi2html are general
> format manipulation/conversion tools and IMHO app-text is the right
> category for them. Also, why would you keep pandoc and manpager in
> app-text but move xmlto and mandoc out of it?
> 

It's a bit blurry.  My original idea was to keep app-text/ for general-
purpose text tools (like text editors), while make dev-doc/ focused on
formats specific to documentation (like code documentation, manpages).

-- 
Best regards,
Michał Górny


[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 512 bytes --]