Inconsistent help text of Makefile

[dviererbe]

Current behavior

• invocation of make help:

  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

1. make install and make help should show the same help information
2. make help should show some supported targets (e.g. run, serve, woke, clean-doc)
3. 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 target

https://github.com/canonical/sphinx-docs-starter-pack/blob/9bb5387e85e8c22d21a7525c186cb245bd1e2189/Makefile#L18-L20

source of the install target help text

https://github.com/canonical/sphinx-docs-starter-pack/blob/9bb5387e85e8c22d21a7525c186cb245bd1e2189/Makefile#L26-L49

[pmatulis]

Resolved by #181