Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 100443 - Change &emdash;&endash to —/– entities in GuideXML
Summary: Change &emdash;&endash to —/– entities in GuideXML
Status: VERIFIED FIXED
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: Guide XML (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Xavier Neys (RETIRED)
URL:
Whiteboard:
Keywords:
: 100441 (view as bug list)
Depends on:
Blocks:
 
Reported: 2005-07-27 01:38 UTC by Alexey Chumakov (RETIRED)
Modified: 2005-07-27 02:34 UTC (History)
1 user (show)

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


Attachments
book.dtd char entities fixed (book.dtd.patch,919 bytes, patch)
2005-07-27 01:39 UTC, Alexey Chumakov (RETIRED)
Details | Diff
guide.dtd char entities fixed (guide.dtd.patch,576 bytes, patch)
2005-07-27 01:39 UTC, Alexey Chumakov (RETIRED)
Details | Diff
inserts.dtd char entities fixed (inserts.dtd.patch,720 bytes, patch)
2005-07-27 01:39 UTC, Alexey Chumakov (RETIRED)
Details | Diff
metadoc.dtd char entities fixed (metadoc.dtd.patch,720 bytes, patch)
2005-07-27 01:39 UTC, Alexey Chumakov (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 01:38:18 UTC
There was my proposal to add dash entities to guide.dtd etc.
I suggested (erroneously) two options to do that:
one was &emdash;, and the other was —
That was my mistake.

Right (and official) names are at http://www.w3.org/2003/entities/

Later on I found that &emdash or &endash is used rarely, but is confusing
instead: all of Xml Docbook/ Dita / XHTML / TEI etc use — and –
Xavier said it's irrelevant but it isn't: why introduce more chaos?
Anybody using it will have to remember: "Endash here, Ndash there, Mdash there,
Ndash here" :-)

Hopefully, nobody except myself had time to use that entities in real documents
at the moment!

PLEASE! Change &emdash to &mdash, and &endash to &ndash ASAP.
I'll then take care of forthcoming Russian docs.

I'll also found that characher entity declarations differ between DTDs where
they shouldn't. It is corrected, too.

Patches are encosed.
Comment 1 Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 01:39:02 UTC
Created attachment 64415 [details, diff]
book.dtd char entities fixed
Comment 2 Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 01:39:14 UTC
Created attachment 64416 [details, diff]
guide.dtd char entities fixed
Comment 3 Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 01:39:24 UTC
Created attachment 64417 [details, diff]
inserts.dtd char entities fixed
Comment 4 Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 01:39:34 UTC
Created attachment 64418 [details, diff]
metadoc.dtd char entities fixed
Comment 5 Jakub Moc (RETIRED) gentoo-dev 2005-07-27 01:42:40 UTC
*** Bug 100441 has been marked as a duplicate of this bug. ***
Comment 6 Xavier Neys (RETIRED) gentoo-dev 2005-07-27 02:21:26 UTC
(In reply to comment #0)
> Xavier said it's irrelevant but it isn't: why introduce more chaos?

You had stated only ndash was ok in html and that is irrelevant because those
entities are replaced and do not appear as an entity in html.
If you prefer ndash/mdash. I don't care. I'll change them provided no one else
has started using them.

> I'll also found that characher entity declarations differ between DTDs where
> they shouldn't. It is corrected, too.

You shouldn't have.
metadoc/inserts do not really need them. They are seldom changed and if you need
a "funky char", just type it.

As for the "missing' entities, they are not missing.
They were introduced into guide.dtd only because they have been used in a few
old files and it was more convenient to add them than to hunt for those files
and fix them and their invalid xml.

Only characters that are really very difficult or impossible to type should be
available as an entity.
In order:
Always use   instead of ' ' because you can't 'see' them
Use the character itself, or its entity if you really can't ype it
Avoid (hexa)decimal entities that make the text difficult to read.
Comment 7 Xavier Neys (RETIRED) gentoo-dev 2005-07-27 02:30:41 UTC
e{m,n}dash replaced by {m,n}dash
Comment 8 Alexey Chumakov (RETIRED) gentoo-dev 2005-07-27 02:34:05 UTC
Thank you!