Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 90896 - broken overview.xml after removal of 2.6-koutput* files [pt_br, da, nl, fi, ko, ro, cs]
Summary: broken overview.xml after removal of 2.6-koutput* files [pt_br, da, nl, fi, k...
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Translated Documentation (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: Xavier Neys (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-04-29 13:46 UTC by Jan Kundrát (RETIRED)
Modified: 2005-05-03 13:00 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
da/metadoc.xml.patch (metadoc.xml.patch,1.30 KB, patch)
2005-04-29 13:47 UTC, Jan Kundrát (RETIRED)
Details | Diff
cs/metadoc.xml.patch (metadoc.xml.patch,1.42 KB, patch)
2005-04-29 13:57 UTC, Jan Kundrát (RETIRED)
Details | Diff
fi/metadoc.xml.patch (metadoc.xml.patch,1.35 KB, patch)
2005-04-29 13:57 UTC, Jan Kundrát (RETIRED)
Details | Diff
ko/metadoc.xml.patch (metadoc.xml.patch,1.40 KB, patch)
2005-04-29 13:57 UTC, Jan Kundrát (RETIRED)
Details | Diff
nl/metadoc.xml.patch (metadoc.xml.patch,1.46 KB, patch)
2005-04-29 13:58 UTC, Jan Kundrát (RETIRED)
Details | Diff
pt_br/metadoc.xml.patch (metadoc.xml.patch,1.33 KB, patch)
2005-04-29 13:58 UTC, Jan Kundrát (RETIRED)
Details | Diff
ro/metadoc.xml.patch (metadoc.xml.patch,1.37 KB, patch)
2005-04-29 13:58 UTC, Jan Kundrát (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:46:06 UTC
After removal of xml/htdocs/doc/en 2.6-koutput-user.xml 2.6-koutput.xml, access to overview.xml leads into 500 internal server error on mentioned languages. This has been caused by the fact that those languages' metadoc.xml are still referring to those non-existing files.

Patches will be attached.
Comment 1 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:47:43 UTC
Created attachment 57606 [details, diff]
da/metadoc.xml.patch
Comment 2 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:57:24 UTC
Created attachment 57608 [details, diff]
cs/metadoc.xml.patch
Comment 3 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:57:41 UTC
Created attachment 57609 [details, diff]
fi/metadoc.xml.patch
Comment 4 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:57:59 UTC
Created attachment 57610 [details, diff]
ko/metadoc.xml.patch
Comment 5 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:58:16 UTC
Created attachment 57612 [details, diff]
nl/metadoc.xml.patch
Comment 6 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:58:33 UTC
Created attachment 57613 [details, diff]
pt_br/metadoc.xml.patch
Comment 7 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:58:49 UTC
Created attachment 57614 [details, diff]
ro/metadoc.xml.patch
Comment 8 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 13:59:46 UTC
I think that's all. I've added the <version> tag to the files where it was missing as well.
Comment 9 Flammie Pirinen (RETIRED) gentoo-dev 2005-04-29 14:12:48 UTC
Already patched in fi (but darn, forgot to bump the version). But this really needs to be taken care of some other way, we can't have overview.xml breaking whenever something gets deleted. Or at very least someone who updates en/metadoc.xml in these cases needs to update others as well?
Comment 10 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 14:20:44 UTC
re comment 9:
it's possible, I'm using metadoc.xml got through Apache as I don't have CVS access (yet, neysx :-) ), so the files might be < 1 hour outdated.

If I'm not mistaken, some other languages (it?) are already fixed, too,
but they still contain old version.

Possible solution could be "don't remove file without prior notice, wait
at least x days and *then* remove *and* update metadoc.xml of languages whose maintainers didn't respond".
Comment 11 Jan Kundrát (RETIRED) gentoo-dev 2005-04-29 14:21:26 UTC
Comment on attachment 57609 [details, diff]
fi/metadoc.xml.patch

fixed in CVS by flammie
Comment 12 Marcelo Goes (RETIRED) gentoo-dev 2005-04-29 14:38:30 UTC
Comment on attachment 57613 [details, diff]
pt_br/metadoc.xml.patch

fixed in pt_br
Comment 13 Xavier Neys (RETIRED) gentoo-dev 2005-04-29 14:51:23 UTC
Thanks for all the trouble of making those patches. It's faster to edit the files than to download, apply, clean up, but thanks anyway.
I had looked at the fr/overview.xml only but that one did not actually try to document() the en/2-6-kout*xml files.

All traces of 2.6-kout*xml removed, I hope.

At the moment, the only way to not have overview.xml break whenever a file is removed is to edit all metadoc.xml files that reference it.
Comment 14 Jan Kundrát (RETIRED) gentoo-dev 2005-05-02 13:22:46 UTC
Hmm, same problem after removal of /proj/en/releng/catalyst/reference.xml, blame "wolf31o2" :-).

Affected languages are pt_br, da, nl, it, ko and es; others seems fixed (or non-existing :-)).
Comment 15 Marcelo Goes (RETIRED) gentoo-dev 2005-05-02 13:44:19 UTC
fixed in pt_br
Comment 16 Chris Gianelloni (RETIRED) gentoo-dev 2005-05-02 13:45:59 UTC
Well, I plan on "adjusting" the catalyst documentation quite a bit in the near future.  I wasn't even aware that anyone had translated any of it.  Anyway, I don't have any access to "fix" this, so I'm not sure why I even needed to be added to the CC... *grin*

Personally, I would prefer everyone remove any links to any catalyst docs period until after catalyst 2.0 is released, as there will be documentation for both catalyst 1.x and 2.x, as they are different enough to warrant the major version number bump.
Comment 17 Jan Kundrát (RETIRED) gentoo-dev 2005-05-02 13:50:02 UTC
re comment 16:
I've added you as your commit broke 10 dynamically generated pages under gentoo.org/doc/. Could you please announce on gentoo-doc ml before removing doc files listed in doc/en/metadoc.xml? It is used to keep track of modified files for translators.

(But as I'm not a Gentoo developer, feel free to ignore me.)
Comment 18 Chris Gianelloni (RETIRED) gentoo-dev 2005-05-03 04:37:51 UTC
Sorry, I was unaware that anything under gentoo/proj was mirrored under gentoo/doc, or even linked from there.  I'll send out notifications in the future, but I can tell you right now that everything except catalyst's index.xml is going to disappear... ;]
Comment 19 Xavier Neys (RETIRED) gentoo-dev 2005-05-03 09:09:26 UTC
Reopening this bug for a different problem was a bad idea.
Fixed anyway.
Comment 20 Xavier Neys (RETIRED) gentoo-dev 2005-05-03 09:37:35 UTC
*** Bug 91323 has been marked as a duplicate of this bug. ***
Comment 21 Jan Kundrát (RETIRED) gentoo-dev 2005-05-03 13:00:10 UTC
re comment 19:
Sorry, I thought it was similar (well, the reason was almost same).