Gentoo Development Guide

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 file name in the proper format: YYYY-MM-DD-name.lang.txt, where the date is followed by a name (a-z, 0-9, + (plus), - (hyphen) and _ (underscore)), the two-letter ISO language code (en for English must be chosen as default) and the file extension txt.
  • 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 is possible.
  • Send the news item to the gentoo-dev mailing list and the Gentoo PR team (pr@gentoo.org) 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).
  • Upon acceptance, create a detached armored GnuPG signature with gpg --local-user --detach-sign --armor YYYY-MM-DD-name.lang.txt
  • Create a directory structure for your item in the gentoo-news repository (git+ssh://git@git.gentoo.org/proj/gentoo-news.git): YYYY/YYYY-MM-DD-name/.
  • Add both the news file and the signature to that directory.
  • Commit and push your changes to the gentoo-news repository.