Bug 14883 – xml-guide tweaks

• Status: RESOLVED FIXED
• Product: [OLD] Docs-developer

[Description SpanKY 2003-01-31 18:27:56 UTC]

Code listing 1.1: Transforming gentoo-x86-install.xml 
# cd gentoo-web/xsl 
# xsltproc guide.xsl ../doc/<your lang>/gentoo-x86-install.xml > /tmp/install.html 
 
this *should* read 
# xsltproc guide-main[-<your lang>].xsl ../xml/doc/<your lang>/gentoo-x86-install.xml > 
/tmp/install.html

[Comment 1 SpanKY 2003-01-31 18:51:32 UTC]

decided to add some more rather than make new bugs ;) ... 
 
in Code Listing 2.3, i think it would be more information if you had this: 
<pre caption="A code caption!"> 
instead of just 
<pre> 
 
and then update the actual Code Listing source too ;) 

[Comment 2 SpanKY 2003-01-31 19:05:59 UTC]

the only other thing i could think of is to include a small table/section on what chars are 
valid and which ones arent ... 
for example, you cant use '&' or '<' inside xml tags ... this fails: 
<title>a & b</title> 
but this works: 
<title>a &amp; b</title> 
 
you could link to here for a better ref ... 
http://www.w3.org/TR/html4/charset.html 

[Comment 3 Martin Holzer (RETIRED) 2003-02-14 08:44:08 UTC]

The link http://www.gentoo.org/dyn/doc-snapshots on the page
http://www.gentoo.org/doc/en/xml-guide.xml gave a 'page not found' error. 

[Comment 4 Rajiv Aaron Manglani (RETIRED) 2003-02-21 01:11:18 UTC]

the issue as described in comment #3 has been fixed.

[Comment 5 Sven Vermeulen (RETIRED) 2003-08-28 10:38:24 UTC]

I think all this is handled. Stoyan, I think you can close this bug.

[Comment 6 Andrew Cooks (RETIRED) 2003-12-06 03:59:08 UTC]

Resolving this bug as fixed as per comment #5