1916093 - When generating docs, handle CRITICAL errors, and make more warnings fatal by default

Status: RESOLVED FIXED

(Developer Infrastructure :: Source Documentation, task)

Description

[Mark Banner (:standard8)]

This set of patches builds on top of bug 1915550 and does the following:

• Tracks CRITICAL errors as errors.
• Makes "fatal" warnings raise errors by default.
  • This will allow developers to see them when they run ./mach doc locally - i.e. without needing to add arguments.
• Removes the last instances of some warnings, and makes them fatal.
  • This should stop new instances of the warnings being introduced.

Comment 1

[Mark Banner (:standard8)]

Attachment: Bug 1916093 - When generating docs, treat critical errors the same as errors. r?sylvestre!

Comment 2

[Mark Banner (:standard8)]

Attachment: Bug 1916093 - Make 'fatal' warnings during documentation raise errors by default. r?sylvestre!

Comment 3

[Mark Banner (:standard8)]

Attachment: Bug 1916093 - Enable more documentation generation warnings as fatal. r?sylvestre!

Comment 4

[Mark Banner (:standard8)]

Attachment: Bug 1916093 - Fix some minor nspr documentation generation warnings. r?kaie!

Comment 5

[Mark Banner (:standard8)]

Attachment: Bug 1916093 - Fix a few more warning issues, and reduce the maximum number of warnings count. r?sylvestre!

Comment 6

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/29e8fc266fd6
When generating docs, treat critical errors the same as errors. r=sylvestre,perftest-reviewers,sparky
https://hg.mozilla.org/integration/autoland/rev/a304562e0f13
Make 'fatal' warnings during documentation raise errors by default. r=sylvestre
https://hg.mozilla.org/integration/autoland/rev/879093de785d
Enable more documentation generation warnings as fatal. r=sylvestre,devtools-reviewers,nchevobbe
https://hg.mozilla.org/integration/autoland/rev/5e1b56fe7425
Fix some minor nspr documentation generation warnings. r=kaie,sylvestre
https://hg.mozilla.org/integration/autoland/rev/8948165830ad
Fix a few more warning issues, and reduce the maximum number of warnings count. r=sylvestre,perftest-reviewers,sparky

Comment 7

[pstanciu]

https://hg.mozilla.org/mozilla-central/rev/29e8fc266fd6
https://hg.mozilla.org/mozilla-central/rev/a304562e0f13
https://hg.mozilla.org/mozilla-central/rev/879093de785d
https://hg.mozilla.org/mozilla-central/rev/5e1b56fe7425
https://hg.mozilla.org/mozilla-central/rev/8948165830ad