add python scripts related to lit

docs/Doxyfile

Index: docs/Doxyfile
diff --git a/docs/Doxyfile b/docs/Doxyfile
index 4e9b2ffab3026386c918dca53b49163f4eadfd6d..ed8dd96eafb34585464d64fb5441e5f6d4a9b593 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -270,7 +270,7 @@ OPTIMIZE_OUTPUT_VHDL   = NO
 # Note that for custom extensions you also need to set FILE_PATTERNS otherwise
 # the files are not read by doxygen.
 
-EXTENSION_MAPPING      =
+EXTENSION_MAPPING      = lit.cfg=Python
 
 # If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
 # according to the Markdown format, which allows for more readable
@@ -750,7 +750,9 @@ INPUT                  = "../src" \
                          "../../llvm/include/llvm/IR" \
                          "../../llvm/include/llvm/IRReader" \
                          "../../llvm/include/llvm/Support" \
-                         "../pydir"
+                         "../pydir" \
+                         "../tests_lit/lit.cfg" \
+                         "../../llvm/utils/lit"

[Jim Stichnoth, 2016/01/20 18:25:52]

What is the benefit of documenting the whole lit system?  My initial thought is
to skip this, but I may be missing something?

[rkotlerimgtec, 2016/01/20 20:35:07]

The main reason is just so that we can see this code in Doxygen while looking at
code of ours that uses it, python scripts, make files, etc.

Even in general if someone is trying to understand make check.

In this sense, Doxygen is just acting as a source browser.

It is possible to add out of line documentation for it too that exists in our
source tree, if it's something that we can't put back into llvm.

[Jim Stichnoth, 2016/01/21 01:45:20]

I see, thanks.

 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -770,7 +772,7 @@ INPUT_ENCODING         = UTF-8
 # *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
 # *.qsf, *.as and *.js.
 
-FILE_PATTERNS          =
+FILE_PATTERNS          = 

[Jim Stichnoth, 2016/01/20 18:25:52]

revert this whitespace addition

[rkotlerimgtec, 2016/01/20 20:35:07]

Done.

 
 # The RECURSIVE tag can be used to specify whether or not subdirectories should
 # be searched for input files as well.