github.com/muhammedhassanm/blockchain@v0.0.0-20200120143007-697261defd4d/sawtooth-supply-chain-master/docs/Makefile (about)

     1  # Makefile for Sphinx documentation
     2  #
     3  
     4  # You can set these variables from the command line.
     5  SPHINXOPTS    =
     6  SPHINXBUILD   = sphinx-build
     7  SPHINXAPIDOC  = sphinx-apidoc
     8  PAPER         =
     9  BUILDDIR      = build
    10  
    11  # User-friendly check for sphinx-build
    12  ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
    13  $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
    14  endif
    15  
    16  # Internal variables.
    17  PAPEROPT_a4     = -D latex_paper_size=a4
    18  PAPEROPT_letter = -D latex_paper_size=letter
    19  ALLSPHINXOPTS   = -W -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
    20  # the i18n builder cannot share the environment and doctrees with the others
    21  I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
    22  
    23  .PHONY: help clean templates html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest coverage gettext cli
    24  
    25  help:
    26  	@echo "Please use \`make <target>' where <target> is one of"
    27  	@echo "  html       to make standalone HTML files"
    28  	@echo "  dirhtml    to make HTML files named index.html in directories"
    29  	@echo "  singlehtml to make a single large HTML file"
    30  	@echo "  pickle     to make pickle files"
    31  	@echo "  json       to make JSON files"
    32  	@echo "  htmlhelp   to make HTML files and a HTML help project"
    33  	@echo "  qthelp     to make HTML files and a qthelp project"
    34  	@echo "  applehelp  to make an Apple Help Book"
    35  	@echo "  devhelp    to make HTML files and a Devhelp project"
    36  	@echo "  epub       to make an epub"
    37  	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
    38  	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
    39  	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
    40  	@echo "  text       to make text files"
    41  	@echo "  man        to make manual pages"
    42  	@echo "  texinfo    to make Texinfo files"
    43  	@echo "  info       to make Texinfo files and run them through makeinfo"
    44  	@echo "  gettext    to make PO message catalogs"
    45  	@echo "  changes    to make an overview of all changed/added/deprecated items"
    46  	@echo "  xml        to make Docutils-native XML files"
    47  	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
    48  	@echo "  linkcheck  to check all external links for integrity"
    49  	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
    50  	@echo "  coverage   to run coverage check of the documentation (if enabled)"
    51  
    52  clean:
    53  	rm -rf $(BUILDDIR)/* source/cli/output/*.out
    54  
    55  html:
    56  	@mkdir -p source/_static
    57  	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
    58  	@echo
    59  	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
    60  
    61  dirhtml:
    62  	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
    63  	@echo
    64  	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
    65  
    66  singlehtml:
    67  	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
    68  	@echo
    69  	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
    70  
    71  pickle:
    72  	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
    73  	@echo
    74  	@echo "Build finished; now you can process the pickle files."
    75  
    76  json:
    77  	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
    78  	@echo
    79  	@echo "Build finished; now you can process the JSON files."
    80  
    81  htmlhelp:
    82  	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
    83  	@echo
    84  	@echo "Build finished; now you can run HTML Help Workshop with the" \
    85  	      ".hhp project file in $(BUILDDIR)/htmlhelp."
    86  
    87  qthelp:
    88  	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
    89  	@echo
    90  	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
    91  	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
    92  	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/IntelMaidenLane.qhcp"
    93  	@echo "To view the help file:"
    94  	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/IntelMaidenLane.qhc"
    95  
    96  applehelp:
    97  	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
    98  	@echo
    99  	@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
   100  	@echo "N.B. You won't be able to view it unless you put it in" \
   101  	      "~/Library/Documentation/Help or install it in your application" \
   102  	      "bundle."
   103  
   104  devhelp:
   105  	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
   106  	@echo
   107  	@echo "Build finished."
   108  	@echo "To view the help file:"
   109  	@echo "# mkdir -p $$HOME/.local/share/devhelp/IntelMaidenLane"
   110  	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/IntelMaidenLane"
   111  	@echo "# devhelp"
   112  
   113  epub:
   114  	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
   115  	@echo
   116  	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
   117  
   118  latex:
   119  	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
   120  	@echo
   121  	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
   122  	@echo "Run \`make' in that directory to run these through (pdf)latex" \
   123  	      "(use \`make latexpdf' here to do that automatically)."
   124  
   125  latexpdf:
   126  	@mkdir -p source/_static
   127  	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
   128  	@echo "Running LaTeX files through pdflatex..."
   129  	$(MAKE) -C $(BUILDDIR)/latex all-pdf
   130  	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
   131  
   132  latexpdfja:
   133  	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
   134  	@echo "Running LaTeX files through platex and dvipdfmx..."
   135  	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
   136  	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
   137  
   138  text:
   139  	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
   140  	@echo
   141  	@echo "Build finished. The text files are in $(BUILDDIR)/text."
   142  
   143  man:
   144  	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
   145  	@echo
   146  	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
   147  
   148  texinfo:
   149  	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
   150  	@echo
   151  	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
   152  	@echo "Run \`make' in that directory to run these through makeinfo" \
   153  	      "(use \`make info' here to do that automatically)."
   154  
   155  info:
   156  	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
   157  	@echo "Running Texinfo files through makeinfo..."
   158  	make -C $(BUILDDIR)/texinfo info
   159  	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
   160  
   161  gettext:
   162  	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
   163  	@echo
   164  	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
   165  
   166  changes:
   167  	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
   168  	@echo
   169  	@echo "The overview file is in $(BUILDDIR)/changes."
   170  
   171  linkcheck:
   172  	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
   173  	@echo
   174  	@echo "Link check complete; look for any errors in the above output " \
   175  	      "or in $(BUILDDIR)/linkcheck/output.txt."
   176  
   177  doctest:
   178  	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
   179  	@echo "Testing of doctests in the sources finished, look at the " \
   180  	      "results in $(BUILDDIR)/doctest/output.txt."
   181  
   182  coverage:
   183  	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
   184  	@echo "Testing of coverage in the sources finished, look at the " \
   185  	      "results in $(BUILDDIR)/coverage/python.txt."
   186  
   187  xml:
   188  	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
   189  	@echo
   190  	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
   191  
   192  pseudoxml:
   193  	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
   194  	@echo
   195  	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."