| … | |
… | |
| 112 | <h1><a class="toc-backref" href="#id16" name="requirements">Requirements</a></h1> |
112 | <h1><a class="toc-backref" href="#id16" name="requirements">Requirements</a></h1> |
| 113 | <p>An adequate solution must meet all of the following requirements:</p> |
113 | <p>An adequate solution must meet all of the following requirements:</p> |
| 114 | <dl class="docutils"> |
114 | <dl class="docutils"> |
| 115 | <dt>Preemptive</dt> |
115 | <dt>Preemptive</dt> |
| 116 | <dd>Users should be told of changes <em>before</em> they break the user's system, |
116 | <dd>Users should be told of changes <em>before</em> they break the user's system, |
| 117 | after the damage has already been done.</dd> |
117 | not after the damage has already been done.</dd> |
| 118 | <dt>No user subscription required</dt> |
118 | <dt>No user subscription required</dt> |
| 119 | <dd>It has already been demonstrated <a class="footnote-reference" href="#forums-whining" id="id1" name="id1">[4]</a> that many users do not |
119 | <dd>It has already been demonstrated <a class="footnote-reference" href="#forums-whining" id="id1" name="id1">[4]</a> that many users do not |
| 120 | read the <tt class="docutils literal"><span class="pre">gentoo-announce</span></tt> mailing list or <tt class="docutils literal"><span class="pre">RSS</span></tt> feeds. A solution which |
120 | read the <tt class="docutils literal"><span class="pre">gentoo-announce</span></tt> mailing list or <tt class="docutils literal"><span class="pre">RSS</span></tt> feeds. A solution which |
| 121 | requires subscription has no advantage over current methods.</dd> |
121 | requires subscription has no advantage over current methods.</dd> |
| 122 | <dt>No user monitoring required</dt> |
122 | <dt>No user monitoring required</dt> |
| … | |
… | |
| 255 | <h3><a class="toc-backref" href="#id21" name="news-item-body">News Item Body</a></h3> |
255 | <h3><a class="toc-backref" href="#id21" name="news-item-body">News Item Body</a></h3> |
| 256 | <p>The header section must be followed by a blank line, then the main body of the |
256 | <p>The header section must be followed by a blank line, then the main body of the |
| 257 | text.</p> |
257 | text.</p> |
| 258 | <p>The text body should be wrapped at 72 characters. No fancy formatting or tab |
258 | <p>The text body should be wrapped at 72 characters. No fancy formatting or tab |
| 259 | characters should be used -- the news item may be being displayed directly to a |
259 | characters should be used -- the news item may be being displayed directly to a |
| 260 | terminal. Paragraphs should be separated by two blank lines.</p> |
260 | terminal. Paragraphs should be separated by a blank line.</p> |
| 261 | <p>Hyperlinks may be used to refer to further information (for example, an upgrade |
261 | <p>Hyperlinks may be used to refer to further information (for example, an upgrade |
| 262 | guide). However, the main body of the news item should be descriptive and not |
262 | guide). However, the main body of the news item should be descriptive and not |
| 263 | simply a "read this link" text. It is assumed that the user will have access to |
263 | simply a "read this link" text. It is assumed that the user will have access to |
| 264 | a web browser <em>somewhere</em>, but not necessarily on the box which is being |
264 | a web browser <em>somewhere</em>, but not necessarily on the box which is being |
| 265 | administrated -- this will be the case on may servers and routers, for example.</p> |
265 | administrated -- this will be the case on may servers and routers, for example.</p> |
| … | |
… | |
| 414 | <h2><a class="toc-backref" href="#id33" name="simple-eselect-news-client">Simple <tt class="docutils literal docutils literal"><span class="pre">eselect</span></tt> News Client</a></h2> |
414 | <h2><a class="toc-backref" href="#id33" name="simple-eselect-news-client">Simple <tt class="docutils literal docutils literal"><span class="pre">eselect</span></tt> News Client</a></h2> |
| 415 | <p>A demonstration <tt class="docutils literal"><span class="pre">eselect</span></tt> news display script follows:</p> |
415 | <p>A demonstration <tt class="docutils literal"><span class="pre">eselect</span></tt> news display script follows:</p> |
| 416 | <pre class="literal-block"> |
416 | <pre class="literal-block"> |
| 417 | # Copyright 1999-2005 Gentoo Foundation |
417 | # Copyright 1999-2005 Gentoo Foundation |
| 418 | # Distributed under the terms of the GNU General Public License v2 |
418 | # Distributed under the terms of the GNU General Public License v2 |
| 419 | # $Id: glep-0042.html,v 1.1 2005/11/05 03:33:17 g2boojum Exp $ |
419 | # $Id: glep-0042.html,v 1.2 2005/11/07 17:02:42 ciaranm Exp $ |
| 420 | |
420 | |
| 421 | DESCRIPTION="Read important Gentoo news items" |
421 | DESCRIPTION="Read important Gentoo news items" |
| 422 | MAINTAINER="ciaranm@gentoo.org" |
422 | MAINTAINER="ciaranm@gentoo.org" |
| 423 | SVN_DATE='$Date: 2005/11/05 03:33:17 $' |
423 | SVN_DATE='$Date: 2005/11/07 17:02:42 $' |
| 424 | VERSION=$(svn_date_to_version "${SVN_DATE}" ) |
424 | VERSION=$(svn_date_to_version "${SVN_DATE}" ) |
| 425 | |
425 | |
| 426 | get_news_item_list() { |
426 | get_news_item_list() { |
| 427 | [[ -d "${ROOT}/var/lib/gentoo/news" ]] || return |
427 | [[ -d "${ROOT}/var/lib/gentoo/news" ]] || return |
| 428 | ( |
428 | ( |
| … | |
… | |
| 659 | |
659 | |
| 660 | </div> |
660 | </div> |
| 661 | <div class="footer"> |
661 | <div class="footer"> |
| 662 | <hr class="footer" /> |
662 | <hr class="footer" /> |
| 663 | <a class="reference" href="glep-0042.txt">View document source</a>. |
663 | <a class="reference" href="glep-0042.txt">View document source</a>. |
| 664 | Generated on: 2005-11-05 03:32 UTC. |
664 | Generated on: 2005-11-07 17:01 UTC. |
| 665 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
665 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
| 666 | |
666 | |
| 667 | </div> |
667 | </div> |
| 668 | </body> |
668 | </body> |
| 669 | </html> |
669 | </html> |