Mailing List Archive

On Thu, 01 Oct 2009 22:42:22 +0200
Rémi Cardona <remi@gentoo.org> wrote:
> I tried figuring out how to write one myself, but failed miserably
> because of the entirely non-intuitive GLEP.
>
> Basically, all stable users should see that news item.

You're failing miserably because you're looking at it entirely the
wrong way. Clearly, you don't want "all stable users" to see the news
item:

* You don't want stable users who don't have X installed to see the news
item.

* You don't want stable users who have already done the upgrade, or who
are installing from scratch after the news item has been written, to
see the news item.

What you do want is for anyone who has an old X server / an old libxcb
installed to see the news item. Thus, you want to use the
Display-If-Installed header with a < dependency specification.

--
Ciaran McCreesh

Rémi Cardona wrote:
> Hi guys,
>
> Could anyone write up a one-liner news item for the xorg-server 1.6
> stabilization with there 2 upgrade guides :
>
> http://www.gentoo.org/proj/en/desktop/x/x11/xorg-server-1.6-upgrade-guide.xml
>
>
> http://www.gentoo.org/proj/en/desktop/x/x11/libxcb-1.4-upgrade-guide.xml
>
>
> I tried figuring out how to write one myself, but failed miserably
> because of the entirely non-intuitive GLEP.
>
> Basically, all stable users should see that news item.
>
> Thanks in advance to the benevolent soul who will write it and commit
> it :)
>
> Thanks

Perhaps something simple like this? (HTH):


xorg-server 1.6.

We're pleased to announce the stabilization of xorg-server-1.6. Users
should review the following two guides before upgrading to 1.6:

http://www.gentoo.org/proj/en/desktop/x/x11/xorg-server-1.6-upgrade-guide.xml
http://www.gentoo.org/proj/en/desktop/x/x11/libxcb-1.4-upgrade-guide.xml

Thanks for the wording, I've somewhat made it a bit stronger.

@Dev, please ACK or NAK or whatever.

Thanks


Title: Migration to X.org Server 1.6 and libxcb 1.4
Author: Remi Cardona <remi@gentoo.org>
Content-Type: text/plain
Posted: 2009-10-02
Revision: 1
News-Item-Format: 1.0
Display-If-Installed: <x11-base/xorg-server-1.6
Display-If-Installed: <x11-libs/libxcb-1.4

We're pleased to announce the stabilization of xorg-server-1.6. Users
are strongly encouraged to read the following two guides before upgrading:

http://www.gentoo.org/proj/en/desktop/x/x11/xorg-server-1.6-upgrade-guide.xml
http://www.gentoo.org/proj/en/desktop/x/x11/libxcb-1.4-upgrade-guide.xml

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Rémi Cardona wrote:
> Title: Migration to X.org Server 1.6 and libxcb 1.4
> Author: Remi Cardona <remi@gentoo.org>
> Content-Type: text/plain
> Posted: 2009-10-02
> Revision: 1
> News-Item-Format: 1.0
> Display-If-Installed: <x11-base/xorg-server-1.6
> Display-If-Installed: <x11-libs/libxcb-1.4
>
> We're pleased to announce the stabilization of xorg-server-1.6. Users
> are strongly encouraged to read the following two guides before upgrading:

This should be wrapped to 72 characters/line.

>
> http://www.gentoo.org/proj/en/desktop/x/x11/xorg-server-1.6-upgrade-guide.xml
>
> http://www.gentoo.org/proj/en/desktop/x/x11/libxcb-1.4-upgrade-guide.xml
>
>

Otherwise, it looks good to me.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkrFqv4ACgkQOypDUo0oQOpRkQCfXrZOesfAdH7K8wLIta4Y+jm7
oTYAnjbp1onG/51oMmNV/dRXd4lrYUUE
=LDiJ
-----END PGP SIGNATURE-----

>>>>> On Fri, 02 Oct 2009, Rémi Cardona wrote:

> We're pleased to announce the stabilization of xorg-server-1.6. Users
> are strongly encouraged to read the following two guides before upgrading:

GLEP 42 says that you should wrap lines at 72 columns, where possible.

Ulrich

Le 02/10/2009 09:43, Ulrich Mueller a écrit :
>>>>>> On Fri, 02 Oct 2009, Rémi Cardona wrote:
>
>> We're pleased to announce the stabilization of xorg-server-1.6. Users
>> are strongly encouraged to read the following two guides before upgrading:
>
> GLEP 42 says that you should wrap lines at 72 columns, where possible.

And apart from the wrapping?

Nothing else to add?

Cheers,

Rémi

Rémi Cardona wrote:
> Le 02/10/2009 09:43, Ulrich Mueller a écrit :
>>>>>>> On Fri, 02 Oct 2009, Rémi Cardona wrote:
>>
>>> We're pleased to announce the stabilization of xorg-server-1.6. Users
>>> are strongly encouraged to read the following two guides before
>>> upgrading:
>>
>> GLEP 42 says that you should wrap lines at 72 columns, where possible.
>
> And apart from the wrapping?
>
> Nothing else to add?
>
> Cheers,
>
> Rémi
>

Remember to take this into consideration:
http://www.gentoo.org/proj/en/glep/glep-0042.html#news-item-quality-control

"Thus, at least 72 hours before a proposed news item is committed, it
must be posted to the gentoo-dev mailing list and Cc:ed to pr@gentoo.org
(exceptions may be made in exceptional circumstances). Any complaints —
for example regarding wording, clarity or accuracy — must be addressed
before the news item goes live."

pr@gentoo.org hasn't been CC:ed as far as I see.

Regards,
Petteri

On Fri, 02 Oct 2009 08:52:24 +0200
Rémi Cardona <remi@gentoo.org> wrote:

> Thanks for the wording, I've somewhat made it a bit stronger.
>
> @Dev, please ACK or NAK or whatever.

Looks good to me. (Both as a dev and as a PR member.)

Le 02/10/2009 10:22, Petteri Räty a écrit :
> "Thus, at least 72 hours before a proposed news item is committed, it
> must be posted to the gentoo-dev mailing list and Cc:ed to pr@gentoo.org
> (exceptions may be made in exceptional circumstances). Any complaints —
> for example regarding wording, clarity or accuracy — must be addressed
> before the news item goes live."
>
> pr@gentoo.org hasn't been CC:ed as far as I see.

Josh now has commented on it.

May I request a faster commit time since I didn't expect Samuli to
stabilize everything so quickly?

Rémi

Rémi Cardona wrote:
> May I request a faster commit time since I didn't expect Samuli to
> stabilize everything so quickly?
>

Yup - I wouldn't be surprised if within a few hours 80% of the concerned
users will have already installed it. Even if you send out the news now
anybody who synced overnight wouldn't get it in time anyway.

Might not hurt to log a blocker bug just to track the news item the next
time you consider a major upgrade like this. Then you don't actually
stabilize anything until AFTER the news goes out. :)

Rémi Cardona wrote:
> Le 02/10/2009 10:22, Petteri Räty a écrit :
>> "Thus, at least 72 hours before a proposed news item is committed,
>> it must be posted to the gentoo-dev mailing list and Cc:ed to
>> pr@gentoo.org (exceptions may be made in exceptional
>> circumstances). Any complaints — for example regarding wording,
>> clarity or accuracy — must be addressed before the news item goes
>> live."
>>
>> pr@gentoo.org hasn't been CC:ed as far as I see.
>
> Josh now has commented on it.
>
> May I request a faster commit time since I didn't expect Samuli to
> stabilize everything so quickly?
>

I'm not a dev; but I strongly agree that you get it out ASAP - I almost
upgraded two days ago :-)