[cfe-commits] r170260 - in /cfe/trunk/docs: AnalyzerRegions.rst analyzer/AnalyzerRegions.rst index.rst
silvas at purdue.edu
Sat Dec 15 15:49:26 PST 2012
On Fri, Dec 14, 2012 at 7:36 PM, Jordan Rose <jordan_rose at apple.com> wrote:
> --- cfe/trunk/docs/index.rst (original)
> +++ cfe/trunk/docs/index.rst Fri Dec 14 18:36:53 2012
> @@ -19,7 +19,6 @@
> - AnalyzerRegions
This doesn't remove it from the Sphinx docs build. However, it does
cause a Sphinx warning that the document is not included in any
Basically I see three options here.
If the doc is so out of date that it will only confuse people, then either
1. bring it up to date (this is the "right thing" to do, which helps
people who want to learn about the static analyzer), or
2. delete it (this doesn't help people understand the analyzer, but is
at least better than leaving in a document which will confuse people).
or, if the doc is out of date but still might be helpful, then
3. Leave it in the documentation (and fix the sphinx warning), but add
a warning at the top (`.. warning::`) that informs the reader that the
document is out of date but that it still might be helpful.
-- Sean Silva
More information about the cfe-commits