]> git.lizzy.rs Git - rust.git/commit
librustdoc/html: recognize slices not to nest A tags.
authorNODA, Kai <nodakai@gmail.com>
Sat, 27 Sep 2014 16:15:31 +0000 (00:15 +0800)
committerNODA, Kai <nodakai@gmail.com>
Wed, 8 Oct 2014 12:36:30 +0000 (20:36 +0800)
commitf40b60b0e46512e204225ce42c702ce23c943232
tree19f42794f256b98fe3e2782471268afd73b1195a
parentbc649ba8f803913a23c767d57be01c693cd03d8a
librustdoc/html: recognize slices not to nest A tags.

1. A slice of parametrized type, say
   BorrowedRef { ... Vector(Generic(T)) }, is rendered as
   "<a href='primitive.slice.html'>&amp;[T]</a>"
2. A slice of other types, say
   BorrowedRef { ... Vector(int) }, is rendered as
   "<a href='primitive.slice.html'>&amp;[</a>
    <a href='primitive.int.html'>int</a>
    <a href='primitive.slice.html'>]</a>"
3. Other cases, say BorrowedRef { ... int }, are
   rendered as same as before:
   "&<a href='primitive.int.html'>int</a>"

Relevant W3C specs:
- http://www.w3.org/TR/html401/struct/links.html#h-12.2.2
  12.2.2 Nested links are illegal
- http://www.w3.org/TR/html5/text-level-semantics.html#the-a-element
  states A tag must not enclose any "interactive contents"
  which include A tags themselves.
src/librustdoc/html/format.rs