News items
Gentoo News Items were created to provide a communication medium to push critical messages to users via the rsync tree. The original proposal for news items is outlined in GLEP 42: Critical News Reporting.
News Items can be read using the eselect command. More information on use of this tool to read or delete news items can be found on the news.eselect man page.
Adding a news item
-
Choose a filename in the proper format:
YYYY-MM-DD-shortname.lang.txt
, i.e. the date, followed by a very short name of at most 20 characters and consisting only ofa-z
,0-9
,+
(plus),-
(hyphen) and_
(underscore). This is followed bylang
which is an IETF language tag. Always useen
for English, unless you are translating a news item. Finally, the filename ends with the extensiontxt
. - Write the news item, which is similar to a RFC-compliant email. Details concerning what is allowed can be found in the appropriate GLEP section. As a note: Exceptions depending on installed packages or activated profiles are possible.
- Send the news item to the gentoo-dev mailing list and the Gentoo PR team ([email protected]) 72 hours in advance of commit.
- Wait for corrections or feedback that your news item is not of great importance and should be revoked (can be possible).
-
Create a directory structure for your item in the gentoo-news repository
(
git+ssh://[email protected]/data/gentoo-news.git
):YYYY-MM-DD-shortname/
. - Add the news file to that directory.
- Commit and push your changes to the gentoo-news repository.