From 298422d326d738e901d088d4423c8d816b447793 Mon Sep 17 00:00:00 2001
From: Sean Silva <silvas@purdue.edu>
Date: Tue, 19 Feb 2013 17:21:23 +0000
Subject: [PATCH] [docs] Revise content on ExternalProjectsUsingClang page.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@175534 91177308-0d34-0410-b5e6-96231b3b80d8
---
docs/ExternalProjectsUsingClang.rst | 28 ++++++++++++++++++++++------
1 file changed, 22 insertions(+), 6 deletions(-)
diff --git a/docs/ExternalProjectsUsingClang.rst b/docs/ExternalProjectsUsingClang.rst
index e232fcdfe86..71d6413934f 100644
--- a/docs/ExternalProjectsUsingClang.rst
+++ b/docs/ExternalProjectsUsingClang.rst
@@ -2,12 +2,28 @@
External Projects Using Clang
=============================
-Clang is more than a compiler; its library-based approach allows creation of
-different kinds of tools that can process source code.
+Introduction
+============
-This page contains references to Clang based tools and projects. To extend
-the list you could write email to the `development mailing list
-<http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_.
+This page provides some examples of the kinds of things that people have
+done with Clang that might serve as useful guides (or starting points) from
+which to develop your own tools. They may be helpful even for something as
+banal (but necessary) as how to set up your build to integrate Clang.
+
+Clang's library-based design is deliberately aimed at facilitating use by
+external projects, and we are always interested in improving Clang to
+better serve our external users. Some typical categories of applications
+where Clang is used are:
+
+- Static analysis.
+- Documentation/cross-reference generation.
+
+If you know of (or wrote!) a tool or project using Clang, please send an
+email to Clang's `development discussion mailing list
+<http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev>`_ to have it added.
+(or if you are already a Clang contributor, feel free to directly commit
+additions). Since the primary purpose of this page is to provide examples
+that can help developers, generally they must have code available.
List of projects and tools
==========================
@@ -46,7 +62,7 @@ List of projects and tools
"cmonster is a Python wrapper for the Clang C++ parser."
`<https://github.com/rizsotto/Constantine>`_
- "Constantine is a toy project to learn how to write clang plugin.
+ "Constantine is a toy project to learn how to write clang plugin.
Implements pseudo const analysis. Generates warnings about variables,
which were declared without const qualifier."
--
GitLab