• [DRAFT v3] GLEP 84: Standard format for package.mask files

    From Arthur Zamarin@21:1/5 to All on Wed Nov 1 21:40:01 2023
    Copy: glep@gentoo.org

    This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --------------vMfAdAF0jp0txP109DTnnPH0
    Content-Type: text/plain; charset=UTF-8
    Content-Transfer-Encoding: quoted-printable

    This is the third version of the GLEP after previous recommendations
    and suggestions [1] - thank you for all who participated. Similar to previously, the draft can also be found on glep-0084 branch [2].

    [1] https://public-inbox.gentoo.org/gentoo-dev/uzg0mqpfc@gentoo.org/T/

    [2] https://gitweb.gentoo.org/data/glep.git/tree/glep-0084.rst?h=glep-0084



    ---
    GLEP: 84
    Title: Standard format for package.mask files
    Author: Arthur Zamarin <arthurzam@gentoo.org>
    Type: Standards Track
    Status: Draft
    Version: 1.0
    Created: 2023-11-01
    Content-Type: text/x-rst
    ---

    Abstract
    ========

    This GLEP specifies the format of ``package.mask`` files under profiles directory.

    Motivation
    ==========

    At the moment of writing this GLEP, ``package.mask`` files didn't have a full format specification. While PMS sections 4.4 [#PMS-4.4]_ and 5.2.8 [#PMS-5.2.8]_ specifies the raw format which the package manager must support for correct behavior, it does not specify how comments must be formatted, how entries must be grouped, how last-rite masks should be written, etc.

    Various tools have been developed to handle that mask message. A non exhaustive list includes ``lr-add-pmask`` [#lr-add-pmask]_, ``pkgdev mask`` [#pkgdev-mask]_,
    and ``soko`` [#soko-mask]_. Those tools have different purposes, filing a new mask message with all relevant information, and showin