ISSUE-2391: Last Call Comment: better changes appendix

Last Call Comment: better changes appendix

State:
CLOSED
Product:
SVG 1.1 F2 Last Call
Raised by:
Chris Lilley
Opened on:
2010-11-18
Description:
Original email
http://lists.w3.org/Archives/Public/www-svg/2010Aug/0009.html

Hi everyone,


Again, I'm aware that the last call commenting period ended about a
month ago [1] but here goes: A couple of months ago, I made a few
local modifications in my CVS checkout of the public W3C repository
and, after a hint from Doug stating that the best way to share the
modifications was publishing them somewhere and link to them in the
mailing afterward (instead of sending them as attachments), this ended
up getting lost in my TODO stack. :-(


Although the "Changes" appendix is not normative, I suspect it will be
read over and over given the background from many coming from SVG 1.1;
therefore, I'm sharing a set of minor issues in the hope of polishing
this section as much as possible.

The complete list changes is available verbatim:
* changes.html [2] - complete appendix Q with all local modifications;
* changes.html.patch [3] - patch of modifications against the current
CVS version;
A short description of changes made (possibly not extensive) follows.

1. Trimmed trailing space, as well as other whitespace fixes across
the whole document.

2. Fixed missing comma in:
# Added the following terms: animation elements, animation event
attribute, conditional processing attribute, core attributes, document
event attribute, event attribute, filter primitive attributes, filter
primitive element, gradient element, graphical event attribute, light
source element, structural element text content child element and
XLink attributes.

3. Combined two very similar items:
# Clarified that the item passed into SVGNumberList's 'initialize',
'getItem', 'insertItemBefore', 'replaceItem' and 'appendItem' methods
is live.
# Clarified that the item passed into SVGLengthList's 'initialize',
'getItem', 'insertItemBefore', 'replaceItem' and 'appendItem' methods
is live.
Same in:
# Clarified that the item passed into SVGPointList's 'initialize',
'getItem', 'insertItemBefore', 'replaceItem' and 'appendItem' methods
is live.
# Clarified that the item passed into SVGTransformList's 'initialize',
'getItem', 'insertItemBefore', 'replaceItem' and 'appendItem' methods
is live.

4. Added link in getScreenCTM (for coherence with getBBox which
preceeds in the prose):
# Noted that the 'getScreenCTM' method would have been more aptly
named 'getClientCTM', but that the name is kept for historical reasons

5. Fixed typo in:
# Clarified that SVGTransform's 'matrix' member is like.
("like" --> "live")

6. Broke long list item into subitems:
# Made several clarifications to SVGTextContentElement: Allowed the
last character in a text content element to be measured with
getSubStringLength; Removed the INDEX_SIZE_ERR exception in
selectSubString and getSubStringLength for the cases where nchars is
greater than the number of characters.

7. Added period in:
# Removed restriction for ‘tref’ element on only pointing into an SVG
document fragment

8. Fixed sentence according to content to avoid a minor incoherence:
# Remove confusing language about SVGLoad event triggering and simply
say "The SVGLoad event does not bubble."


Hope this helps,
Helder


[1] http://lists.w3.org/Archives/Public/www-svg/2010Jun/0162.html
[2] http://heldermagalhaes.com/2010/08/changes.html
[3] http://heldermagalhaes.com/2010/08/changes.html.patch
Related Actions Items:
Related emails:
  1. SVG/profiles/1.1F2/DoC disco.xsl,1.4,1.5 dump.html,1.3,1.4 (from cvsmail@w3.org on 2011-05-04)
  2. Re: [SVG1.1F2 LC] Appendix Q: Several minor suggestions (from chris@w3.org on 2011-01-13)
  3. Re: {minutes} 9 December 2010 SVG WG telcon (from chris@w3.org on 2010-12-10)
  4. status update (from cam@mcc.id.au on 2010-11-25)
  5. Re: [SVG1.1F2 LC] Appendix Q: Several minor suggestions (from chris@w3.org on 2010-11-18)
  6. ISSUE-2391: Last Call Comment: better changes appendix [SVG 1.1 F2 Last Call] (from sysbot+tracker@w3.org on 2010-11-18)

Related notes:

ACTION: Accept

Chris Lilley, 9 Dec 2010, 21:20:44

CHANGE-TYPE: Editorial

Chris Lilley, 9 Dec 2010, 21:21:04

RESOLUTION: We will add a new changes appendix with changes since last call, and are open to a fuller additional appendix that lists all changes since first edition, but ask for help in organising this primer-like material.

Chris Lilley, 9 Dec 2010, 21:24:00

COMMENTER-RESPONSE: Accept

Chris Lilley, 13 Jan 2011, 20:40:59

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: 2391.html,v 1.1 2020/01/17 13:21:39 carcone Exp $