/[gentoo]/xml/htdocs/proj/en/glep/glep-0042.txt
Gentoo

Diff of /xml/htdocs/proj/en/glep/glep-0042.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.8 Revision 1.13
1GLEP: 42 1GLEP: 42
2Title: Critical News Reporting 2Title: Critical News Reporting
3Version: $Revision: 1.8 $ 3Version: $Revision: 1.13 $
4Author: Ciaran McCreesh <ciaranm@gentoo.org> 4Author: Ciaran McCreesh <ciaranm@gentoo.org>,
5 Stephen Bennett <spb@gentoo.org>,
6 Zach Medico <zmedico@gentoo.org>
5Last-Modified: $Date: 2006/03/02 00:19:39 $ 7Last-Modified: $Date: 2007/05/05 22:24:25 $
6Status: Draft 8Status: Final
7Type: Standards Track 9Type: Standards Track
8Content-Type: text/x-rst 10Content-Type: text/x-rst
9Created: 31-Oct-2005 11Created: 31-Oct-2005
10Post-History: 1-Nov-2005, 5-Nov-2005, 7-Nov-2005, 11-Dec-2005, 13-Dec-2005, 18-Dec-2005, 5-Jan-2006, 2-Mar-2005 12Post-History: 1-Nov-2005, 5-Nov-2005, 7-Nov-2005, 11-Dec-2005, 13-Dec-2005, 18-Dec-2005, 5-Jan-2006, 2-Mar-2006, 6-Mar-2006, 12-Jun-2006, 5-Sep-2006
11 13
12Abstract 14Abstract
13======== 15========
14 16
15This GLEP proposes a new way of informing users about important updates and news 17This GLEP proposes a new way of informing users about important updates and news
156 158
157* Portage must extend ``portageq has_version`` to support restrictions to a 159* Portage must extend ``portageq has_version`` to support restrictions to a
158 given repository ID. 160 given repository ID.
159 161
160* Portage must extend ``portageq`` to implement a command which returns whether 162* Portage must extend ``portageq`` to implement a command which returns whether
161 or not the profile used for a given repository ID matches a certain base path 163 or not the profile used for a given repository ID is exactly the given profile
162 (e.g. ``portageq profile_used default-linux/sparc/sparc64/2004.3 gentoo-x86``). 164 (e.g. ``portageq profile_used default-linux/sparc/sparc64/2004.3
165 gentoo-x86``).
163 166
164These extensions are assumed during the following specification. 167These extensions are assumed during the following specification.
165 168
166News Item Identities 169News Item Identities
167-------------------- 170--------------------
255 A keyword [#glep-22]_ name, for example ``mips`` or ``x86-fbsd``. If the 258 A keyword [#glep-22]_ name, for example ``mips`` or ``x86-fbsd``. If the
256 user is on the keyword in question, the news item should be displayed. 259 user is on the keyword in question, the news item should be displayed.
257 260
258``Display-If-Profile:`` 261``Display-If-Profile:``
259 A profile path, for example ``default-linux/sparc/sparc64/server``. If the 262 A profile path, for example ``default-linux/sparc/sparc64/server``. If the
260 user is using the exact profile in question, or a subprofile of this 263 user is using the exact profile in question, the news item should be
261 profile, the news item should be displayed. This header may be used to 264 displayed. This header may be used to replace ``deprecated`` files in the
262 replace ``deprecated`` files in the future. 265 future.
263 266
264.. Note:: When performing package moves, developers must also update any 267.. Note:: When performing package moves, developers must also update any
265 relevant ``Display-If-Installed`` headers in news files. 268 relevant ``Display-If-Installed`` headers in news files.
266 269
267The algorithm used to determine whether a news item is 'relevant' is as 270The algorithm used to determine whether a news item is 'relevant' is as
447the ``news/`` directory. 450the ``news/`` directory.
448 451
449Reference Implementation 452Reference Implementation
450======================== 453========================
451 454
452TODO 455A reference implementation of the required package manager support can be found
456in Paludis [#paludis]_, along with a reference newsreader implemented as an
457eselect module [#eselect-news]_.
453 458
454Credits 459Credits
455======= 460=======
456 461
457The idea behind notifying users of news updates via Portage comes from Stuart 462The idea behind notifying users of news updates via Portage comes from Stuart
501 Albertson, 506 Albertson,
502 http://marc.theaimsgroup.com/?l=gentoo-dev&m=113111585907703&w=2 507 http://marc.theaimsgroup.com/?l=gentoo-dev&m=113111585907703&w=2
503.. [#rfc-822] RFC 822 "Standard for the format of ARPA Internet text messages" 508.. [#rfc-822] RFC 822 "Standard for the format of ARPA Internet text messages"
504.. [#rfc-3629] RFC 3629: "UTF-8, a transformation format of ISO 10646" 509.. [#rfc-3629] RFC 3629: "UTF-8, a transformation format of ISO 10646"
505 http://www.ietf.org/rfc/rfc3629.txt 510 http://www.ietf.org/rfc/rfc3629.txt
511.. [#paludis] Paludis homepage, http://paludis.berlios.de
512.. [#eselect-news] news.eselect, http://svn.berlios.de/svnroot/repos/paludis/trunk/eselect/news.eselect
506.. [#stuart-blog] "Favouring an automatic news mechanism", Stuart Herbert, 513.. [#stuart-blog] "Favouring an automatic news mechanism", Stuart Herbert,
507 http://stu.gnqs.org/diary/gentoo.php/2005/10/28/favouring_an_automatic_news_mechanism 514 http://stu.gnqs.org/diary/gentoo.php/2005/10/28/favouring_an_automatic_news_mechanism
508 515
509Copyright 516Copyright
510========= 517=========

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.13

  ViewVC Help
Powered by ViewVC 1.1.20