diff --git a/glep-0042.rst b/glep-0042.rst index 416bd18..65c9230 100644 --- a/glep-0042.rst +++ b/glep-0042.rst @@ -9,10 +9,10 @@ Type: Standards Track Status: Final Version: 4 Created: 2005-10-31 -Last-Modified: 2017-11-29 +Last-Modified: 2018-01-04 Post-History: 2005-11-01, 2005-11-05, 2005-11-07, 2005-12-11, 2005-12-13, 2005-12-18, 2006-01-05, 2006-03-02, 2006-03-06, 2006-06-12, - 2006-09-05, 2016-03-10, 2017-11-27 + 2006-09-05, 2016-03-10, 2017-11-27, 2018-01-04 Content-Type: text/x-rst --- @@ -208,7 +208,9 @@ compatibility with and for the same reasons as existing Gentoo documentation A news item file's content will consist of an RFC 822 style header [#rfc-822]_ followed by the main body of the message as plain text. This GLEP defines various optional and mandatory headers. Future GLEPs may propose new headers — -tools handling these news items must ignore any unrecognised header. +tools handling these news items must ignore any unrecognised header. Headers +where the name of the header is valid but the value is invalid shall also count +as unrecognised. .. Note:: A previous version of this GLEP had required that news items must be signed with a detached OpenPGP signature. This was deemed no longer @@ -247,17 +249,25 @@ The following headers describe the purpose and format of the news item: item. Mandatory. ``News-Item-Format:`` - Known formats are ``1.0`` and ``2.0``. Future revisions to the format - may increment the minor number for forwards-compatible changes (i.e., - still allowing older tools to process the new format), or the major + Known formats are ``1.0``, ``2.0``, and ``2.1``. Future revisions to the + format may increment the minor number for forwards-compatible changes + (i.e., still allowing older tools to process the new format), or the major number for major changes. +``Expires:`` + Date of expiration, in ``yyyy-mm-dd`` format (e.g. 2019-01-18) for + compatibility with GLEP 45 [#glep-45]_. Translations should use the date of + the original news item. An item is expired if the current date in UTC is + greater than the expiration date of the item. Package managers should not + display expired items. In news item format ``2.1``, this field is + mandatory. + The following headers are used for filtering: ``Display-If-Installed:`` A package dependency specification (for example, ``>=sys-devel/gcc-5`` or ``www-servers/apache``) conforming to EAPI 0 [#PMS]_ in news item - format ``1.0`` or to EAPI 5 in format ``2.0``. If the user has the + format ``1.0`` or to EAPI 5 in format ``2.*``. If the user has the package specified installed from the repository from which the news item was obtained, the news item should be displayed. @@ -269,7 +279,7 @@ The following headers are used for filtering: A profile path, for example ``default/linux/sparc/13.0``. If the user is using the exact profile in question, the news item should be displayed. This header may be used to replace ``deprecated`` files in the - future. In news item format ``2.0``, a terminal asterisk immediately + future. In news item format ``2.*``, a terminal asterisk immediately following a slash acts as a wildcard for any further path components, for example ``default/linux/*``.