This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 15566 - Phrases like "is treated as", "computes to" are unnecessarily vague
Summary: Phrases like "is treated as", "computes to" are unnecessarily vague
Status: NEW
Alias: None
Product: CSS
Classification: Unclassified
Component: CSS Level 2 (show other bugs)
Version: unspecified
Hardware: All Windows 3.1
: P2 normal
Target Milestone: ---
Assignee: Bert Bos
QA Contact: public-css-bugzilla
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-01-15 10:14 UTC by Anton P
Modified: 2012-12-04 00:51 UTC (History)
1 user (show)

See Also:

Attachments

Description Anton P 2012-01-15 10:14:36 UTC 
Reported by Peter Moulder

10.5 ('height'):
  # <percentage>
  # [...] computes to [...]

10.7 ('min-height', 'max-height'):
  # <percentage>
  # [...] is treated as [...]

Such phrases should be replaced with more explicit ones, such as "The computed value is", etc.

Conversation begins:
Bug description:
http://lists.w3.org/Archives/Public/www-style/2011Sep/0008.html

Bug description:
http://lists.w3.org/Archives/Public/www-style/2011Sep/0011.html
Comment 1 Anton P 2012-02-04 16:27:01 UTC 
Another example, reported by Anton Prowse

The last sentence of 9.3.1 (Choosing a positioning scheme: 'position' property) is:

   # User agents may treat position as 'static' on the root element.

What does this actually mean?  That the used value is 'static'?

(Also, this information could ideally be repeated in 9.7 (Relationships 
between 'display', 'position', and 'float').)

See: http://lists.w3.org/Archives/Public/www-style/2011Jan/0087.html (Issue 5)
Comment 2 Tab Atkins Jr. 2012-07-12 22:14:07 UTC 
"computes to" isn't vague at all. It means exactly what it says - it's defining the computed value.

If it's used in any other manner, it's an error and should be reported as such.