Bug 450038

Summary:	Installation handbook lacks information about news items and eselect usage for handle them
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Pacho Ramos <pacho>
Component:	Installation Handbook	Assignee:	Sven Vermeulen (RETIRED) <swift>
Status:	RESOLVED FIXED
Severity:	enhancement	CC:	docs-team
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Pacho Ramos gentoo-dev

2013-01-03 18:31:03 UTC

I think Handbook should tell newcomers how to handle news items as it's needed to properly administrate their new Gentoo systems

Something like:
"Gentoo 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 eselect news module.

When you get:
$(Message portage shows when a new news item is present) (I don't remember the exact message)

You can run:
# eselect news read

To read it. With:
# eselect news list
You can see all present news items and running:
# eselect news purge
You can remove them once you are aware of their content.

For more information about eselect news usage, consult its man page:
# man news.eselect


Reproducible: Always

Comment 1 Sven Vermeulen (RETIRED) gentoo-dev

2013-01-20 18:11:41 UTC

Thanks; I've added in a subsection right after the tree merger (webrsync and optional --sync) as that is the point that the users will first come into contact with the "IMPORTANT: xx news items need reading" message.