diff options
| author | Sean Silva <silvas@purdue.edu> | 2013-01-02 21:50:48 +0000 |
|---|---|---|
| committer | Sean Silva <silvas@purdue.edu> | 2013-01-02 21:50:48 +0000 |
| commit | e132c89dead982487e341bdc99c3b6b391ada5b1 (patch) | |
| tree | 40f889d7122670cd1ba2dc158d73ad3731039125 /docs/index.rst | |
| parent | 1a090f1b239889d0b48e1413152e88ed07e6e09d (diff) | |
docs: Take advantage of extra level of headings.
The way Sphinx treats the "top-level" adornments is weird. It usually
uses the first top-level adornment as the page title, even if the
top-level adornment is just one "section" out of many (i.e. if the first
section is "Introduction", then it will make the page title be
"Introduction"). This behavior can be overriden by using an explicit
`.. title::` directive to set the title.
Since the Sphinx stylesheet that Clang is currently using ('haiku')
nicely puts the document title at the top of the page in the header,
this weird default behavior was resulting in a redundant "title" in the
body content. Getting rid of this redundant level of headings
effectively "exposes" one more level of heading from the stylesheet to
which now makes the real "sections" more distinct.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@171417 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/index.rst')
| -rw-r--r-- | docs/index.rst | 9 |
1 files changed, 4 insertions, 5 deletions
diff --git a/docs/index.rst b/docs/index.rst index 6436beeeb0..55f714239c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -3,8 +3,7 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to Clang's documentation! -================================= +.. title:: Welcome to Clang's documentation! .. toctree:: :maxdepth: 1 @@ -12,7 +11,7 @@ Welcome to Clang's documentation! ReleaseNotes Using Clang as a Compiler -------------------------- +========================= .. toctree:: :maxdepth: 1 @@ -24,7 +23,7 @@ Using Clang as a Compiler MemorySanitizer Using Clang as a Library ------------------------- +======================== .. toctree:: :maxdepth: 1 @@ -41,7 +40,7 @@ Using Clang as a Library JSONCompilationDatabase Design Documents ----------------- +================ .. toctree:: :maxdepth: 1 |