1. Forum
  2. Usenet
  3. LINUX.GENTOO.DEV

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

    From =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?=@21:1/5 to All on Sun Jan 7 17:40:01 2024
    Hi,

    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
    dev-util/gi-docgen
    dev-util/gtk-doc
    dev-util/source-highlight
    sys-apps/man-db
    sys-apps/texinfo

    --
    Best regards,
    Michał Górny


    -----BEGIN PGP SIGNATURE-----

    iQFGBAABCgAwFiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAmWa068SHG1nb3JueUBn ZW50b28ub3JnAAoJEGOa2uIyniQOY4QH/0qUDYoliN6wY7jw++gyoyBy7VnFRmBn qgWKwuIE55j5nAxMhcGtXgh/G9Ie9+YLdCnT+Z2AVTL21II3K+uXH2fOP7BRfyt0 WSEMUyF7td4YZe4ssNqvb9yCBgSi+L5mMRr8AGYsJlAGNsLdAaad754JWc+iX/2+ n/bXJLjdTRm7RlGi3Pmff4k1YJ2tOp8SSC/AevG6rQvrSjKg70BHEhdZSrZmNzzc xYP452LkN+OoWoEpCUPQx9JaOEo6pTdXeE1lif7J0/mEX1ZM3ELSUUFgS54goPi2 M4FFUCGFSfNU6akt467zJHN0Yo9nJawNC3fo+P60yZeAmzN2J4G/mx4=
    =BmFB
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Ulrich Mueller@21:1/5 to All on Sun Jan 7 18:00:01 2024
    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?

    dev-util/gi-docgen
    dev-util/gtk-doc
    dev-util/source-highlight
    sys-apps/man-db
    sys-apps/texinfo

    --=-=-Content-Type: application/pgp-signature; name="signature.asc"

    -----BEGIN PGP SIGNATURE-----

    iQFDBAEBCAAtFiEEtDnZ1O9xIP68rzDbUYgzUIhBXi4FAmWa2EwPHHVsbUBnZW50 b28ub3JnAAoJEFGIM1CIQV4uDCoIAMn9yOA8akaU/FADoKJYs8WbHqEYveoTp2j5 2mb3DQtADtQ9W6N8RhbACY6WpV8uAWAOUFojJrflLd87HULQsqOWAHKkEfnF8kMS vLVPkiFznPqrSwG3EkOqZ3aFqxOunpiTi67yOAEOI94o+SB6I5AACElVgWRlPfaj V4saIvrW0ZeA7z7U5zPXFyqz4XVLwUb2M7+EiWeoure98HYGpAE+zgDtqbWUEnt+ LVYqCAk+fx4NgIn24/KD3aGHQHdgv9yetG/Y2KmekzJnl/PsmjHHJ3DfXJhf7Xi6 mZz1rrAH1fZj7eT5gQQEWkQznPDBQtuN+7ElhMdNDT0klhLYoEc¸nd
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Ulrich Mueller@21:1/5 to All on Sun Jan 7 18:10:01 2024
    On Sun, 07 Jan 2024, Ulrich Mueller wrote:

    I cannot really see a delineation between app-text and app-doc.

    Sorry, this should read "between app-text and dev-doc", of course.

    -----BEGIN PGP SIGNATURE-----

    iQFDBAEBCAAtFiEEtDnZ1O9xIP68rzDbUYgzUIhBXi4FAmWa2UYPHHVsbUBnZW50 b28ub3JnAAoJEFGIM1CIQV4usmkH+gJK8+Y6aNDkiqDbMPcSBn3T/z74hwr9iaTz GEURRj5A8VgApdGEjfmmJxgDSARkiQSb46n1OtT4IosLeLlYG5Emx+FJbkmehbnN hi4Nr4Lz162mXcPOzFV5sSgxvgkyWGh65zZubSAxaMWPhjYhzkgC/pm0qBj7+w6t GgYPjcnTi1DQuFBFgD2g+Cxs0OEJalbvx5UBz2CdauGCKAQI1wqBCP134OuGfT5c zR1jALXRsLRxnmAneUZWarGHkrCWkIMezUomsLl2VZHsMCTFZ793hIGq2FwM3IVM 6kEhyVslTryQd2QWiFsjrd6rG2QgvEEF/hcFSs5lCgNIDsIuKW4=
    =+Fr/
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?=@21:1/5 to Ulrich Mueller on Sun Jan 7 19:30:02 2024
    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


    -----BEGIN PGP SIGNATURE-----

    iQFGBAABCgAwFiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAmWa7NwSHG1nb3JueUBn ZW50b28ub3JnAAoJEGOa2uIyniQOPTQIAId7R50/maT4sTz7KIKgHmRtoOYGGVdr 8CuiELQJGvv/RyBu6mAuvskYt+yShwkTyHSE7iNaBvo5q79Dx6pD1PUlNkVs0vrd uVlcbWlSRaUBAr/6ugdaMBdc50gwjabmgg3SgLmmlRHcrmGARZ+4tKnFqvW/N5t9 zFT3w9f9RnFpUvA+bb8M0PMSlbkDAzZYL8iykSKws8kyzxfFuUTeAqiVPXBqZJh8 cQ8sf1hxQfdMXd/4ToItK5HErwmtxvYVBkjJ4Z6fTyFolBM6NmLxlQNodegALj2L 4y5WYice2iw3sYw4sXwV/IOzZa9DXHM5jruQO2v+uJmvU8BQne8WOf4=
    =Kvo6
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Ulrich Mueller@21:1/5 to All on Mon Jan 8 08:00:01 2024
    On Sun, 07 Jan 2024, Michał Górny wrote:

    On Sun, 2024-01-07 at 17:58 +0100, Ulrich Mueller wrote:
    I cannot really see a delineation between app-text and [dev]-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).

    We already have app-editors for text editors. For the rest, it seems
    very blurry indeed and would leave us with (IMHO too many) borderline
    cases.

    You certainly have a point that document processing tools are misplaced
    in app-doc. Maybe just move them to app-text, which would be a more
    minimal change?

    Ulrich

    --=-=-Content-Type: application/pgp-signature; name="signature.asc"

    -----BEGIN PGP SIGNATURE-----

    iQFDBAEBCAAtFiEEtDnZ1O9xIP68rzDbUYgzUIhBXi4FAmWbm4wPHHVsbUBnZW50 b28ub3JnAAoJEFGIM1CIQV4uP3wH/R/zWFHmt99plAroqvbeY5JSZoKVgr+OFle4 KNOZR3I7aaKDKOwHYGMSKtfwO+UYri7ui7TNev1NIlmEpPjVGHshrLGo77Oqi5lF 0P6Rg2W8SlWf3kbYC5UxUuGSnlqxGQkChI+4bKcw3UptWUEpB12RaINKvWBxvIjj M/lIxqLjTOemX1S8XabafsyRC4TV27Fmawtcu8elvr1FLZcUxxYk19Cxkfv0visv NqXRIZqvZNMn3hPss0AHW+ENCtn6l+LZbuXdFCtl9hNyBCdoDyK36hYF+7feHuCB Nq81q2xfqcur0usWD01BsCA8sgzyodFp9+hFqee0G093yuj6PDsß2+
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?=@21:1/5 to Ulrich Mueller on Mon Jan 8 14:50:01 2024
    On Mon, 2024-01-08 at 07:51 +0100, Ulrich Mueller wrote:
    On Sun, 07 Jan 2024, Michał Górny wrote:

    On Sun, 2024-01-07 at 17:58 +0100, Ulrich Mueller wrote:
    I cannot really see a delineation between app-text and [dev]-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).

    We already have app-editors for text editors. For the rest, it seems
    very blurry indeed and would leave us with (IMHO too many) borderline
    cases.

    You certainly have a point that document processing tools are misplaced
    in app-doc. Maybe just move them to app-text, which would be a more
    minimal change?


    I suppose that would work for me. I'll wait a few more days, though, to
    make sure we won't end up moving them twice over a short period.

    --
    Best regards,
    Michał Górny


    -----BEGIN PGP SIGNATURE-----

    iQFGBAABCgAwFiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAmWb/DYSHG1nb3JueUBn ZW50b28ub3JnAAoJEGOa2uIyniQO+8YIALhpkveq2zXjQzvS2D+SBUn/j+hs1Lkc J+lxHgythOIFW3SagXgILOSNfRSbBxc1LxxxcrqD8kj2PjpmyVLLBqZFx/mxxPE4 65cwpnBmsYUBI1uQIbredG9k0nZ0yxWlOQaQGo94mIsFVpQB2rvgoSShFNuhrmnF 5CkO9XAHtNYrN8ZNXI67VV/D+jxhHgMwyyuiYphh8ePUd5iUarewoQyQyElwFX8x GQYVodtTingMpcaBYr3v+1ttPusagTrW+7aS6CYy0ALFib8UIx2n1dYTOaz5sFr+ mPzlhjlobyFLyPbbmeiLWa5GAtgOdnZaE++pZqABwsjBg9mABTJShR4=
    =7xYO
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)