[cfe-commits] r170278 - /cfe/trunk/docs/AutomaticReferenceCounting.rst

[Sean Silva]

Themes don't play any role whatsoever with the automatic section
numbering, only the section structure does. reST doesn't attach any
special meaning to adornments, whichever it sees first in the document
is the "top-level", then the first it sees nested in that one is the
"second level", etc. This patch doesn't actually change the document
structure in any way, since all I did is change which adornment is
used for each level so that it is "semantically" correct given our
chosen format. If I had added

==============================================
Objective-C Automatic Reference Counting (ARC)
==============================================

at the top then it would have changed the document structure and you
would have seen the issue you mention.

btw the section structure of this document *is* completely broken here
and must be fixed (see my reply to the commit email for the conversion
of AutomaticReferenceCounting).

-- Sean Silva

On Sat, Dec 15, 2012 at 5:43 PM, Dmitri Gribenko <gribozavr at gmail.com> wrote:
> On Sunday, December 16, 2012, Sean Silva wrote:
>>
>> Author: silvas
>> Date: Sat Dec 15 18:23:40 2012
>> New Revision: 170278
>>
>> URL: http://llvm.org/viewvc/llvm-project?rev=170278&view=rev
>> Log:
>> docs: Fix completely broken adornment structure.
>>
>> The adornment:
>>
>> ===
>> Foo
>> ===
>>
>> is for titles, not sections.
>>
>> Modified:
>>     cfe/trunk/docs/AutomaticReferenceCounting.rst
>
>
> Hello Sean,
>
> This was actually done for a reason: with the LLVM theme automatic section
> numbering was wrong: "1." was prepended to every number.  Apparently this is
> not an issue with this other theme.  Thank you for fixing!
>
> Dmitri
>
>
>
> --
> main(i,j){for(i=2;;i++){for(j=2;j<i;j++){if(!(i%j)){j=0;break;}}if
> (j){printf("%d\n",i);}}} /*Dmitri Gribenko <gribozavr at gmail.com>*/