1249944 - text-indent documentation first sentence is incorrect

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: CSS, defect, P5)

Description

[s.mackesey]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

The first sentence here is:

"The text-indent property specifies how much horizontal space should be left before the beginning of the first line of the text content of an element."

This is incorrect because keywords (e.g. "hanging") can be used to make the indent apply to other lines than the first line. This is confusing enough that when I was searching for how to achieve hanging indent functionality, when I first looked at the text-indent page I figured I needed to find a solution elsewhere because of the first sentence.

Comment 1

[Eric Shepherd [:sheppy]]

It's worth noting that since the |hanging| property is experimental and not in the specification, the text is technically correct in relation to what the spec officially supports. However, I've updated the text to be more clear:

https://developer.mozilla.org/en-US/docs/Web/CSS/text-indent

Comment 2

[Jean-Yves Perrier [:teoli]]

So hanging is not in the spec and not supported by any browser? I'm curious why do we document it then? If this is indeed the case, it may only confuse the readers.

Comment 3

[Eric Shepherd [:sheppy]]

(In reply to Jean-Yves Perrier [:teoli] from comment #2)
> So hanging is not in the spec and not supported by any browser? I'm curious
> why do we document it then? If this is indeed the case, it may only confuse
> the readers.

How did that sentence wind up in there? That's weird. It *is* in the specification. I originally wrote that sentence while inadvertently looking at an old version of the spec. Thought I'd deleted the sentence, but I guess I hadn't.

It *is* part of CSS3.

Comment 4

[Jean-Yves Perrier [:teoli]]

I'm still curious about the second part, the fact that no browser support it. Is this true?

Comment 5

[Eric Shepherd [:sheppy]]

(In reply to Jean-Yves Perrier [:teoli] from comment #4)
> I'm still curious about the second part, the fact that no browser support
> it. Is this true?

I can't find any evidence otherwise. It appears that no browsers have implemented them yet.

Comment 6

[Jean-Yves Perrier [:teoli]]

So this propriety will not (for now at least) solve the OP problem ;-)

Comment 7

[Eric Shepherd [:sheppy]]

(In reply to Jean-Yves Perrier [:teoli] from comment #6)
> So this propriety will not (for now at least) solve the OP problem ;-)

Nope. Sadly. But at least the doc is less confusing when describing this technology that works in 0.0% of browsers worldwide. :)