mirror of
https://github.com/AdaCore/gprbuild.git
synced 2026-02-12 12:30:13 -08:00
9cda7be897
This file was basically a copy/paste of the sphinx.sty file in the sphinx project. It prevented gprbuild documentation from transitioning to sphinx 6.2.1 and, more generally, from transitioning during a sphinx bump. IT-737
63 lines
1.7 KiB
Makefile
63 lines
1.7 KiB
Makefile
# Makefile for Sphinx documentation
|
|
|
|
# You can set these variables from the command line.
|
|
SPHINXOPTS =
|
|
SPHINXBUILD = sphinx-build
|
|
PAPER =
|
|
BUILDDIR = .
|
|
SOURCEDIR = .
|
|
|
|
# Internal variables.
|
|
PAPEROPT_a4 = -D latex_paper_size=a4
|
|
PAPEROPT_letter = -D latex_paper_size=letter
|
|
ALLSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) \
|
|
-c $(SOURCEDIR)/share \
|
|
-d $(BUILDDIR)/$*/doctrees \
|
|
$(SOURCEDIR)
|
|
FMT_LIST=html txt info pdf
|
|
DOC_NAME=gprbuild_ug
|
|
CP=cp
|
|
|
|
.PHONY: help clean
|
|
|
|
all: $(foreach fmt, $(FMT_LIST), $(fmt))
|
|
|
|
help:
|
|
@echo "Please use \`make <target>' where <target> is one of"
|
|
@echo " html to make standalone HTML files"
|
|
@echo " pdf to make LaTeX files and run them through pdflatex"
|
|
@echo " txt to make text files"
|
|
@echo " texinfo to make Texinfo files"
|
|
@echo " info to make info files"
|
|
@echo " all to build documentation in all formats"
|
|
@echo ""
|
|
@echo "source and location can be overriden using SOURCEDIR and BUILDDIR variables"
|
|
|
|
clean:
|
|
-rm -rf $(BUILDDIR)/html \
|
|
$(BUILDDIR)/pdf \
|
|
$(BUILDDIR)/txt \
|
|
$(BUILDDIR)/info \
|
|
$(BUILDDIR)/doctrees \
|
|
share/__pycache__
|
|
|
|
html: force
|
|
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
|
|
|
pdf: force
|
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/pdf
|
|
$(MAKE) -C $(BUILDDIR)/pdf all-pdf LATEXOPTS="-interaction=nonstopmode"
|
|
|
|
txt: force
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/$*/txt
|
|
$(MAKE) -C $(BUILDDIR)/txt plaintext
|
|
|
|
info: force
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/$*/info
|
|
$(MAKE) -C $(BUILDDIR)/info info
|
|
|
|
texinfo:
|
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/$*/texinfo
|
|
|
|
force:
|