W3C home > Mailing lists > Public > www-style@w3.org > August 2013

Re: [css3-text] indices and animatable

From: John Daggett <jdaggett@mozilla.com>
Date: Wed, 21 Aug 2013 16:38:18 -0700 (PDT)
To: "Tab Atkins Jr." <jackalmage@gmail.com>
Cc: fantasai <fantasai.lists@inkedblade.net>, www-style list <www-style@w3.org>
Message-ID: <1872244820.4458981.1377128298085.JavaMail.zimbra@mozilla.com>

Tab Atkins wrote:

> That's how the index works.  Again, auto-generated.  It just takes
> the |-separated content of the title='' attribute, or else the text
> content of the definition, and adds them to the index.
 
I'm aware it's auto-generated via the 'title' attribute.  My point was
the resulting index needs cleaning up.  For example, the "tab size"
entry really isn't a definition in this case, it justs says "the tab
size is given by the ‘tab-size’ property."

> > For property values, I would suggest using indents rather than
> > entries like "text-justify:auto". Switch from
> > title="text-justify:auto" to title="text-justify!!auto" and the
> > preprocessor will indent this for you.
>
> Once I move Text over to bikeshed, those titles will go away anyway.
> I don't see the value in using the !! syntax here, since the
> properties are already documented in the property index.

It's useful to have an index that's listed alphabetically (see the
index for Fonts) since the property table is listed by property name
and not by value.  And the !! behavior is needed to be able to
distinguish between multiple items that take the same name. For
example, the 'font-weight' property and 'font-weight' descriptor.

It's also puzzling why the index ends up with a '.' at the end of all
section numbers.

Cheers,

John Daggett
Received on Wednesday, 21 August 2013 23:38:44 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 21 August 2013 23:38:44 UTC