Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 15537 - conflicting XML syntax examples
Summary: conflicting XML syntax examples
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: Documentation Guide (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-02-11 21:09 UTC by Joshua Kinard
Modified: 2003-02-15 11:13 UTC (History)
0 users

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Joshua Kinard gentoo-dev 2003-02-11 21:09:33 UTC
Code Section 2.3 illustrates some commonly used XML syntax examples.  The oddity
occurs where the example shows the <i> tag, which seems to be a replica of the
<c> tag.  Further below, Code Section 2.4 shows the output of section 2.3, and
below, only explains the <c> tag, but gives no mention to the <i> tag.  Both
tags work, however, and both produce the same HTML output when run through
xsltproc.  

I believe either the <i> tag should be explained, or replaced with the <c> tag
to avoid confusion.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 John Davis (zhen) (RETIRED) gentoo-dev 2003-02-15 11:13:08 UTC
Well, this is done for a reason. We have both tags, because one could be used for code blocks, and the other for plain emphasis. The reason that the HTML is the same, and only one of the tags is documented is flexibility. We keep both of these tags so that if we want to change something in the future, it can be done easily.