/[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.9 Revision 1.14
1GLEP: 42 1GLEP: 42
2Title: Critical News Reporting 2Title: Critical News Reporting
3Version: $Revision: 1.9 $ 3Version: $Revision: 1.14 $
4Author: Ciaran McCreesh <ciaranm@gentoo.org> 4Author: Ciaran McCreesh <ciaranm@gentoo.org>,
5Last-Modified: $Date: 2006/03/06 03:12:08 $ 5 Stephen Bennett <spb@gentoo.org>,
6Status: Draft 6 Zach Medico <zmedico@gentoo.org>
7Last-Modified: $Date: 2010/02/22 11:38:26 $
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-2006, 6-Mar-2006 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
… …
349 351
350.. Note:: A previous draft of this GLEP instead used the main ``gentoo-x86`` 352.. Note:: A previous draft of this GLEP instead used the main ``gentoo-x86``
351 tree. This was changed following advice from Infrastructure 353 tree. This was changed following advice from Infrastructure
352 [#ramereth-repo]_. Both solutions have the same end result. 354 [#ramereth-repo]_. Both solutions have the same end result.
353 355
354This repository will contain directories named ``yyyy/mm/``, where ``yyyy`` is 356This repository will contain directories named ``yyyy/``, where ``yyyy`` is
355the current year and ``mm`` is the current month number (01 for January through
35612 for December). This separation will help keep news items more manageable. 357the current year. This separation will help keep news items more manageable.
357 358
358The contents of this repository will automatically be merged with the main rsync 359The contents of this repository will automatically be merged with the main rsync
359tree, placing the items in a ``metadata/news/`` directory. The method used for 360tree, placing the items in a ``metadata/news/`` directory. The method used for
360merging these items and the frequency at which it will occur is beyond the scope 361merging these items and the frequency at which it will occur is beyond the scope
361of this GLEP; a similar setup is already used for merging GLSAs into the rsync 362of this GLEP; a similar setup is already used for merging GLSAs into the rsync
362tree. 363tree.
363 364
364The main rsync tree will **not** use the ``yyyy/mm/`` subdirectory layout. The 365The main rsync tree will **not** use the ``yyyy/`` subdirectory layout. The
365news item directories will all be immediately under the ``metadata/news/`` 366news item directories will all be immediately under the ``metadata/news/``
366directory. 367directory.
367 368
368Client Side 369Client Side
369''''''''''' 370'''''''''''
… …
448the ``news/`` directory. 449the ``news/`` directory.
449 450
450Reference Implementation 451Reference Implementation
451======================== 452========================
452 453
453TODO 454A reference implementation of the required package manager support can be found
455in Paludis [#paludis]_, along with a reference newsreader implemented as an
456eselect module [#eselect-news]_.
454 457
455Credits 458Credits
456======= 459=======
457 460
458The idea behind notifying users of news updates via Portage comes from Stuart 461The idea behind notifying users of news updates via Portage comes from Stuart
… …
502 Albertson, 505 Albertson,
503 http://marc.theaimsgroup.com/?l=gentoo-dev&m=113111585907703&w=2 506 http://marc.theaimsgroup.com/?l=gentoo-dev&m=113111585907703&w=2
504.. [#rfc-822] RFC 822 "Standard for the format of ARPA Internet text messages" 507.. [#rfc-822] RFC 822 "Standard for the format of ARPA Internet text messages"
505.. [#rfc-3629] RFC 3629: "UTF-8, a transformation format of ISO 10646" 508.. [#rfc-3629] RFC 3629: "UTF-8, a transformation format of ISO 10646"
506 http://www.ietf.org/rfc/rfc3629.txt 509 http://www.ietf.org/rfc/rfc3629.txt
510.. [#paludis] Paludis homepage, http://paludis.berlios.de
511.. [#eselect-news] news.eselect, http://svn.berlios.de/svnroot/repos/paludis/trunk/eselect/news.eselect
507.. [#stuart-blog] "Favouring an automatic news mechanism", Stuart Herbert, 512.. [#stuart-blog] "Favouring an automatic news mechanism", Stuart Herbert,
508 http://stu.gnqs.org/diary/gentoo.php/2005/10/28/favouring_an_automatic_news_mechanism 513 http://stu.gnqs.org/diary/gentoo.php/2005/10/28/favouring_an_automatic_news_mechanism
509 514
510Copyright 515Copyright
511========= 516=========
Legend:
Removed from v.1.9  
changed lines
  Added in v.1.14
  ViewVC Help
Powered by ViewVC 1.1.20