[Clang][Docs] Simpler syntax for Github links. (#82746)

Github links in release notes are often invalid rST, clutter the release
notes and are annoying to write.

This introduces a sphynx plugin

[Clang][Docs] Simpler syntax for Github links. (#82746)

Github links in release notes are often invalid rST, clutter the release
notes and are annoying to write.

This introduces a sphynx plugin that rewrites
`#GH<NUMBER>` to a link to the corresponding issue.

show more ...

[Docs] Allow building man pages without myst_parser (#82402)

The man pages do not depend on the doc present in markdown files, so
they can be built without myst_parser.
Doing so might allow llvm d

[Docs] Allow building man pages without myst_parser (#82402)

The man pages do not depend on the doc present in markdown files, so
they can be built without myst_parser.
Doing so might allow llvm distributions to have less development
dependencies.

As we do not have the ennvironment to test these configuration, this
capability is provided on a best-effort basis.

This restores a capability accidentally lost in #65664.

show more ...

Reland "Add Documentation for Execution Results Handling in Clang-Repl (#65650)"

Original commit message: "

Add Documentation for Execution Results Handling in Clang-Repl (#65650)

[clang-repl]

Reland "Add Documentation for Execution Results Handling in Clang-Repl (#65650)"

Original commit message: "

Add Documentation for Execution Results Handling in Clang-Repl (#65650)

[clang-repl] Add Documentation for Execution Results Handling.

This patch adds documentation for execution results handling in
Clang-REPL with
the below features:

- Automatic Printf feature
- Value Synthesis feature
- Pretty Printing feature

Continuing this work https://reviews.llvm.org/D156858 with this PR. I am
issuing this patch on behalf of Saqib.

"

This reverts commit ac32d7b87f4d4b546eea96b9b722e88fdb3a5b49.

The new patch resolves the layering violation by simply not trying to look if
`dot` was installed. This is consistent with what we do other extensions.

After this patch we will need `sphinx.ext.graphviz` extension (part of the `dot`
package) which is available via anyway if we build the doxygen-based
documentation.

show more ...

Revert "Add Documentation for Execution Results Handling in Clang-Repl (#65650)"

This reverts commit b9b8fc4878b6f7708f2ca2df6036a9c7bb5077b0.

This uses a function defined in LLVM's config-ix insid

Revert "Add Documentation for Execution Results Handling in Clang-Repl (#65650)"

This reverts commit b9b8fc4878b6f7708f2ca2df6036a9c7bb5077b0.

This uses a function defined in LLVM's config-ix inside clang.
config-ix is a non-exported cmake module, so this is a layering
violation.

show more ...

Add Documentation for Execution Results Handling in Clang-Repl (#65650)

[clang-repl] Add Documentation for Execution Results Handling.

This patch adds documentation for execution results handling

Add Documentation for Execution Results Handling in Clang-Repl (#65650)

[clang-repl] Add Documentation for Execution Results Handling.

This patch adds documentation for execution results handling in
Clang-REPL with
the below features:

- Automatic Printf feature
- Value Synthesis feature
- Pretty Printing feature


Continuing this work https://reviews.llvm.org/D156858 with this PR. I am
issuing this patch on behalf of Saqib.

Reviewers:
@vgvassilev
@junaire

show more ...

[Documentation] Replace recommonmark by myst-parser (#65664)

Recommonmark has been deprecated, then archived last year. This was
tracked by: https://github.com/llvm/llvm-iwg/issues/30

See https:

[Documentation] Replace recommonmark by myst-parser (#65664)

Recommonmark has been deprecated, then archived last year. This was
tracked by: https://github.com/llvm/llvm-iwg/issues/30

See https://github.com/readthedocs/recommonmark

This patch migrates all our doc to use myst

Additional details for bot maintainers: https://discourse.llvm.org/t/maintenance-required-on-sphinx-build-bots/73612

show more ...

Revert "[clang-repl] Add Documentation for Execution Results Handling."

This reverts commit 3edd338a6407d9410f6a283c5dc32ba676ac0b8f due to missing
graphviz https://lab.llvm.org/buildbot/#/builders/

Revert "[clang-repl] Add Documentation for Execution Results Handling."

This reverts commit 3edd338a6407d9410f6a283c5dc32ba676ac0b8f due to missing
graphviz https://lab.llvm.org/buildbot/#/builders/92/builds/49520

show more ...

[clang-repl] Add Documentation for Execution Results Handling.

This patch adds documentation for execution results handling in Clang-REPL with
the below features:

* Automatic Printf feature
* V

[clang-repl] Add Documentation for Execution Results Handling.

This patch adds documentation for execution results handling in Clang-REPL with
the below features:

* Automatic Printf feature
* Value Synthesis feature
* Pretty Printing feature

I am issuing this patch on behalf of @QuillPusher

Differential revision: https://reviews.llvm.org/D156858

show more ...

[NFC][Py Reformat] Reformat python files in clang and clang-tools-extra

This is an ongoing series of commits that are reformatting our
Python code.

Reformatting is done with `black`.

If you end up

[NFC][Py Reformat] Reformat python files in clang and clang-tools-extra

This is an ongoing series of commits that are reformatting our
Python code.

Reformatting is done with `black`.

If you end up having problems merging this commit because you
have made changes to a python file, the best way to handle that
is to run git checkout --ours <yourfile> and then reformat it
with black.

If you run into any problems, post to discourse about it and
we will try to help.

RFC Thread below:

https://discourse.llvm.org/t/rfc-document-and-standardize-python-code-style

Reviewed By: MatzeB

Differential Revision: https://reviews.llvm.org/D150761

show more ...

Remove 'modindex' from the Clang docs

This was added in the initial commit to use Sphinx ~12 years ago, but
is a dead link in our docs. Removing it and the python bits that appear
to be unused.

[docs] Remove hard-coded version numbers from sphinx configs

This updates all the non-runtime project release notes to use the
version number from CMake instead of the hard-coded version numbers
in

[docs] Remove hard-coded version numbers from sphinx configs

This updates all the non-runtime project release notes to use the
version number from CMake instead of the hard-coded version numbers
in conf.py.

It also hides warnings about pre-releases when the git suffix
is dropped from the LLVM version in CMake.

Reviewed By: MaskRay

Differential Revision: https://reviews.llvm.org/D112181

show more ...

[clang][docs][dataflow] Added an introduction to dataflow analysis

This documentation supports the dataflow analysis framework (see "[RFC]
A dataflow analysis framework for Clang AST" on cfe-dev).

[clang][docs][dataflow] Added an introduction to dataflow analysis

This documentation supports the dataflow analysis framework (see "[RFC]
A dataflow analysis framework for Clang AST" on cfe-dev).

Since the implementation of the framework has not been committed yet,
right now the doc describes dataflow analysis in general.

Since this is the first markdown document in clang/docs, I added support
for Markdown to clang/docs/conf.py in the same way as it is done in
llvm/docs.

Reviewed By: xazax.hun

Differential Revision: https://reviews.llvm.org/D114231

show more ...

[docs] Bump the trunk major version to 13 and update copyright year.

Bump the trunk major version to 12

and clear the release notes.

Bump the trunk major version to 11

and clear the release notes.

Bump the trunk version to 10.0.0svn

and clear the release notes.

llvm-svn: 366427

[analyzer] Creating standard Sphinx documentation

The lack of documentation has been a long standing issue in the Static Analyzer,
and one of the leading reasons behind this was a lack of good docum

[analyzer] Creating standard Sphinx documentation

The lack of documentation has been a long standing issue in the Static Analyzer,
and one of the leading reasons behind this was a lack of good documentation
infrastucture.

This lead serious drawbacks, such as
* Not having proper release notes for years
* Not being able to have a sensible auto-generated checker documentations (which
lead to most of them not having any)
* The HTML website that has to updated manually is a chore, and has been
outdated for a long while
* Many design discussions are now hidden in phabricator revisions

This patch implements a new documentation infrastucture using Sphinx, like most
of the other subprojects in LLVM. It transformed some pages as a proof-of-
concept, with many others to follow in later patches. The eventual goal is to
preserve the original website's (https://clang-analyzer.llvm.org/) frontpage,
but move everything else to the new format.

Some other ideas, like creating a unipage for each checker (similar to how
clang-tidy works now), are also being discussed.

Patch by Dániel Krupp!

Differential Revision: https://reviews.llvm.org/D54429

llvm-svn: 353126

show more ...

Bump the trunk version to 9.0.0svn

llvm-svn: 351320

Portable Python script across Python version

Make scripts more future-proof by importing most __future__ stuff.

Differential Revision: https://reviews.llvm.org/D55208

llvm-svn: 349504

Portable Python script across Python version

Using from __future__ import print_function it is possible to have a compatible behavior of `print(...)` across Python version.

Differential Revision: h

Portable Python script across Python version

Using from __future__ import print_function it is possible to have a compatible behavior of `print(...)` across Python version.

Differential Revision: https://reviews.llvm.org/D55213

llvm-svn: 349454

show more ...

Update docs version and clear release notes after 8.0.0 version bump

llvm-svn: 338557

Update docs version and clear release notes for 7.0.0

llvm-svn: 321728

Bump docs version to 6.0

llvm-svn: 308466

Update docs/conf.py version

llvm-svn: 291831

docs/conf.py: update version to 4.0

llvm-svn: 275848