From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id C4421158451 for ; Sun, 7 Jan 2024 18:26:51 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 07C26E2A3A; Sun, 7 Jan 2024 18:26:48 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id AF9F7E2A36 for ; Sun, 7 Jan 2024 18:26:47 +0000 (UTC) Message-ID: Subject: Re: [gentoo-dev] [RFC] New category: dev-doc (?) From: =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Date: Sun, 07 Jan 2024 19:26:36 +0100 In-Reply-To: References: Organization: Gentoo Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-uAtig8yXCdr7TfxCK75k" User-Agent: Evolution 3.50.3 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 X-Archives-Salt: 081acb6a-cf75-4d85-bf92-7ee2fc1041e3 X-Archives-Hash: 27b7a56c88014e638ecfc3e889698029 --=-uAtig8yXCdr7TfxCK75k Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sun, 2024-01-07 at 17:58 +0100, Ulrich Mueller wrote: > > > > > > On Sun, 07 Jan 2024, Micha=C5=82 G=C3=B3rny wrote: >=20 > > Here's another idea, a new dev-doc category (though I suppose we could > > try to find a better name), dedicated to: >=20 > > =C2=A0=C2=A0Tools to generate, convert, view and process documentation. >=20 > > This is notably meant to move software out of app-doc/ which is > > specifically dedicated to "documentation collections". Candidates: >=20 > > 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 >=20 > I cannot really see a delineation between app-text and app-doc. >=20 > 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? >=20 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). --=20 Best regards, Micha=C5=82 G=C3=B3rny --=-uAtig8yXCdr7TfxCK75k Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- iQFGBAABCgAwFiEEx2qEUJQJjSjMiybFY5ra4jKeJA4FAmWa7NwSHG1nb3JueUBn ZW50b28ub3JnAAoJEGOa2uIyniQOPTQIAId7R50/maT4sTz7KIKgHmRtoOYGGVdr 8CuiELQJGvv/RyBu6mAuvskYt+yShwkTyHSE7iNaBvo5q79Dx6pD1PUlNkVs0vrd uVlcbWlSRaUBAr/6ugdaMBdc50gwjabmgg3SgLmmlRHcrmGARZ+4tKnFqvW/N5t9 zFT3w9f9RnFpUvA+bb8M0PMSlbkDAzZYL8iykSKws8kyzxfFuUTeAqiVPXBqZJh8 cQ8sf1hxQfdMXd/4ToItK5HErwmtxvYVBkjJ4Z6fTyFolBM6NmLxlQNodegALj2L 4y5WYice2iw3sYw4sXwV/IOzZa9DXHM5jruQO2v+uJmvU8BQne8WOf4= =Kvo6 -----END PGP SIGNATURE----- --=-uAtig8yXCdr7TfxCK75k--