On Sunday 11 December 2005 10:35, Ciaran McCreesh wrote:
> Whenever relevant unread news items are found, the package manager will
> create a file named ``/var/lib/portage/news/news.unread`` (if it does not
> already exist) and append the news item identifier (eg
> ``2005-11-01-yoursql-updates``) on a new line.
>
> .. Note:: Future changes to Portage involving support for multiple
> repositories may require one news list per repository. Assuming
> repositories have some kind of unique identifier, this file could be named
> ``news-repoid.unread``.

Repositories will definitely have a unique identifier. Perhaps it would be 
better to use the repository-identifing format from the beginning so that 
readers are forced to be forwards-compatible? Assuming the readers would then 
output the repository name, labeling it "gentoo" should work well...

> When a news item is read, its name should be removed from the
> ``news.unread`` file. News clients may add the name to a ``news.read`` file
> in the same directory with the same file format.

news.read should either be mandatory or not created at all. Should a user 
change from a reader that creates and uses the file to one that doesn't and 
then change back again the results will be unexpected.

>     * Important: there are 5 unread news items.
>     * Type emerge --help news to learn how to read news files.
[...]
> An ``eselect`` [#eselect]_ module shall be created as the 'suggested'
> display tool; other display tools (for example, a news to email forwarder,
> which would be ideal for users who sync on a ``cron``) are left as options
> for those who desire them.

By "suggested" you mean that it should be referenced in the news help?

--
Jason Stubbs
-- 
gentoo-dev@gentoo.org mailing list

Reply via email to