force C locale in docbuild and remove some obsolete stuff

[dimpase]

currently WARNINGs are treated as errors, and we filter out harmless ones. Since Sphinx 3.0, docbuilds are localised, and fail if locale is e.g. French, cf.

https://groups.google.com/d/msg/sage-release/7wBxNRbJaaU/hzptnsQpCQAJ

Currently we have the list of these warnings maintained in src/sage_setup/docbuild/sphinxbuild.py.

Setting LANG=C provides a workaround.

However, this is far from optimal. At some point sphinx had ignore_warnings: cfelder/sphinx@2600eef#diff-639ce3a52583644f64e3dce953a93a39

which then got renamed to suppress_warnings (but still only allows to suppress a subset of warnings, it appears)

CC: @jhpalmieri @heluani

Component: documentation

Author: Dima Pasechnik

Branch/Commit: u/dimpase/build/setlocale_to_C_docbuild @ cf52d9a

Reviewer: Matthias Koeppe

Issue created by migration from https://trac.sagemath.org/ticket/30002

[dimpase]

Description changed:

--- 
+++ 
@@ -2,4 +2,10 @@
 
 https://groups.google.com/d/msg/sage-release/7wBxNRbJaaU/hzptnsQpCQAJ
 
-setting LANG=C provides a workaround.
+Currently we have the list of these warnings maintained in `src/sage_setup/docbuild/sphinxbuild.py`.
+
+Setting LANG=C provides a workaround.
+
+However, this is far from optimal. At some point sphinx had `ignore_warnings`: https://github.com/cfelder/sphinx/commit/2600eef2a5872216e0cf7341e0e48fc8ba2803df#diff-639ce3a52583644f64e3dce953a93a39 
+
+not sure why it is not there any more

[antonio-rojas]

comment:2

I think this is what you're looking for sphinx-doc/sphinx@ae9d786

[dimpase]

comment:3

current sphinx has suppress_warnings

[EmmanuelCharpentier]

comment:4

FWIW

LANG=C.UTF-8 make succeeds.

With qualification : after this (successful) build of the documentation, make in an environment where LANG is fr_FR.utf-8 fails. LANG=C.UTF-8 make succeeds.

In other words, any use of make entailing an attempt to make/check the domumentation will fail if LANG amounts to french...

[dimpase]

comment:5

we can force locale in the Makefile, but this is a hack. I would like an intelligent suppression of warnings, rather than the current scraping on the output.

[dimpase]

comment:6

this should do the job, but we should have also have a long hard look at the mess of favicon and other warnings. Sphinx people say that

[reference] WARNING: l'entrée html_static_path '/home/dimpase/sage/src/doc/common/static' n'existe pas
[reference] WARNING: l'entrée html_static_path 'static' n'existe pas
[reference] WARNING: le fichier de favicon 'favicon.ico' n'existe pas

is an indication of an incorrect configuraion.

There are also still some apparent leftovers of sagenb, e.g. stuff in src/sage/ext_data/images/ - all of it added by commit 0f0517c0c90:

commit 0f0517c0c90716340239eb348757449d1e36d194
Author: agc <agc@kubuntu>
Date:   Sun Dec 10 20:39:48 2006 -0800

    Added a dir "images", and put in several static images for the notebook.

and never touched ever since.

---

New commits:

e959d56

workaround to allow non-EN locales for docbuild

[dimpase]

Branch: u/dimpase/build/setlocale_to_C_docbuild

[dimpase]

Author: Dima Pasechnik

[dimpase]

Commit: e959d56

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

cf52d9a

get rid of old data added by commit 0f0517c0c90