From e8a4d5f808b4482a1136892e6aeb159b7a7c74a3 Mon Sep 17 00:00:00 2001 From: Sam Clegg Date: Tue, 5 Dec 2017 23:31:26 +0000 Subject: [PATCH] [docs] Update doc building instructions Differential Revision: https://reviews.llvm.org/D39984 llvm-svn: 319857 --- lld/docs/sphinx_intro.rst | 32 ++++++-------------------------- 1 file changed, 6 insertions(+), 26 deletions(-) diff --git a/lld/docs/sphinx_intro.rst b/lld/docs/sphinx_intro.rst index 1842642e856c..6bb9816b5ab4 100644 --- a/lld/docs/sphinx_intro.rst +++ b/lld/docs/sphinx_intro.rst @@ -57,33 +57,13 @@ to install it using: Building the documentation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -In order to build the documentation, all you should need to do is change to the -``docs`` directory and invoke make as follows:: - - $ cd path/to/project/docs - $ make html - -Note that on Windows there is a ``make.bat`` command in the docs directory which -supplies the same interface as the ``Makefile``. - -That command will invoke ``sphinx-build`` with the appropriate options for the -project, and generate the HTML documentation in a ``_build`` subdirectory. You -can browse it starting from the index page by visiting -``_build/html/index.html``. - -Sphinx supports a wide variety of generation formats (including LaTeX, man -pages, and plain text). The ``Makefile`` includes a number of convenience -targets for invoking ``sphinx-build`` appropriately, the common ones are: - - make html - Generate the HTML output. - - make latexpdf - Generate LaTeX documentation and convert to a PDF. - - make man - Generate man pages. +In order to build the documentation need to add ``-DLLVM_ENABLE_SPHINX=ON`` to +your ``cmake`` command. Once you do this you can build the docs using +``docs-lld-html`` build (``ninja`` or ``make``) target. +That build target will invoke ``sphinx-build`` with the appropriate options for +the project, and generate the HTML documentation in a ``tools/lld/docs/html`` +subdirectory. .. _writing_documentation: -- 2.34.1