| 1 | GLEP: 42 |
1 | GLEP: 42 |
| 2 | Title: Critical News Reporting |
2 | Title: Critical News Reporting |
| 3 | Version: $Revision: 1.1 $ |
3 | Version: $Revision: 1.2 $ |
| 4 | Author: Ciaran McCreesh <ciaranm@gentoo.org> |
4 | Author: Ciaran McCreesh <ciaranm@gentoo.org> |
| 5 | Last-Modified: $Date: 2005/11/05 03:32:09 $ |
5 | Last-Modified: $Date: 2005/11/07 17:02:42 $ |
| 6 | Status: Draft |
6 | Status: Draft |
| 7 | Type: Standards Track |
7 | Type: Standards Track |
| 8 | Content-Type: text/x-rst |
8 | Content-Type: text/x-rst |
| 9 | Created: 31-October-2005 |
9 | Created: 31-October-2005 |
| 10 | Post-Date: 1-November-2005, 5-November-2005 |
10 | Post-Date: 1-November-2005, 5-November-2005 |
| … | |
… | |
| 36 | |
36 | |
| 37 | An adequate solution must meet all of the following requirements: |
37 | An adequate solution must meet all of the following requirements: |
| 38 | |
38 | |
| 39 | Preemptive |
39 | Preemptive |
| 40 | Users should be told of changes *before* they break the user's system, |
40 | Users should be told of changes *before* they break the user's system, |
| 41 | after the damage has already been done. |
41 | not after the damage has already been done. |
| 42 | |
42 | |
| 43 | No user subscription required |
43 | No user subscription required |
| 44 | It has already been demonstrated [#forums-whining]_ that many users do not |
44 | It has already been demonstrated [#forums-whining]_ that many users do not |
| 45 | read the ``gentoo-announce`` mailing list or ``RSS`` feeds. A solution which |
45 | read the ``gentoo-announce`` mailing list or ``RSS`` feeds. A solution which |
| 46 | requires subscription has no advantage over current methods. |
46 | requires subscription has no advantage over current methods. |
| … | |
… | |
| 200 | The header section must be followed by a blank line, then the main body of the |
200 | The header section must be followed by a blank line, then the main body of the |
| 201 | text. |
201 | text. |
| 202 | |
202 | |
| 203 | The text body should be wrapped at 72 characters. No fancy formatting or tab |
203 | The text body should be wrapped at 72 characters. No fancy formatting or tab |
| 204 | characters should be used -- the news item may be being displayed directly to a |
204 | characters should be used -- the news item may be being displayed directly to a |
| 205 | terminal. Paragraphs should be separated by two blank lines. |
205 | terminal. Paragraphs should be separated by a blank line. |
| 206 | |
206 | |
| 207 | Hyperlinks may be used to refer to further information (for example, an upgrade |
207 | Hyperlinks may be used to refer to further information (for example, an upgrade |
| 208 | guide). However, the main body of the news item should be descriptive and not |
208 | guide). However, the main body of the news item should be descriptive and not |
| 209 | simply a "read this link" text. It is assumed that the user will have access to |
209 | simply a "read this link" text. It is assumed that the user will have access to |
| 210 | a web browser *somewhere*, but not necessarily on the box which is being |
210 | a web browser *somewhere*, but not necessarily on the box which is being |
| … | |
… | |
| 378 | |
378 | |
| 379 | :: |
379 | :: |
| 380 | |
380 | |
| 381 | # Copyright 1999-2005 Gentoo Foundation |
381 | # Copyright 1999-2005 Gentoo Foundation |
| 382 | # Distributed under the terms of the GNU General Public License v2 |
382 | # Distributed under the terms of the GNU General Public License v2 |
| 383 | # $Id: glep-0042.txt,v 1.1 2005/11/05 03:32:09 g2boojum Exp $ |
383 | # $Id: glep-0042.txt,v 1.2 2005/11/07 17:02:42 ciaranm Exp $ |
| 384 | |
384 | |
| 385 | DESCRIPTION="Read important Gentoo news items" |
385 | DESCRIPTION="Read important Gentoo news items" |
| 386 | MAINTAINER="ciaranm@gentoo.org" |
386 | MAINTAINER="ciaranm@gentoo.org" |
| 387 | SVN_DATE='$Date: 2005/11/05 03:32:09 $' |
387 | SVN_DATE='$Date: 2005/11/07 17:02:42 $' |
| 388 | VERSION=$(svn_date_to_version "${SVN_DATE}" ) |
388 | VERSION=$(svn_date_to_version "${SVN_DATE}" ) |
| 389 | |
389 | |
| 390 | get_news_item_list() { |
390 | get_news_item_list() { |
| 391 | [[ -d "${ROOT}/var/lib/gentoo/news" ]] || return |
391 | [[ -d "${ROOT}/var/lib/gentoo/news" ]] || return |
| 392 | ( |
392 | ( |