mbox series

[v3,00/12] Enable build and install of our rST docs

Message ID 20190305172139.32662-1-peter.maydell@linaro.org (mailing list archive)
Headers show
Series Enable build and install of our rST docs | expand

Message

Peter Maydell March 5, 2019, 5:21 p.m. UTC 
This patchset enables building and installing the various rST
docs we have started to accumulate in our docs/ directory.

Version 3 is almost the same as version 2: the only
differences are:
 * patch 5 enabling the Alabaster theme also adds
   "needs_sphinx = '1.3'" to docs/conf.py, since that is
   where the Alabaster theme was added to Sphinx proper
 * patch 9 has a new has_sphinx_build() function which
   specifically tests that sphinx-build can handle our
   conf.py, rather than just testing the executable
   is present
 * patch 9 adds /.doctrees to the .gitignore
 * patch 12 is new and provides a MAINTAINERS entry
   for the conf.py files (ie the build infrastructure,
   as distinct from the content)

I figured the changes in patches 5 and 9 were small enough
that I've kept the various reviewed/tested/etc tags.

thanks
-- PMM

Peter Maydell (12):
  docs/cpu-hotplug.rst: Fix rST markup issues
  docs: Convert memory.txt to rst format
  docs: Commit initial files from sphinx-quickstart
  docs/conf.py: Disable unused _static directory
  docs/conf.py: Configure the 'alabaster' theme
  docs/conf.py: Don't include rST sources in HTML build
  docs/conf.py: Disable option warnings
  docs: Provide separate conf.py for each manual we want
  Makefile, configure: Support building rST documentation
  Makefile: Abstract out "identify the pkgversion" code
  docs/conf.py: Don't hard-code QEMU version
  MAINTAINERS: Add entry for Sphinx documentation infrastructure

 configure                             |  15 +-
 Makefile                              |  78 +++++++---
 .gitignore                            |   1 +
 MAINTAINERS                           |   6 +
 docs/conf.py                          | 216 ++++++++++++++++++++++++++
 docs/cpu-hotplug.rst                  |   2 +-
 docs/devel/conf.py                    |  15 ++
 docs/devel/index.rst                  |  21 +++
 docs/devel/{memory.txt => memory.rst} | 128 ++++++++-------
 docs/index.rst                        |  15 ++
 docs/interop/conf.py                  |  15 ++
 docs/interop/index.rst                |  18 +++
 12 files changed, 449 insertions(+), 81 deletions(-)
 create mode 100644 docs/conf.py
 create mode 100644 docs/devel/conf.py
 create mode 100644 docs/devel/index.rst
 rename docs/devel/{memory.txt => memory.rst} (85%)
 create mode 100644 docs/index.rst
 create mode 100644 docs/interop/conf.py
 create mode 100644 docs/interop/index.rst

Comments

