Re: [PATCH, doc] Fix PR documentation/44016

[Jonathan Wakely <jwakely dot gcc at gmail dot com>]

On 7 May 2010 22:03, Gerald Pfeifer wrote:
> On Fri, 7 May 2010, Jonathan Wakely wrote:
>>> I like it. ?Ok, and thanks!
>> would it make more sense for the docs in the 4.4 branch to link to the
>> 4.4 status page, and the docs in the 4.5 branch to link to the 4.5
>> status page?
>
> Yes, but -- that's yet another item for the release managers and yet
> another source for mistakes or omissions. ?As have happened for the
> last couple of releases as Ralf noticed.

Yes, I didn't mean to knock Ralf's change, which is definitely better
than it was. And I should have said I'd be willing to do the changes
to 4.4 and 4.5, and that leaving trunk pointing at the unversioned one
makes sense.

>> Those status pages will probably remain valid, and relate to the c++0x
>> support implemented in that branch, whereas the unversioned page is
>> going to be changed to track support in the trunk, and at some point
>> when the "0x" becomes "11" (or whatever) that page might disappear
>> completely, breaking the links.
>
> Did you look at the unversioned page? ?I did before acking the patch
> and it has nice pointers to the individual pages at a prominent place.

Guilty - I didn't check it.

> Also, I have a policy of not arbitrarily breaking links and so will
> make sure we have proper redirection in place (at least that's the
> plan ;-). ?And I kind of like the idea of giving users an easy way
> to compare the different versions and gently pull them towards a later
> one.

You've convinced me :-)
The link breaking was my main concern, but if it won't break then that's great.

I'll get back to fixing actual problems in the docs now ...

Jonathan