From: Sean Silva Date: Wed, 2 Jan 2013 21:50:48 +0000 (+0000) Subject: docs: Take advantage of extra level of headings. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e132c89dead982487e341bdc99c3b6b391ada5b1;p=clang 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 --- 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