no-reply@patchew.org March 5, 2019, 5:44 p.m. UTC | #1 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 * [new tag]               patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
ce1bbf4592 MAINTAINERS: Add entry for Sphinx documentation infrastructure
58caba19e5 docs/conf.py: Don't hard-code QEMU version
a1117b70fb Makefile: Abstract out "identify the pkgversion" code
dd1825f2bb Makefile, configure: Support building rST documentation
3d50302ccc docs: Provide separate conf.py for each manual we want
6820af85f7 docs/conf.py: Disable option warnings
d7b360ddee docs/conf.py: Don't include rST sources in HTML build
388d2c8ace docs/conf.py: Configure the 'alabaster' theme
b9c5183917 docs/conf.py: Disable unused _static directory
ad9f472e30 docs: Commit initial files from sphinx-quickstart
17772cd66c docs: Convert memory.txt to rst format
c700fc8d42 docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit c700fc8d4227 (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit 17772cd66ced (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#24: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit ad9f472e30bb (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#17: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit b9c5183917e3 (docs/conf.py: Disable unused _static directory)
5/12 Checking commit 388d2c8ace51 (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit d7b360ddeeec (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit 6820af85f7c9 (docs/conf.py: Disable option warnings)
8/12 Checking commit 3d50302ccc6c (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit dd1825f2bb81 (Makefile, configure: Support building rST documentation)
10/12 Checking commit a1117b70fbc9 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit 58caba19e578 (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit ce1bbf459216 (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com
no-reply@patchew.org March 5, 2019, 6:17 p.m. UTC | #2 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 t [tag update]            patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
f59fe29d7f MAINTAINERS: Add entry for Sphinx documentation infrastructure
7b59b19041 docs/conf.py: Don't hard-code QEMU version
b8f77058ec Makefile: Abstract out "identify the pkgversion" code
0c6c2fd3a4 Makefile, configure: Support building rST documentation
c88e10b0b6 docs: Provide separate conf.py for each manual we want
e30b5a56f7 docs/conf.py: Disable option warnings
3496ee67d6 docs/conf.py: Don't include rST sources in HTML build
0497f605d2 docs/conf.py: Configure the 'alabaster' theme
e343602608 docs/conf.py: Disable unused _static directory
b8eb65afb7 docs: Commit initial files from sphinx-quickstart
feb8ecbcdd docs: Convert memory.txt to rst format
649b8be5bd docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit 649b8be5bd3c (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit feb8ecbcddba (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#24: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit b8eb65afb7ff (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#17: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit e343602608e8 (docs/conf.py: Disable unused _static directory)
5/12 Checking commit 0497f605d2bb (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit 3496ee67d675 (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit e30b5a56f7fe (docs/conf.py: Disable option warnings)
8/12 Checking commit c88e10b0b6e4 (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit 0c6c2fd3a464 (Makefile, configure: Support building rST documentation)
10/12 Checking commit b8f77058ec91 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit 7b59b1904103 (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit f59fe29d7f9a (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com
no-reply@patchew.org March 6, 2019, 1:28 a.m. UTC | #3 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 t [tag update]            patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
b37e0e545d MAINTAINERS: Add entry for Sphinx documentation infrastructure
6c63356b8d docs/conf.py: Don't hard-code QEMU version
f681007dea Makefile: Abstract out "identify the pkgversion" code
68cf6d5ae1 Makefile, configure: Support building rST documentation
902daac77e docs: Provide separate conf.py for each manual we want
fe2d476636 docs/conf.py: Disable option warnings
6379a4387d docs/conf.py: Don't include rST sources in HTML build
ecd2cccf77 docs/conf.py: Configure the 'alabaster' theme
81c5787a7f docs/conf.py: Disable unused _static directory
fd913234b4 docs: Commit initial files from sphinx-quickstart
6638912038 docs: Convert memory.txt to rst format
dc98fa5ed7 docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit dc98fa5ed7bb (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit 663891203882 (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#25: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit fd913234b490 (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#18: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit 81c5787a7fa7 (docs/conf.py: Disable unused _static directory)
5/12 Checking commit ecd2cccf77de (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit 6379a4387dea (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit fe2d4766361e (docs/conf.py: Disable option warnings)
8/12 Checking commit 902daac77eb6 (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit 68cf6d5ae1d7 (Makefile, configure: Support building rST documentation)
10/12 Checking commit f681007dea19 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit 6c63356b8dde (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit b37e0e545de1 (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com
no-reply@patchew.org March 6, 2019, 1:32 a.m. UTC | #4 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 t [tag update]            patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
735537a7f4 MAINTAINERS: Add entry for Sphinx documentation infrastructure
4428fbad0a docs/conf.py: Don't hard-code QEMU version
89b5d0e749 Makefile: Abstract out "identify the pkgversion" code
cfe0287a58 Makefile, configure: Support building rST documentation
5c3ec2cdfa docs: Provide separate conf.py for each manual we want
d8042c9b50 docs/conf.py: Disable option warnings
4cdaf3004d docs/conf.py: Don't include rST sources in HTML build
5c61204f5c docs/conf.py: Configure the 'alabaster' theme
41dbc87c87 docs/conf.py: Disable unused _static directory
54efc64218 docs: Commit initial files from sphinx-quickstart
3dfd59aa3c docs: Convert memory.txt to rst format
e5881b5de1 docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit e5881b5de1d6 (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit 3dfd59aa3c05 (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#25: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit 54efc64218da (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#18: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit 41dbc87c870b (docs/conf.py: Disable unused _static directory)
5/12 Checking commit 5c61204f5c44 (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit 4cdaf3004d54 (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit d8042c9b507f (docs/conf.py: Disable option warnings)
8/12 Checking commit 5c3ec2cdfab3 (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit cfe0287a5826 (Makefile, configure: Support building rST documentation)
10/12 Checking commit 89b5d0e74995 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit 4428fbad0abc (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit 735537a7f4be (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com
no-reply@patchew.org March 7, 2019, 12:10 a.m. UTC | #5 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 t [tag update]            patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
98332a76a6 MAINTAINERS: Add entry for Sphinx documentation infrastructure
41a1bddb55 docs/conf.py: Don't hard-code QEMU version
8d47807639 Makefile: Abstract out "identify the pkgversion" code
0ce9501263 Makefile, configure: Support building rST documentation
4f8f49b342 docs: Provide separate conf.py for each manual we want
ca6e04cc86 docs/conf.py: Disable option warnings
4ded0d2923 docs/conf.py: Don't include rST sources in HTML build
4c961752ab docs/conf.py: Configure the 'alabaster' theme
3ab58c3a86 docs/conf.py: Disable unused _static directory
7c7d95d884 docs: Commit initial files from sphinx-quickstart
50d1a0524d docs: Convert memory.txt to rst format
b0ae0aef73 docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit b0ae0aef7323 (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit 50d1a0524d68 (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#25: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit 7c7d95d88446 (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#18: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit 3ab58c3a866c (docs/conf.py: Disable unused _static directory)
5/12 Checking commit 4c961752ab4c (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit 4ded0d292312 (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit ca6e04cc8624 (docs/conf.py: Disable option warnings)
8/12 Checking commit 4f8f49b3427c (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit 0ce950126364 (Makefile, configure: Support building rST documentation)
10/12 Checking commit 8d4780763945 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit 41a1bddb55b5 (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit 98332a76a6b7 (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com
no-reply@patchew.org March 7, 2019, 12:15 a.m. UTC | #6 
Patchew URL: https://patchew.org/QEMU/20190305172139.32662-1-peter.maydell@linaro.org/



Hi,

This series seems to have some coding style problems. See output below for
more information:

Type: series
Message-id: 20190305172139.32662-1-peter.maydell@linaro.org
Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs

=== TEST SCRIPT BEGIN ===
#!/bin/bash
git rev-parse base > /dev/null || exit 0
git config --local diff.renamelimit 0
git config --local diff.renames True
git config --local diff.algorithm histogram
./scripts/checkpatch.pl --mailback base..
=== TEST SCRIPT END ===

Updating 3c8cf5a9c21ff8782164d1def7f44bd888713384
From https://github.com/patchew-project/qemu
 t [tag update]            patchew/20190305172139.32662-1-peter.maydell@linaro.org -> patchew/20190305172139.32662-1-peter.maydell@linaro.org
Switched to a new branch 'test'
36d6bf11a6 MAINTAINERS: Add entry for Sphinx documentation infrastructure
ea15377644 docs/conf.py: Don't hard-code QEMU version
55e30c7ac2 Makefile: Abstract out "identify the pkgversion" code
a94aea1a6b Makefile, configure: Support building rST documentation
aed640b8c6 docs: Provide separate conf.py for each manual we want
78927ee307 docs/conf.py: Disable option warnings
11a669fad0 docs/conf.py: Don't include rST sources in HTML build
060ecaed4f docs/conf.py: Configure the 'alabaster' theme
8d1c3f78ea docs/conf.py: Disable unused _static directory
9d5c1f7992 docs: Commit initial files from sphinx-quickstart
db8dfc0df5 docs: Convert memory.txt to rst format
791a4397a6 docs/cpu-hotplug.rst: Fix rST markup issues

=== OUTPUT BEGIN ===
1/12 Checking commit 791a4397a6c4 (docs/cpu-hotplug.rst: Fix rST markup issues)
2/12 Checking commit db8dfc0df513 (docs: Convert memory.txt to rst format)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#26: 
rename from docs/devel/memory.txt

total: 0 errors, 1 warnings, 195 lines checked

Patch 2/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
3/12 Checking commit 9d5c1f799239 (docs: Commit initial files from sphinx-quickstart)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#18: 
new file mode 100644

total: 0 errors, 1 warnings, 188 lines checked

Patch 3/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.
4/12 Checking commit 8d1c3f78ea36 (docs/conf.py: Disable unused _static directory)
5/12 Checking commit 060ecaed4f0f (docs/conf.py: Configure the 'alabaster' theme)
6/12 Checking commit 11a669fad01c (docs/conf.py: Don't include rST sources in HTML build)
7/12 Checking commit 78927ee307f5 (docs/conf.py: Disable option warnings)
8/12 Checking commit aed640b8c6c2 (docs: Provide separate conf.py for each manual we want)
WARNING: added, moved or deleted file(s), does MAINTAINERS need updating?
#102: 
new file mode 100644

ERROR: line over 90 characters
#187: FILE: docs/interop/conf.py:15:
+html_theme_options['description'] = u'System Emulation Management and Interoperability Guide'

total: 1 errors, 1 warnings, 133 lines checked

Patch 8/12 has style problems, please review.  If any of these errors
are false positives report them to the maintainer, see
CHECKPATCH in MAINTAINERS.

9/12 Checking commit a94aea1a6b53 (Makefile, configure: Support building rST documentation)
10/12 Checking commit 55e30c7ac2b4 (Makefile: Abstract out "identify the pkgversion" code)
11/12 Checking commit ea1537764481 (docs/conf.py: Don't hard-code QEMU version)
12/12 Checking commit 36d6bf11a6fd (MAINTAINERS: Add entry for Sphinx documentation infrastructure)
=== OUTPUT END ===

Test command exited with code: 1


The full log is available at
http://patchew.org/logs/20190305172139.32662-1-peter.maydell@linaro.org/testing.checkpatch/?type=message.
---
Email generated automatically by Patchew [http://patchew.org/].
Please send your feedback to patchew-devel@redhat.com