swift 13/01/20 18:11:00 Modified: hb-install-system.xml Log: Fix bug #450038 - Add information on news items, thanks to Pacho Ramos
Revision Changes Path 1.132 xml/htdocs/doc/en/handbook/hb-install-system.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.132&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.132&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.131&r2=1.132 Index: hb-install-system.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v retrieving revision 1.131 retrieving revision 1.132 diff -u -r1.131 -r1.132 --- hb-install-system.xml 20 Jan 2013 15:58:28 -0000 1.131 +++ hb-install-system.xml 20 Jan 2013 18:11:00 -0000 1.132 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.131 2013/01/20 15:58:28 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.132 2013/01/20 18:11:00 swift Exp $ --> <sections> @@ -14,7 +14,7 @@ to progress to that state. </abstract> -<version>23</version> +<version>24</version> <date>2013-01-20</date> <section> @@ -202,7 +202,43 @@ <p> If you are warned that a new Portage version is available and that you should -update Portage, you should do it now using <c>emerge --oneshot portage</c>. +update Portage, you should do it now using <c>emerge --oneshot portage</c>. You +might also be notified that "news items need reading". More on that next. +</p> + +</body> +</subsection> +<subsection> +<title>Reading News Items</title> +<body> + +<p> +When a Portage tree is synchronized to your system, Portage might warn you with +the following: +</p> + +<pre caption="Portage informing that news items are available"> + * IMPORTANT: 2 news items need reading for repository 'gentoo'. + * Use eselect news to read news items. +</pre> + +<p> +Portage news items were created to provide a communication medium to push +critical messages to users via the rsync tree. To manage them you will need to +use <c>eselect news</c>. With the <c>read</c> subcommand, you can read all news +items. With <c>list</c> you can get an overview of the available news items, and +with <c>purge</c> you can remove them once you have read them and have no +further need for the item(s) anymore. +</p> + +<pre caption="Handling Portage news"> +# <i>eselect news list</i> +# <i>eselect news read</i> +</pre> + +<p> +More information about the newsreader is available through its manual page: +<c>man news.eselect</c>. </p> </body>
