diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/GarbageCollection.rst | 3 | ||||
| -rw-r--r-- | docs/GettingStarted.rst | 3 | ||||
| -rw-r--r-- | docs/MakefileGuide.rst | 4 | ||||
| -rw-r--r-- | docs/Projects.rst | 74 |
4 files changed, 7 insertions, 77 deletions
diff --git a/docs/GarbageCollection.rst b/docs/GarbageCollection.rst index 73bc5eeb1ffe..323a6ea81659 100644 --- a/docs/GarbageCollection.rst +++ b/docs/GarbageCollection.rst @@ -500,8 +500,7 @@ This boilerplate collector does nothing. More specifically: * The stack map is not compiled into the executable. -Using the LLVM makefiles (like the `sample project -<http://llvm.org/viewvc/llvm-project/llvm/trunk/projects/sample/>`__), this code +Using the LLVM makefiles, this code can be compiled as a plugin using a simple makefile: .. code-block:: make diff --git a/docs/GettingStarted.rst b/docs/GettingStarted.rst index 52924a2be3b2..3d2ec1e99dc5 100644 --- a/docs/GettingStarted.rst +++ b/docs/GettingStarted.rst @@ -1078,8 +1078,7 @@ different `tools`_. This directory contains projects that are not strictly part of LLVM but are shipped with LLVM. This is also the directory where you should create your own -LLVM-based projects. See ``llvm/projects/sample`` for an example of how to set -up your own project. +LLVM-based projects. ``llvm/runtime`` ---------------- diff --git a/docs/MakefileGuide.rst b/docs/MakefileGuide.rst index 120c108de786..a5e273124a41 100644 --- 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. -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 --------------- diff --git a/docs/Projects.rst b/docs/Projects.rst index 3246e3ff169b..095b87a65a10 100644 --- a/docs/Projects.rst +++ b/docs/Projects.rst @@ -37,82 +37,16 @@ There are two ways that you can set all of these variables: of LLVM, and the ability to support multiple object directories from a single source directory. -This document assumes that you will base your project on the LLVM sample project -found in ``llvm/projects/sample``. If you want to devise your own build system, -studying the sample project and LLVM ``Makefiles`` will probably provide enough -information on how to write your own ``Makefiles``. - -Create a Project from the Sample Project -======================================== - -Follow these simple steps to start your project: - -1. Copy the ``llvm/projects/sample`` directory to any place of your choosing. - You can place it anywhere you like. Rename the directory to match the name - of your project. - -2. If you downloaded LLVM using Subversion, remove all the directories named - ``.svn`` (and all the files therein) from your project's new source tree. - This will keep Subversion from thinking that your project is inside - ``llvm/trunk/projects/sample``. - -3. Add your source code and Makefiles to your source tree. - -4. If you want your project to be configured with the ``configure`` script then - you need to edit ``autoconf/configure.ac`` as follows: - - * **AC_INIT** - Place the name of your project, its version number and a - contact email address for your project as the arguments to this macro - - * **AC_CONFIG_AUX_DIR** - If your project isn't in the ``llvm/projects`` - directory then you might need to adjust this so that it specifies a - relative path to the ``llvm/autoconf`` directory. - - * **LLVM_CONFIG_PROJECT** - Just leave this alone. - - * **AC_CONFIG_SRCDIR** - Specify a path to a file name that identifies your - project; or just leave it at ``Makefile.common.in``. - - * **AC_CONFIG_FILES** - Do not change. - - * **AC_CONFIG_MAKEFILE** - Use one of these macros for each Makefile that - your project uses. This macro arranges for your makefiles to be copied from - the source directory, unmodified, to the build directory. - -5. After updating ``autoconf/configure.ac``, regenerate the configure script - with these commands. (You must be using ``Autoconf`` version 2.59 or later - and your ``aclocal`` version should be 1.9 or later.) - - .. code-block:: bash - - % cd autoconf - % ./AutoRegen.sh - -6. Run ``configure`` in the directory in which you want to place object code. - Use the following options to tell your project where it can find LLVM: - - ``--with-llvmsrc=<directory>`` - Tell your project where the LLVM source tree is located. - - ``--with-llvmobj=<directory>`` - Tell your project where the LLVM object tree is located. - - ``--prefix=<directory>`` - Tell your project where it should get installed. - -That's it! Now all you have to do is type ``gmake`` (or ``make`` if you're on a -GNU/Linux system) in the root of your object directory, and your project should -build. +If you want to devise your own build system, studying other projects and LLVM +``Makefiles`` will probably provide enough information on how to write your own +``Makefiles``. Source Tree Layout ================== In order to use the LLVM build system, you will want to organize your source code so that it can benefit from the build system's features. Mainly, you want -your source tree layout to look similar to the LLVM source tree layout. The -best way to do this is to just copy the project tree from -``llvm/projects/sample`` and modify it to meet your needs, but you can certainly -add to it if you want. +your source tree layout to look similar to the LLVM source tree layout. Underneath your top level directory, you should have the following directories: |