• Re: Documentation field? (Was: Removing manpages from libpam-modules to

    From Ben Collins@21:1/5 to Gioele Barabucci on Thu Jan 16 16:20:01 2025
    On Wed, Jan 15, 2025 at 06:24:39PM -0500, Gioele Barabucci wrote:
    On 15/01/25 17:43, Sam Hartman wrote:
    My proposal is to move the man pages into libpam-doc.
    I'm not actually convinced that normal Debian users need man pages for
    all the pam modules on all Debian systems, and a suggests relationship should be sufficient.

    Unrelated to the question at hand, but I was wondering: why doesn't
    d/control contain a "Documentation:" field?

    Is there a proposal on this field at all? I ask because I'm interested
    in knowning more about what you're suggesting. I can think of some syntax
    that would be helpful. One that comes to mind is:

    Package: libfoo-dev
    Documentation: any(foo), rfc(2549)

    Package: libfoo-doc
    Provides-Documentation: doc-base(foo), manpages(foo)

    It just seems to me that documentation would be topical and media-
    grouped rather than a package naming paradigm. The RFC type could be
    expanded to https://www.rfc-editor.org/rfc/rfc{ID}, for example.

    --
    Ben Collins
    https://debian.org | https://ubuntu.com
    https://ben-collins.blogspot.com
    https://catchmobilehealth.com
    --
    3EC9 7598 1672 961A 1139 173A 5D5A 57C7 242B 22CF

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

    iQIzBAABCgAdFiEEPsl1mBZylhoRORc6XVpXxyQrIs8FAmeJIjQACgkQXVpXxyQr Is/7tQ//WuVkG9ClIamPLehuVKRxqAOnzSuZ8zbzgYugn1W0VUd7iHk4a578ant8 8y57aKlQPAbTPzaLgc34tVMYGTR1xsuEdwciaV9qSwHT1fYYo1+06NNVYjMVHw3w rghl9A9NEaF+McCnvOZO8gGooJTOFQiD/UZUfGQUQx4x/W+rZKH7CwrXZ3jljxnS pYfur8HDEdQDLIfEqi0MuJiZMoZSKBU3W5GaM7HfSX2ZXRi97VEmB1aJRMVWB83I oXlwF1OveHaWxTz3ech/VjFcA2URL4FMjzZ3PP11FyriCS9xMMqklMXpcmSo74EY h2sAeXzPKQNTO6MXA2ECx1yvaJtD570xB1M+t9qjkqcBd9xiUMfq+Q54l4sXsitu fykqWHd9LiI04jQjWwXVzVWqnOOSoc2bXM7xqi2G0xu1Ziy7/AIGlA2pjhkJWkz5 2kmDYZx9suJKq+DixhmKPADJC8yaRp0ii/SbLtTo7WyvL5IwyDo+/D1PfM39upzy YXVYV3n2VddVTkUIO+oExm4gVBqn9jD2+LMin2bQAQG/9YDknifo3iqO08bAcDRU P3yQhEQAVfWc2rFypMTyOj3fOrXLzJyBbyhP5n7xE7OW4Mk78o4DnqayeCl9zikl ISAdTcusZJ65oHJlbX2wr7/K1MrsRj0sT9qmoMg6/MUmRdHSnw4=
    =1qIl
    -----END PGP SIG