ISSUE-2122: Inconsistent usage of quotes and/or apostrophe in markup

quotes vs apostrophe

Inconsistent usage of quotes and/or apostrophe in markup

State:
CLOSED
Product:
SVG 1.2 Tiny: Last Call
Raised by:
Doug Schepers
Opened on:
2008-10-13
Description:
Helder Magalhães
<http://lists.w3.org/Archives/Public/www-svg/2008Oct/0107.html>:
[[
9. Inconsistent usage of quotes and/or apostrophe in markup

I noticed several inconsistent usages of the delimiter for attribute
values in XML markup. For example, in "entity.svg" [GENERAL], current
markup even shows both within the same document:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE svg [
<!ENTITY Smile "
<rect x='.5' y='.5' width='29' height='39' fill='black' stroke='red'/>

While I though the use of quotes was mandatory, it was quick to find a
similar example in the XML specification [XMLLANG], so it's probably
just an old myth in my mind. Few more samples of these mixed usage,
now in property definition [LINKING]:

xlink:type = 'simple'
[...]
target = '_replace' | '_self' | '_parent' | '_top' | '_blank' | "<frame-target>"
[...]
focusable = "true" | "false" | "auto"

Nevertheless, I'd generally recommend using the delimiter character
consistently. I can think of cases where simpler implementations,
which will tend to have less support for special (?) cases in XML
parsing, may potentially fail to render SVG content for a somehow
unrelated issue.

[GENERAL] http://www.w3.org/TR/SVGMobile12/single-page.html
[XMLLANG] http://www.w3.org/TR/2006/REC-xml-20060816/#sec-lang-tag

]]

<http://lists.w3.org/Archives/Public/www-svg/2008Oct/0107.html>:
[[
The spec text gives the following definition for the target attribute of the
'a' element:
target = '_replace' | '_self' | '_parent' | '_top' | '_blank' |
"<frame-target>" but the attribute table says:
target = '_replace' | '_self' | '_parent' | '_top' | '_blank' | <XML-Name>

The spec text for handler says:
ev:event = "<string>"
but the attribute table says:
ev:event = <XML-NMTOKEN>

The spec text for listener says:
event = 'Event Identifier'
but the attribute table says:
event = <XML-NMTOKEN>

Also, the general syntax sometimes is confusing: for example:
preserveAspectRatio = "[defer] <align> [<meet>]" should rather be something
like:
preserveAspectRatio = ["defer"] <align> [<meet>]
There are several examples in this case.
]]
Related Actions Items:
No related actions
Related emails:
  1. SVG/profiles/1.2T doc-svgt12.html,NONE,1.1 (from cvsmail@w3.org on 2008-10-28)
  2. Re: [1.2T-LC] Comments and suggestions, mainly regarding the Linking section (ISSUE-2122) (from helder.magalhaes@gmail.com on 2008-10-14)
  3. Re: [1.2T-LC] Comments and suggestions, mainly regarding the Linking section (ISSUE-2122) (from schepers@w3.org on 2008-10-13)
  4. Re: [1.2T-LC] Comments and suggestions, mainly regarding the Linking section (from schepers@w3.org on 2008-10-13)
  5. ISSUE-2122 (quotes vs apostrophe): Inconsistent usage of quotes and/or apostrophe in markup [Last Call: SVG 1.2 Tiny ] (from sysbot+tracker@w3.org on 2008-10-13)

Related notes:

Minor editorial, will make corrections as time permits. Will concentrate on delimiters used in keyword markup.

Doug Schepers, 13 Oct 2008, 22:21:38

Immediate changes made as requested, explanation given. Commenter satisfied: Changed as requested. Commenter satisfied:

Doug Schepers, 16 Oct 2008, 21:12:38

Display change log ATOM feed


Dirk Schulze <dschulze@adobe.com>, Chair, Chris Lilley <chris@w3.org>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 2122.html,v 1.1 2020/01/17 13:19:45 carcone Exp $