add python scripts related to lit

docs/Doxyfile

 # Doxyfile 1.8.6
 
 # This file describes the settings to be used by the documentation system
 # doxygen (www.doxygen.org) for a project.
 #
 # All text after a double hash (##) is considered a comment and is placed in
 # front of the TAG it is preceding.
 #
 # All text after a single hash (#) is considered a comment and will be ignored.
 # The format is:
@@ skipping 252 matching lines @@
 # language is one of the parsers supported by doxygen: IDL, Java, Javascript,
 # C#, C, C++, D, PHP, Objective-C, Python, Fortran, VHDL. For instance to make
 # doxygen treat .inc files as Fortran files (default is PHP), and .f files as C
 # (default is Fortran), use: inc=Fortran f=C.
 #
 # Note For files without extension you can use no_extension as a placeholder.
 #
 # 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
 # documentation. See http://daringfireball.net/projects/markdown/ for details.
 # The output of markdown processing is further processed by doxygen, so you can
 # mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
 # case of backward compatibilities issues.
 # The default value is: YES.
 
 MARKDOWN_SUPPORT       = YES
@@ skipping 459 matching lines @@
 # spaces.
 # Note: If this tag is empty the current directory is searched.
 
 INPUT                  = "../src" \
                          "../../llvm/include/llvm/ADT" \
                          "../../llvm/include/llvm/Bitcode" \
                          "../../llvm/include/llvm/Config" \
                          "../../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
 # libiconv (or the iconv built into libc) for the transcoding. See the libiconv
 # documentation (see: http://www.gnu.org/software/libiconv) for the list of
 # possible encodings.
 # The default value is: UTF-8.
 
 INPUT_ENCODING         = UTF-8
 
 # If the value of the INPUT tag contains directories, you can use the
 # FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
 # *.h) to filter out the source-files in the directories. If left blank the
 # following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
 # *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
 # *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
 # *.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.
 # The default value is: NO.
 
 RECURSIVE              = YES
 
 # The EXCLUDE tag can be used to specify files and/or directories that should be
 # excluded from the INPUT source files. This way you can easily exclude a
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
@@ skipping 1542 matching lines @@
 
 CLANG_ASSISTED_PARSING = NO
 
 CLANG_OPTIONS = "-std=c++11" \
                 "-DALLOW_DUMP=1" \
                 "-DALLOW_LLVM_CL=1" \
                 "-DALLOW_LLVM_IR=1" \
                 "-DALLOW_LLVM_IR_AS_INPUT=1" \
                 "-DALLOW_MINIMAL_BUILD=0" \
                 "-DPNACL_BROWSER_TRANSLATOR=0"