mirrors/llvm-project
0
0
Fork 0
mirror of https://github.com/llvm/llvm-project.git synced 2025-04-27 19:06:05 +00:00
Code Issues Projects Releases Wiki Activity
llvm-project/clang/docs/index.rst

93 lines
1.5 KiB
ReStructuredText
Raw Normal View History

docs: Initial Sphinx setup for Clang. I don't think this will be visible just yet on <clang.llvm.org/docs/> since I don't think that the necessary server-side setup has taken place. Don't shoot me over the theme. I don't want to duplicate LLVM's theme into the clang repo at the moment, so I just used one of Sphinx's default themes. llvm-svn: 170042
2012-12-12 23:02:30 +00:00
.. Clang documentation master file, created by
sphinx-quickstart on Sun Dec 9 20:01:55 2012.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
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. llvm-svn: 171417
2013-01-02 21:50:48 +00:00
.. title:: Welcome to Clang's documentation!
docs: Initial Sphinx setup for Clang. I don't think this will be visible just yet on <clang.llvm.org/docs/> since I don't think that the necessary server-side setup has taken place. Don't shoot me over the theme. I don't want to duplicate LLVM's theme into the clang repo at the moment, so I just used one of Sphinx's default themes. llvm-svn: 170042
2012-12-12 23:02:30 +00:00
.. toctree::
docs: Decrease toctree depth on landing page. Having the table of contents there was making it hard to easily see at a glance all the docs we have. llvm-svn: 171376
2013-01-02 12:39:50 +00:00
:maxdepth: 1
docs: Initial Sphinx setup for Clang. I don't think this will be visible just yet on <clang.llvm.org/docs/> since I don't think that the necessary server-side setup has taken place. Don't shoot me over the theme. I don't want to duplicate LLVM's theme into the clang repo at the moment, so I just used one of Sphinx's default themes. llvm-svn: 170042
2012-12-12 23:02:30 +00:00
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
ReleaseNotes
Using Clang as a Compiler
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. llvm-svn: 171417
2013-01-02 21:50:48 +00:00
=========================
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
.. toctree::
:maxdepth: 1
UsersManual
docs: Reorganize landing page. Language extensions are highly relevant to using clang as a compiler, so move LanguageExtensions up into `Using Clang as a Compiler` on the landing page. The other documents from the now-gone `Language Extensions and Specs` section on the landing page nicely fit hierarchically under LanguageExtensions.rst, so put them under LanguageExtensions.rst's toctree instead of on the landing page. Impetus from Jordan Rose. llvm-svn: 171409
2013-01-02 21:03:11 +00:00
LanguageExtensions
Until attribute documentation is implemented as a server-side feature, I will be manually committing AttributeReference.rst so that attribute documentation can be on the live server instead of simply disappearing from the language extensions page without obvious replacement. This is a temporary stop-gap solution until server-side generation is implemented, at which point the AttributeReference.rst will go back to holding placeholder text. llvm-svn: 201733
2014-02-19 23:09:37 +00:00
AttributeReference
Add a mode to clang-tblgen to generate reference documentation for warning and remark flags. For now I'm checking in a copy of the built documentation, but we can replace this with a placeholder (as we do for the attributes reference documentation) once we enable building this server-side. llvm-svn: 281192
2016-09-12 05:58:29 +00:00
DiagnosticsReference
Adding cross-compilation instructions to Clang llvm-svn: 190281
2013-09-08 20:44:39 +00:00
CrossCompilation
Updated documentation for Thread Safety Analysis. llvm-svn: 201598
2014-02-18 19:42:01 +00:00
ThreadSafetyAnalysis
docs: More reST conversion. Sorry for the large commit, but it is much faster to convert in batches. llvm-svn: 170067
2012-12-13 01:10:46 +00:00
AddressSanitizer
Documentation: add MemorySanitizer to the toctree llvm-svn: 171003
2012-12-23 18:35:58 +00:00
ThreadSanitizer
MemorySanitizer
Clang documentation for UBSan. Summary: Create a separate page describing UBSan tool, move the description of fine-grained checks there, provide extra information about supported platforms, symbolization etc. This text is compiled from four parts: * Existing documentation copied from User's Manual * Layout used in documentation for another sanitizers (ASan, MSan etc.) * Text written from scratch * Small parts taken from Michael Morrison's attempt at creating UBSan page: http://lists.llvm.org/pipermail/llvm-commits/Week-of-Mon-20141215/249503.html Reviewers: kcc, rsmith, silvas Subscribers: tberghammer, danalbert, srhines, kcc Differential Revision: http://reviews.llvm.org/D15217 llvm-svn: 254733
2015-12-04 17:30:29 +00:00
UndefinedBehaviorSanitizer
Add support for -fsanitize-blacklist and default blacklists for DFSan. Also add some documentation. Differential Revision: http://llvm-reviews.chandlerc.com/D1346 llvm-svn: 188403
2013-08-14 18:54:18 +00:00
DataFlowSanitizer
Rewrite docs/LeakSanitizer.rst. Add it to index. llvm-svn: 196957
2013-12-10 20:10:30 +00:00
LeakSanitizer
Add clang/docs/SanitizerCoverage.rst Moved from https://code.google.com/p/address-sanitizer/wiki/AsanCoverage llvm-svn: 235643
2015-04-23 20:40:04 +00:00
SanitizerCoverage
Introduce -fsanitize-stats flag. This is part of a new statistics gathering feature for the sanitizers. See clang/docs/SanitizerStats.rst for further info and docs. Differential Revision: http://reviews.llvm.org/D16175 llvm-svn: 257971
2016-01-16 00:31:22 +00:00
SanitizerStats
Documentation for sanitizer special case list format and -f(no-)?sanitize-blacklist flag llvm-svn: 187871
2013-08-07 08:23:32 +00:00
SanitizerSpecialCaseList
Implement Control Flow Integrity for virtual calls. This patch introduces the -fsanitize=cfi-vptr flag, which enables a control flow integrity scheme that checks that virtual calls take place using a vptr of the correct dynamic type. More details in the new docs/ControlFlowIntegrity.rst file. It also introduces the -fsanitize=cfi flag, which is currently a synonym for -fsanitize=cfi-vptr, but will eventually cover all CFI checks implemented in Clang. Differential Revision: http://reviews.llvm.org/D7424 llvm-svn: 230055
2015-02-20 20:30:56 +00:00
ControlFlowIntegrity
Re-apply r267784, r267824 and r267830. I have updated the compiler-rt tests. llvm-svn: 267903
2016-04-28 17:09:37 +00:00
LTOVisibility
Protection against stack-based memory corruption errors using SafeStack: Clang command line option and function attribute This patch adds the -fsanitize=safe-stack command line argument for clang, which enables the Safe Stack protection (see http://reviews.llvm.org/D6094 for the detailed description of the Safe Stack). This patch is our implementation of the safe stack on top of Clang. The patches make the following changes: - Add -fsanitize=safe-stack and -fno-sanitize=safe-stack options to clang to control safe stack usage (the safe stack is disabled by default). - Add __attribute__((no_sanitize("safe-stack"))) attribute to clang that can be used to disable the safe stack for individual functions even when enabled globally. Original patch by Volodymyr Kuznetsov and others at the Dependable Systems Lab at EPFL; updates and upstreaming by myself. Differential Revision: http://reviews.llvm.org/D6095 llvm-svn: 239762
2015-06-15 21:08:13 +00:00
SafeStack
[docs] Document the source-based code coverage feature Differential Revision: http://reviews.llvm.org/D20715 llvm-svn: 271454
2016-06-02 00:51:50 +00:00
SourceBasedCodeCoverage
More documentation on the module map language. llvm-svn: 177704
2013-03-22 06:21:35 +00:00
Modules
Add Clang docs about MSVC compatibility This documents some of the status of supported functionality in MSVC quirks mode. Some of this should be in http://clang.llvm.org/compatibility.html instead when things have stabilized. llvm-svn: 202559
2014-02-28 23:46:04 +00:00
MSVCCompatibility
[docs] Add ThinLTO user documentation Summary: Add some user facing documentation on ThinLTO and how to use it. Reviewers: mehdi_amini Subscribers: mehdi_amini, cfe-commits Differential Revision: https://reviews.llvm.org/D24806 llvm-svn: 282089
2016-09-21 16:57:03 +00:00
ThinLTO
Sphinx-based clang man pages Summary: This diff introduces .rst files, Sphinx config, and a CMake target for building clang man pages. This will deprecate the existing .pod- based man page, and will integrate nicely with CMake. This diff does not remove the existing man page; that will be done in a follow-up once packagers have had a chance to react to the change. For now, only clang(1) has been done; others can be added over time by dropping additional files into the docs/CommandGuide directory. The index page for CommandGuide has been copied from LLVM's docs/CommandGuide. The man page itself is mostly the same, with a few minor cosmetic changes. The only major change is the SYNOPSIS section. I was unable to get .rst/Sphinx produce the same style as in the existing man page. Instead, I changed it to match the LLVM tools' relatively simple style. To build the man pages, use the "docs-clang-man" target if building with CMake. Otherwise, use "make -f Makefile.sphinx man". Reviewers: cmatthews, silvas Subscribers: dim, gaeke, beanz, cfe-commits Differential Revision: http://reviews.llvm.org/D10562 llvm-svn: 241037
2015-06-30 02:52:38 +00:00
CommandGuide/index
Clang docs: add some information about the difference between 'clang' and 'clang -cc1' This is coming up again and again on the mailing list and IRC. llvm-svn: 171656
2013-01-06 13:38:34 +00:00
FAQ
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
Using Clang as a Library
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. llvm-svn: 171417
2013-01-02 21:50:48 +00:00
========================
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
.. toctree::
:maxdepth: 1
Tooling
[docs] Rename to permit wider variety of content. I don't want to rule out the possibility of linking to e.g. interesting blog posts about uses of Clang, so avoid restricting the content to "projects". This breaks URL compatibility, but this document was committed less than an hour ago so hopefully nobody has linked to it yet. llvm-svn: 175535
2013-02-19 17:29:01 +00:00
ExternalClangExamples
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
IntroductionToTheClangAST
LibTooling
Add documentation for clang-format. This adds documentation for both LibFormat as well as the standalone tools and integrations built on top of it. It slightly restructures the ClangTools documentation. llvm-svn: 172004
2013-01-09 21:49:28 +00:00
LibFormat
docs: More reST conversion. Sorry for the large commit, but it is much faster to convert in batches. llvm-svn: 170067
2012-12-13 01:10:46 +00:00
ClangPlugins
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
RAVFrontendAction
LibASTMatchersTutorial
LibASTMatchers
docs: More reST conversion. Sorry for the large commit, but it is much faster to convert in batches. llvm-svn: 170067
2012-12-13 01:10:46 +00:00
HowToSetupToolingForLLVM
JSONCompilationDatabase
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
Add documentation for clang-format. This adds documentation for both LibFormat as well as the standalone tools and integrations built on top of it. It slightly restructures the ClangTools documentation. llvm-svn: 172004
2013-01-09 21:49:28 +00:00
Using Clang Tools
=================
.. toctree::
:maxdepth: 1
ClangTools
ClangCheck
ClangFormat
Added documentation for clang-format style options. Summary: The main contents is in the ClangFormatStyleOptions.rst, which can be updated from the Format.h by the dump_format_style.py script. Reviewers: djasper, klimek Reviewed By: klimek CC: cfe-commits Differential Revision: http://llvm-reviews.chandlerc.com/D1597 llvm-svn: 189946
2013-09-04 15:09:13 +00:00
ClangFormatStyleOptions
Add documentation for clang-format. This adds documentation for both LibFormat as well as the standalone tools and integrations built on top of it. It slightly restructures the ClangTools documentation. llvm-svn: 172004
2013-01-09 21:49:28 +00:00
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
Design Documents
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. llvm-svn: 171417
2013-01-02 21:50:48 +00:00
================
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
.. toctree::
:maxdepth: 1
Documentation: convert InternalsManual.html to reST Patch by Anastasi Voitova with with small fixes by me. llvm-svn: 170275
2012-12-15 20:41:17 +00:00
InternalsManual
docs: Convert DriverInternals to reST. llvm-svn: 170812
2012-12-21 00:16:53 +00:00
DriverInternals
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
PTHInternals
PCHInternals
NFC fix documentation build by rL263015 This time I hope it will fix the build for real. llvm-svn: 263052
2016-03-09 19:39:16 +00:00
ItaniumMangleAbiTags
docs: Reorganize landing page. I clustered the docs by some intuitive/fuzzy notion of "similarity", and some reasonable categories seemed to materialize. I tried to give the clusters useful names, but you may want to take a look at the landing page (<http://clang.llvm.org/docs/> for the lazy) and share your thoughts. I have to say, this small change really gives the docs a whole new life! It makes our documentation quite a bit easier to navigate and scope out. llvm-svn: 171379
2013-01-02 12:41:24 +00:00
docs: Initial Sphinx setup for Clang. I don't think this will be visible just yet on <clang.llvm.org/docs/> since I don't think that the necessary server-side setup has taken place. Don't shoot me over the theme. I don't want to duplicate LLVM's theme into the clang repo at the moment, so I just used one of Sphinx's default themes. llvm-svn: 170042
2012-12-12 23:02:30 +00:00
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
Reference in New Issue Copy Permalink