Trac #33104: Fix references to doc-clean

Followup to #29310: `make doc-uninstall` should frequently be used
instead of or in addition to `make doc-clean`, so the instructions for
installation from source need to be fixed, as should error messages when
building the docs.

URL: https://trac.sagemath.org/33104
Reported by: jhpalmieri
Ticket author(s): John Palmieri
Reviewer(s): Matthias Koeppe

Author: Release Manager

build/pkgs/configure/checksums.ini

@@ -1,4 +1,4 @@
 tarball=configure-VERSION.tar.gz
-sha1=63a185e63945337d9e35c8befb0842a338f8d485
-md5=d1ad922ab9d630f1f3d05ea2cd265a0d
-cksum=727308674
+sha1=9f326bb5728854f7621afaff496f491d0e1df5aa
+md5=ec6ced9c4e5241d7ee78f6082dc4b07a
+cksum=2674638119

build/pkgs/configure/package-version.txt

@@ -1 +1 @@
-866a2b24b7ffc1f489c181243c6b90659f79e741
+7c5ddd97148ade288dd7f8e8654aa8393f843004

src/doc/en/installation/source.rst

@@ -936,7 +936,7 @@ how it is built:
   plots, adding about 4M to the :file:`local/share/doc/sage/` directory.
   In the future, this may grow, of course. Note: after using this, if you
   want to build the documentation and include the pictures, you should
-  run ``make doc-clean``, because the presence, or lack, of pictures
+  run ``make doc-uninstall``, because the presence, or lack, of pictures
   is cached in the documentation output.
   You can benefit from this no-plot feature with other make targets by doing
   ``export SAGE_DOCBUILD_OPTS+=' --no-plot'``
@@ -952,8 +952,8 @@ how it is built:
   software, you can use ``make testall``, ``make ptestall``,
   ``make testalllong``, or ``make ptestalllong``.
 
-- ``make doc-clean`` removes several directories which are produced
-  when building the documentation.
+- ``make doc-uninstall`` and ``make doc-clean`` each remove several
+  directories which are produced when building the documentation.
 
 - ``make distclean`` restores the Sage directory to its state before doing any
   building: it is almost equivalent to deleting Sage's entire home directory and

src/sage_docbuild/__init__.py

@@ -1732,7 +1732,7 @@ def excepthook(*exc_info):
             logger.error('''
     Note: incremental documentation builds sometimes cause spurious
     error messages. To be certain that these are real errors, run
-    "make doc-clean" first and try again.''')
+    "make doc-clean doc-uninstall" first and try again.''')
 
     sys.excepthook = excepthook