Sphinx v7.2.6
Please use `make target' where target is one of
html to make standalone HTML files
dirhtml to make HTML files named index.html in directories
singlehtml to make a single large HTML file
pickle to make pickle files
json to make JSON files
htmlhelp to make HTML files and an HTML help project
qthelp to make HTML files and a qthelp project
devhelp to make HTML files and a Devhelp project
epub to make an epub
latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
latexpdf to make LaTeX and PDF files (default pdflatex)
latexpdfja to make LaTeX files and run them through platex/dvipdfmx
text to make text files
man to make manual pages
texinfo to make Texinfo files
info to make Texinfo files and run them through makeinfo
gettext to make PO message catalogs
changes to make an overview of all changed/added/deprecated items
xml to make Docutils-native XML files
pseudoxml to make pseudoxml-XML files for display purposes
linkcheck to check all external links for integrity
doctest to run all doctests embedded in the documentation (if enabled)
coverage to run coverage check of the documentation (if enabled)
clean to remove everything in the build directory
1st invocation of make install
[...]
---------------------------------------------------------------
* watch, build and serve the documentation: make run
* only build: make html
* only serve: make serve
* clean built doc files: make clean-doc
* clean full environment: make clean
* check links: make linkcheck
* check spelling: make spelling
* check inclusive language: make woke
* check accessibility: make pa11y
* other possible targets: make <press TAB twice>
---------------------------------------------------------------
2nd invocation of make install:
no output
Expected Behavior
make install and make help should show the same help information
make help should show some supported targets (e.g. run, serve, woke, clean-doc)
make help should not show unsupported targets (e.g. man, qthelp)
Nitpick/Polish: It somehow bugs me that nothing is happening (not even a warning) on a second invocation of the install target.
Current behavior
invocation of
make help
:1st invocation of
make install
2nd invocation of
make install
:no output
Expected Behavior
make install
andmake help
should show the same help informationmake help
should show some supported targets (e.g.run
,serve
,woke
,clean-doc
)make help
should not show unsupported targets (e.g.man
,qthelp
)Nitpick/Polish: It somehow bugs me that nothing is happening (not even a warning) on a second invocation of the
install
target.Reference
help
targethttps://github.com/canonical/sphinx-docs-starter-pack/blob/9bb5387e85e8c22d21a7525c186cb245bd1e2189/Makefile#L18-L20
source of the
install
target help texthttps://github.com/canonical/sphinx-docs-starter-pack/blob/9bb5387e85e8c22d21a7525c186cb245bd1e2189/Makefile#L26-L49