image and object attributes in lang spec need work

["Grosso, Paul" <pgrosso@ptc.com>]

The writeup in the lang spec for the image and object attributes 
doesn't reflect what I sent Don and Michael last March--unfortunately,
it looks like I never sent my text to the list, but just to Don
and Michael:
http://lists.oasis-open.org/archives/dita/200603/msg00016.html
Sorry about that.

Attached to this message is what I sent out last March--the lang
spec should be updated to reflect this.

paul
Graphic image sizing changes require modifications
to two areas:  the image element and the object element
in the language reference.  Feel free to reword as
you see fit.

I am suggesting we don't change the scale attribute 
in %display-atts, since that is mostly about scaling
text.  (However, we might correct "accomodation" to be
"accommodation" in the Description of the scale attribute.)

I am not suggesting we add the scale attribute to the
object element at this time (though I wouldn't be opposed
if the TC felt that made more sense).

No changes are needed in the Architectural Specification.

The image element
=================
http://docs.oasis-open.org/dita/v1.0/langspec/image.html

first para
----------
Replace:

 The <image> element has optional attributes that indicate
 whether the placement of the included graphic or artwork
 should be inline (like a button or icon), or on a separate
 line for a larger image. 

with:

 The <image> element has optional attributes that indicate
 whether the placement of the included graphic or artwork
 should be inline (like a button or icon) or on a separate
 line for a larger image.  There are also optional attributes
 that indicate the size to which the included graphic or artwork
 should be scaled.

(That is, remove the bogus comma in the existing sentence
and add the additional sentence.)

under Attributes
----------------
Replace the height attribute's description with:

 Indicates the vertical dimension for the resulting image
 display. If necessary, the image is scaled to the specified
 size. The value of this attribute is a real number optionally
 following by a unit of measure from the set of pc, pt, px, in,
 cm, mm, em (picas, points, pixels, inches, centimeters,
 millimeters, and ems respectively).  The default unit is px
 (pixels). Possible values include: "5", "5in", and "10.5cm".
 If a height value is specified and no width value is specified,
 the width will be scaled by the same factor as the height.
 If both a height value and width value are specified, some
 implementations may not be able to scale the two directions
 by a different factor and may therefore ignore one of the
 two values.


Replace the width attribute's description with:

 Indicates the horizontal dimension for the resulting image
 display. If necessary, the image is scaled to the specified
 size. The value of this attribute is a real number optionally
 following by a unit of measure from the set of pc, pt, px, in,
 cm, mm, em (picas, points, pixels, inches, centimeters,
 millimeters, and ems respectively).  The default unit is px
 (pixels). Possible values include: "5", "5in", and "10.5cm".
 If a width value is specified and no height value is specified,
 the height will be scaled by the same factor as the width.
 If both a height value and width value are specified, some
 implementations may not be able to scale the two directions
 by a different factor and may therefore ignore one of the
 two values.


Add the "scale" attribute to the attribute list:

 Description:  Specifies a percentage by which to scale the
  image in the absence of any specified image height or
  width; a value of 100 implies that the image should be
  presented at its intrinsic size.  If a value has been
  specified for this image's height or width attribute
  (or both), the scale attribute is ignored.

 Data Type:  NMTOKEN whose value space is an unsigned integer

 Value:  #IMPLIED

 Required?:  No


You might glance at "Specifing the Content Area" in the DocBook
documentation for imagedata at
http://docbook.org/tdg/en/html/imagedata.html
for more background on this topic.


The object element
==================
http://docs.oasis-open.org/dita/v1.0/langspec/object.html

under Attributes
----------------
Replace the height attribute's description with:

 Indicates the vertical dimension for the resulting object 
 display. If necessary, the object is scaled to the specified
 size. The value of this attribute is a real number optionally
 following by a unit of measure from the set of pc, pt, px, in,
 cm, mm, em (picas, points, pixels, inches, centimeters,
 millimeters, and ems respectively).  The default unit is px
 (pixels). Possible values include: "5", "5in", and "10.5cm".
 If a height value is specified and no width value is specified,
 the width will be scaled by the same factor as the height.
 If both a height value and width value are specified, some
 implementations may not be able to scale the two directions
 by a different factor and may therefore ignore one of the
 two values.


Replace the width attribute's description with:

 Indicates the horizontal dimension for the resulting object 
 display. If necessary, the object is scaled to the specified
 size. The value of this attribute is a real number optionally
 following by a unit of measure from the set of pc, pt, px, in,
 cm, mm, em (picas, points, pixels, inches, centimeters,
 millimeters, and ems respectively).  The default unit is px
 (pixels). Possible values include: "5", "5in", and "10.5cm".
 If a width value is specified and no height value is specified,
 the height will be scaled by the same factor as the width.
 If both a height value and width value are specified, some
 implementations may not be able to scale the two directions
 by a different factor and may therefore ignore one of the
 two values.