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 7062 - replace terms "CDATA element" and "RCDATA element" with... something better
Summary: replace terms "CDATA element" and "RCDATA element" with... something better
Status: CLOSED NEEDSINFO
Alias: None
Product: HTML WG
Classification: Unclassified
Component: pre-LC1 HTML5 spec (editor: Ian Hickson) (show other bugs)
Version: unspecified
Hardware: All All
: P2 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL: http://www.whatwg.org/specs/web-apps/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-06-29 02:53 UTC by Michael[tm] Smith
Modified: 2010-10-04 14:31 UTC (History)
4 users (show)

See Also:


Attachments

Description Michael[tm] Smith 2009-06-29 02:53:37 UTC
http://www.whatwg.org/specs/web-apps/current-work/multipage/syntax.html#elements-0

The current draft uses the terms "CDATA element" to describe <script> and <style> elements, and "RCDATA element" to describe <title> and <textarea> elements.

I think it would be good to consider replacing those with other terms.

The problem is that "CDATA" already has a number of meanings[1] that conflict with one another.

[1]http://www.flightlab.com/~joe/sgml/cdata.html

So it seems less than ideal to introduce a new term that potentially adds even more ambiguity and confusion around what "CDATA" means.

All that said, I can't at the moment think of any better terms with which to replace CDATA and RCDATA and that would themselves be accurate and less confusing. 

But maybe other people have some some specific suggestions.
Comment 1 Michael[tm] Smith 2009-06-29 03:26:26 UTC
Maybe just "replaceable character data" for RCDATA, and "non-replaceable character data" for CDATA.
Comment 2 Ian 'Hixie' Hickson 2009-08-08 01:41:16 UTC
I replaced CDATA with "raw text". Would you like me to change RCDATA also?
Comment 3 Michael[tm] Smith 2009-08-08 13:23:36 UTC
(In reply to comment #2)
> I replaced CDATA with "raw text". Would you like me to change RCDATA also?

If you're going with "raw text", then maybe RCDATA could be "replaceable text" or "parsed text".

Comment 4 Ian 'Hixie' Hickson 2009-08-08 19:12:32 UTC
I don't think either of those is any clearer than RCDATA, to be honest. Replaceable how? How is it parsed any more or less than "raw text"?
Comment 5 Simon Pieters 2009-08-20 22:16:00 UTC
RCDATA stands for "replaceable character data", so "replaceable text" seems like a better term for it, along with a note saying it means text that can have character references.
Comment 6 Michael[tm] Smith 2009-08-21 01:46:42 UTC
(In reply to comment #5)
> RCDATA stands for "replaceable character data", so "replaceable text" seems
> like a better term for it, along with a note saying it means text that can have
> character references.

Calling it any kind of "text" at all, and thus needing to add a note to say that it's text that can contain character references, is the reason I suggested "replaceable character data" initially.

What the spec currently defines as "text" cannot contain character references. Also, what it defines "text" has two possible forms:

   - "raw" text that is allowed to contain unparsed markup characters
   - "non-raw" text that is not allowed to contain unparsed markup characters

...where "unparsed markup characters" essentially means the character "<" and the strings "<!--" and "-->".

So there are three ways in which the text/html syntax allows those two forms of text to be combined with character references:

  1. non-raw text that can be combined with character references
  2. raw text that can be combined with character references (RCDATA)
  3. raw text that cannot be combined character references

One way to describe the above more succinctly is:

  1. normal character data
  2. replaceable character data
  3. non-replaceable character data

Or maybe "raw character data" would be a better term for #3 (which is what the spec now calls "raw text" and which it previously called "CDATA").

But regardless, the term "character data" seems very useful as a general term for describing all three of those possible combinations, and each of them could be defined specifically by preceding "character data" with some adjective to describe what type of character data it is.
Comment 7 Ian 'Hixie' Hickson 2009-09-07 10:19:05 UTC
I don't see why we'd use "character data" instead of the simpler "text".

Distinguishing between "normal text" and "replaceable text" leads to the question of in what sense "normal text" isn't "replaceable".

So I'm still at a loss for a better term than the opaque "RCDATA".
Comment 8 Michael[tm] Smith 2009-09-09 04:07:29 UTC
(In reply to comment #7)
> I don't see why we'd use "character data" instead of the simpler "text".

Because text, as defined in the spec, cannot contain character references. So it's useful to have a term that means "text mixed with character references".

> Distinguishing between "normal text" and "replaceable text" leads to the
> question of in what sense "normal text" isn't "replaceable".

Yeah, I agree that's a problem with choosing any non-opaque term.

> So I'm still at a loss for a better term than the opaque "RCDATA".

I agree that the term "RCDATA element" as defined in the spec is unambiguous.

So... lacking anything new to say here and no better suggestions than what I've given so far, I'm fine with you moving this to FIXED if you don't think there are any remaining changes that could be made.
Comment 9 Maciej Stachowiak 2010-03-14 14:48:21 UTC
This bug predates the HTML Working Group Decision Policy.

If you are satisfied with the resolution of this bug, please change the state of this bug to CLOSED. If you have additional information and would like the editor to reconsider, please reopen this bug. If you would like to escalate the issue to the full HTML Working Group, please add the TrackerRequest keyword to this bug, and suggest title and text for the tracker issue; or you may create a tracker issue yourself, if you are able to do so. For more details, see this document:
  http://dev.w3.org/html5/decision-policy/decision-policy.html

This bug is now being moved to VERIFIED. Please respond within two weeks. If this bug is not closed, reopened or escalated within two weeks, it may be marked as NoReply and will no longer be considered a pending comment.