[X86][SSE] Combine UNPCKL with vector_shuffle into UNPCKH to save one instruction...

[oota-llvm.git] / docs / MakefileGuide.rst

diff --git a/docs/MakefileGuide.rst b/docs/MakefileGuide.rst
index f86d3e11e28f1ded3555f9fa4955c8f0ed8ab4ca..a5e273124a41cde2c02343c9c9e39b7a13521e11 100644 (file)
--- a/docs/MakefileGuide.rst
+++ b/docs/MakefileGuide.rst
@@ -47,9 +47,7 @@ quickly by utilizing the built-in features that are used to compile LLVM. LLVM
 compiles itself using the same features of the makefile system as used for
 projects.
 
 compiles itself using the same features of the makefile system as used for
 projects.
 

-For complete details on setting up your projects configuration, simply mimic the
-``llvm/projects/sample`` project. Or for further details, consult the
-`Projects <Projects.html>`_ page.
+For further details, consult the `Projects <Projects.html>`_ page.

 
 Variable Values
 ---------------
 
 Variable Values
 ---------------


@@ -153,7 +151,7 @@ libraries are the default. For example:
 
   LIBRARYNAME = mylib
   SHARED_LIBRARY = 1
 
   LIBRARYNAME = mylib
   SHARED_LIBRARY = 1

-  ARCHIVE_LIBRARY = 1
+  BUILD_ARCHIVE = 1

 
 says to build a library named ``mylib`` with both a shared library
 (``mylib.so``) and an archive library (``mylib.a``) version. The contents of all
 
 says to build a library named ``mylib`` with both a shared library
 (``mylib.so``) and an archive library (``mylib.a``) version. The contents of all


@@ -168,29 +166,9 @@ openable with the ``dlopen`` function and searchable with the ``dlsym`` function
 (or your operating system's equivalents). While this isn't strictly necessary on
 Linux and a few other platforms, it is required on systems like HP-UX and
 Darwin. You should use ``LOADABLE_MODULE`` for any shared library that you
 (or your operating system's equivalents). While this isn't strictly necessary on
 Linux and a few other platforms, it is required on systems like HP-UX and
 Darwin. You should use ``LOADABLE_MODULE`` for any shared library that you

-intend to be loaded into an tool via the ``-load`` option.  `Pass documentation
-<writing-an-llvm-pass-makefile>`_ has an example of why you might want to do
-this.
-
-Bitcode Modules
-^^^^^^^^^^^^^^^
-
-In some situations, it is desirable to build a single bitcode module from a
-variety of sources, instead of an archive, shared library, or bitcode
-library. Bitcode modules can be specified in addition to any of the other types
-of libraries by defining the `MODULE_NAME`_ variable. For example:
-
-.. code-block:: makefile
-
-  LIBRARYNAME = mylib
-  BYTECODE_LIBRARY = 1
-  MODULE_NAME = mymod
-
-will build a module named ``mymod.bc`` from the sources in the directory. This
-module will be an aggregation of all the bitcode modules derived from the
-sources. The example will also build a bitcode archive containing a bitcode
-module for each compiled source file. The difference is subtle, but important
-depending on how the module or library is to be linked.
+intend to be loaded into an tool via the ``-load`` option.  :ref:`Pass
+documentation <writing-an-llvm-pass-makefile>` has an example of why you might
+want to do this.

 
 Loadable Modules
 ^^^^^^^^^^^^^^^^
 
 Loadable Modules
 ^^^^^^^^^^^^^^^^


@@ -256,7 +234,7 @@ the ``-l`` option). In this case, only the symbols that are unresolved *at
 that point* will be resolved from the library, if they exist. Other
 (unreferenced) symbols will not be included when the ``.a`` syntax is used. Note
 that in order to use the ``.a`` suffix, the library in question must have been
 that point* will be resolved from the library, if they exist. Other
 (unreferenced) symbols will not be included when the ``.a`` syntax is used. Note
 that in order to use the ``.a`` suffix, the library in question must have been

-built with the ``ARCHIVE_LIBRARY`` option set.
+built with the ``BUILD_ARCHIVE`` option set.

 
 JIT Tools
 ^^^^^^^^^
 
 JIT Tools
 ^^^^^^^^^


@@ -486,9 +464,6 @@ system that tell it what to do for the current directory.
     files. These sources will be built before any other target processing to
     ensure they are present.
 
     files. These sources will be built before any other target processing to
     ensure they are present.
 

-``BYTECODE_LIBRARY``
-    If set to any value, causes a bitcode library (.bc) to be built.
-

 ``CONFIG_FILES``
     Specifies a set of configuration files to be installed.
 
 ``CONFIG_FILES``
     Specifies a set of configuration files to be installed.
 


@@ -590,13 +565,6 @@ system that tell it what to do for the current directory.
     setting this variable without also setting ``SHARED_LIBRARY`` will have no
     effect.
 
     setting this variable without also setting ``SHARED_LIBRARY`` will have no
     effect.
 

-.. _MODULE_NAME:
-
-``MODULE_NAME``
-    Specifies the name of a bitcode module to be created. A bitcode module can
-    be specified in conjunction with other kinds of library builds or by
-    itself. It constructs from the sources a single linked bitcode file.
-

 ``NO_INSTALL``
     Specifies that the build products of the directory should not be installed
     but should be built even if the ``install`` target is given.  This is handy
 ``NO_INSTALL``
     Specifies that the build products of the directory should not be installed
     but should be built even if the ``install`` target is given.  This is handy


@@ -699,6 +667,9 @@ The override variables are given below:
 ``CFLAGS``
     Additional flags to be passed to the 'C' compiler.
 
 ``CFLAGS``
     Additional flags to be passed to the 'C' compiler.
 

+``CPPFLAGS``
+    Additional flags passed to the C/C++ preprocessor.
+

 ``CXX``
     Specifies the path to the C++ compiler.
 
 ``CXX``
     Specifies the path to the C++ compiler.
 


@@ -736,12 +707,6 @@ The override variables are given below:
 ``LLVMAS`` (defaulted)
     Specifies the path to the ``llvm-as`` tool.
 
 ``LLVMAS`` (defaulted)
     Specifies the path to the ``llvm-as`` tool.
 

-``LLVMCC``
-    Specifies the path to the LLVM capable compiler.
-
-``LLVMCXX``
-    Specifies the path to the LLVM C++ capable compiler.
-

 ``LLVMGCC`` (defaulted)
     Specifies the path to the LLVM version of the GCC 'C' Compiler.
 
 ``LLVMGCC`` (defaulted)
     Specifies the path to the LLVM version of the GCC 'C' Compiler.
 


@@ -885,8 +850,6 @@ internal. You should not use these variables under any circumstances.
     Archive
     AR.Flags
     BaseNameSources
     Archive
     AR.Flags
     BaseNameSources

-    BCCompile.C
-    BCCompile.CXX

     BCLinkLib
     C.Flags
     Compile.C
     BCLinkLib
     C.Flags
     Compile.C


@@ -933,7 +896,6 @@ internal. You should not use these variables under any circumstances.
     LLVMUsedLibs
     LocalTargets
     Module
     LLVMUsedLibs
     LocalTargets
     Module

-    ObjectsBC

     ObjectsLO
     ObjectsO
     ObjMakefiles
     ObjectsLO
     ObjectsO
     ObjMakefiles