Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 53000 - Changes to /dtd/book.dtd broke amd64 docs
Summary: Changes to /dtd/book.dtd broke amd64 docs
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: AMD64 Project
URL: http://www.gentoo.org/proj/en/base/am...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-06-04 11:15 UTC by Peter Penkala
Modified: 2004-06-15 09:38 UTC (History)
1 user (show)

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


Attachments
/proj/en/base/amd64/install-software.xml (install-software.xml,11.78 KB, text/plain)
2004-06-05 02:07 UTC, Xavier Neys (RETIRED)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Peter Penkala gentoo-dev 2004-06-04 11:15:17 UTC
"For a little more info on this topic, see these mailing list archives:

    * http://lists.suse.com/archive/suse-AMD64/2003-Dec/0031.html
    * http://lists.suse.com/archive/suse-AMD64/2003-Dec/0034.html

And you can see it's not a Gentoo-specific problem!"

The links 404 for me.  Changing "suse-AMD64" to "suse-amd64" seems to point to the correct info.
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2004-06-05 01:56:00 UTC
/proj documents are maintained by project teams themselves.
Comment 2 Xavier Neys (RETIRED) gentoo-dev 2004-06-05 02:07:28 UTC
Created attachment 32687 [details]
/proj/en/base/amd64/install-software.xml

Fixed the bug and made doc DTD-compliant (otherwise cvs would reject it).
In short, <warn> <note> <impo> <ul> elements may not be appear under a <p>
element, they need to be on the same level.

BTW, any reason you are using 
<!DOCTYPE sections SYSTEM "http://www.gentoo.org/dtd/book.dtd">
instead of the preferred
<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> ?

You are forcing a request to www.g.o when you run xmllint locally and also
force cvs.g.o to access www.g.o at commit time. The latter uses local files.
Check http://www.gentoo.org/doc/en/doc-tipsntricks.xml#doc_chap2_pre3 to know
more.

Feel free to contact me if you need any help.
Comment 3 Danny van Dyk (RETIRED) gentoo-dev 2004-06-05 13:49:54 UTC
I tried to commit the change Xavier suggested, but i got lots of xml errors. Asking in -doc explained me that the book.dtd has been changed and our xml docs turned invalid, cause we use <pre> inside <li>. (e.g. in /xml/htdocs/proj/en/amd64/bugs.xml)
Swift: Can those changes be undone, or do you see a way around this mess ? We'd like to have our docs valid again and with the same structure they have atm.
Comment 4 Danny van Dyk (RETIRED) gentoo-dev 2004-06-14 15:03:07 UTC
Ok, i fixed did both fix the dtd lines and made all remaining xml files DTD-compliant again. I consider this as fixed.
Comment 5 Peter Penkala gentoo-dev 2004-06-15 06:51:21 UTC
Unless the website still hasn't reflected the changes, I think the original problem still exists.  If the links are working, just ignore me.
Comment 6 Xavier Neys (RETIRED) gentoo-dev 2004-06-15 08:52:21 UTC
Attached file hasn't been committed indeed.

Files have been made DTD-compliant but the issue that triggered this bug hasn't been fixed.
Please use amd64 in lowecase in the mentioned URL. Thanks.
Comment 7 Danny van Dyk (RETIRED) gentoo-dev 2004-06-15 09:38:44 UTC
Sorry, i assumed xavier had already "fixed" the original bug.

"Fixed the bug and made doc DTD-compliant (otherwise cvs would reject it).
In short, <warn> <note> <impo> <ul> elements may not be appear under a <p>
element, they need to be on the same level."

I misunderstood that ;-)

In CVS now.