… | |
… | |
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> |