PDF output fixes
Subsystems (8)
PATCH 4/5 docs: kbuild: fix build with pdf and fix some minor issues
In reply to Mauro Carvalho ChehabThe tag ".. include" should be replaced by ".. literalinclude" at issues.rst, otherwise it causes TeX to crash due to excessive usage of stack with Sphinx 2.0.
While here, solve a few minor issues at the kbuild book output by adding extra blank lines.
--- Documentation/kbuild/issues.rst | 20 ++++++++++++-------- Documentation/kbuild/kbuild.rst | 3 ++- Documentation/kbuild/kconfig-language.rst | 12 ++++++++++++ Documentation/kbuild/kconfig.rst | 8 ++++++-- Documentation/kbuild/makefiles.rst | 1 + 5 files changed, 33 insertions(+), 11 deletions(-)
Documentation/kbuild/issues.rst +12 -8
@@ -1,11 +1,15 @@ -Recursion issue #1 ------------------- +================ +Recursion issues +================ - .. include:: Kconfig.recursion-issue-01 - :literal: +issue #1 +-------- -Recursion issue #2 ------------------- +.. literalinclude:: Kconfig.recursion-issue-01 + :language: kconfig - .. include:: Kconfig.recursion-issue-02 - :literal: +issue #2 +-------- + +.. literalinclude:: Kconfig.recursion-issue-02 + :language: kconfig
Documentation/kbuild/kbuild.rst +2 -1
@@ -18,7 +18,7 @@ This file lists all modules that are built into the kernel. This is used by modprobe to not fail when trying to load something builtin. modules.builtin.modinfo --------------------------------------------------- +----------------------- This file contains modinfo from all modules that are built into the kernel. Unlike modinfo of a separate module, all fields are prefixed with module name.
@@ -153,6 +153,7 @@ Install script called when using "make install". The default name is "installkernel". The script will be called with the following arguments: + - $1 - kernel version - $2 - kernel image file - $3 - kernel map file
Documentation/kbuild/kconfig-language.rst +12 -0
@@ -53,6 +53,7 @@ A menu entry can have a number of attributes. Not all of them are applicable everywhere (see syntax). - type definition: "bool"/"tristate"/"string"/"hex"/"int" + Every config option must have a type. There are only two basic types: tristate and string; the other types are based on these two. The type definition optionally accepts an input prompt, so these two examples
@@ -66,11 +67,13 @@ applicable everywhere (see syntax). prompt "Networking support" - input prompt: "prompt" <prompt> ["if" <expr>] + Every menu entry can have at most one prompt, which is used to display to the user. Optionally dependencies only for this prompt can be added with "if". - default value: "default" <expr> ["if" <expr>] + A config option can have any number of default values. If multiple default values are visible, only the first defined one is active. Default values are not limited to the menu entry where they are
@@ -112,6 +115,7 @@ applicable everywhere (see syntax). Optionally dependencies for this default value can be added with "if". - dependencies: "depends on" <expr> + This defines a dependency for this menu entry. If multiple dependencies are defined, they are connected with '&&'. Dependencies are applied to all other options within this menu entry (which also
@@ -127,6 +131,7 @@ applicable everywhere (see syntax). default y - reverse dependencies: "select" <symbol> ["if" <expr>] + While normal dependencies reduce the upper limit of a symbol (see below), reverse dependencies can be used to force a lower limit of another symbol. The value of the current menu symbol is used as the
@@ -146,6 +151,7 @@ applicable everywhere (see syntax). the illegal configurations all over. - weak reverse dependencies: "imply" <symbol> ["if" <expr>] + This is similar to "select" as it enforces a lower limit on another symbol except that the "implied" symbol's value may still be set to n from a direct dependency or with a visible prompt.
@@ -176,6 +182,7 @@ applicable everywhere (see syntax). configure that subsystem out without also having to unset these drivers. - limiting menu display: "visible if" <expr> + This attribute is only applicable to menu blocks, if the condition is false, the menu block is not displayed to the user (the symbols contained there can still be selected by other symbols, though). It is
@@ -183,12 +190,14 @@ applicable everywhere (see syntax). entries. Default value of "visible" is true. - numerical ranges: "range" <symbol> <symbol> ["if" <expr>] + This allows to limit the range of possible input values for int and hex symbols. The user can only input a value which is larger than or equal to the first symbol and smaller than or equal to the second symbol. - help text: "help" or "---help---" + This defines a help text. The end of the help text is determined by the indentation level, this means it ends at the first line which has a smaller indentation than the first line of the help text.
@@ -197,6 +206,7 @@ applicable everywhere (see syntax). the file as an aid to developers. - misc options: "option" <symbol>[=<value>] + Various less common options can be defined via this option syntax, which can modify the behaviour of the menu entry and its config symbol. These options are currently possible:
@@ -325,6 +335,7 @@ end a menu entry: The first five also start the definition of a menu entry. config:: + "config" <symbol> <config options>
@@ -332,6 +343,7 @@ This defines a config symbol <symbol> and accepts any of above attributes as options. menuconfig:: + "menuconfig" <symbol> <config options>
Documentation/kbuild/kconfig.rst +6 -2
@@ -264,6 +264,7 @@ NCONFIG_MODE This mode shows all sub-menus in one large tree. Example:: + make NCONFIG_MODE=single_menu nconfig ----------------------------------------------------------------------
@@ -277,9 +278,12 @@ Searching in xconfig: names, so you have to know something close to what you are looking for. - Example: + Example:: + Ctrl-F hotplug - or + + or:: + Menu: File, Search, hotplug lists all config symbol entries that contain "hotplug" in
Documentation/kbuild/makefiles.rst +1 -0
@@ -384,6 +384,7 @@ more details, with real examples. ----------------------- Kbuild tracks dependencies on the following: + 1) All prerequisite files (both `*.c` and `*.h`) 2) `CONFIG_` options used in all prerequisite files 3) Command-line used to compile target
Signature · 1 line
2.21.0
PATCH 1/5 docs: don't use nested tables
In reply to Mauro Carvalho ChehabNested tables aren't supported for pdf output on Sphinx 1.7.9:
admin-guide/laptops/sonypi:: nested tables are not yet implemented. admin-guide/laptops/toshiba_haps:: nested tables are not yet implemented. driver-api/nvdimm/btt:: nested tables are not yet implemented. s390/debugging390:: nested tables are not yet implemented.
--- Documentation/admin-guide/laptops/sonypi.rst | 26 +++++++++---------- .../admin-guide/laptops/toshiba_haps.rst | 8 +++--- Documentation/driver-api/nvdimm/btt.rst | 2 +- Documentation/s390/debugging390.rst | 2 +- 4 files changed, 18 insertions(+), 20 deletions(-)
Documentation/admin-guide/laptops/sonypi.rst +12 -14
@@ -53,7 +53,7 @@ module or sonypi.<param>=<value> on the kernel boot line when sonypi is statically linked into the kernel). Those options are: =============== ======================================================= - minor: minor number of the misc device /dev/sonypi, + minor: minor number of the misc device /dev/sonypi, default is -1 (automatic allocation, see /proc/misc or kernel logs)
@@ -89,24 +89,22 @@ statically linked into the kernel). Those options are: set to 0xffffffff, meaning that all possible events will be tried. You can use the following bits to construct your own event mask (from - drivers/char/sonypi.h): + drivers/char/sonypi.h):: - ======================== ====== - SONYPI_JOGGER_MASK 0x0001 - SONYPI_CAPTURE_MASK 0x0002 - SONYPI_FNKEY_MASK 0x0004 - SONYPI_BLUETOOTH_MASK 0x0008 - SONYPI_PKEY_MASK 0x0010 - SONYPI_BACK_MASK 0x0020 - SONYPI_HELP_MASK 0x0040 - SONYPI_LID_MASK 0x0080 - SONYPI_ZOOM_MASK 0x0100 - SONYPI_THUMBPHRASE_MASK 0x0200 + SONYPI_JOGGER_MASK 0x0001 + SONYPI_CAPTURE_MASK 0x0002 + SONYPI_FNKEY_MASK 0x0004 + SONYPI_BLUETOOTH_MASK 0x0008 + SONYPI_PKEY_MASK 0x0010 + SONYPI_BACK_MASK 0x0020 + SONYPI_HELP_MASK 0x0040 + SONYPI_LID_MASK 0x0080 + SONYPI_ZOOM_MASK 0x0100 + SONYPI_THUMBPHRASE_MASK 0x0200 SONYPI_MEYE_MASK 0x0400 SONYPI_MEMORYSTICK_MASK 0x0800 SONYPI_BATTERY_MASK 0x1000 SONYPI_WIRELESS_MASK 0x2000 - ======================== ====== useinput: if set (which is the default) two input devices are created, one which interprets the jogdial events as
Documentation/admin-guide/laptops/toshiba_haps.rst +4 -4
@@ -75,11 +75,11 @@ The sysfs files under /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS620A:00/ are: protection_level The protection_level is readable and writeable, and provides a way to let userspace query the current protection level, as well as set the desired protection level, the - available protection levels are: + available protection levels are:: - ============ ======= ========== ======== - 0 - Disabled 1 - Low 2 - Medium 3 - High - ============ ======= ========== ======== + ============ ======= ========== ======== + 0 - Disabled 1 - Low 2 - Medium 3 - High + ============ ======= ========== ======== reset_protection The reset_protection entry is writeable only, being "1" the only parameter it accepts, it is used to trigger
Documentation/driver-api/nvdimm/btt.rst +1 -1
@@ -83,7 +83,7 @@ flags, and the remaining form the internal block number. ======== ============================================================= Bit Description ======== ============================================================= -31 - 30 Error and Zero flags - Used in the following way: +31 - 30 Error and Zero flags - Used in the following way:: == == ==================================================== 31 30 Description
Documentation/s390/debugging390.rst +1 -1
@@ -170,7 +170,7 @@ currently running at. | +----------------+-------------------------------------------------+ | | 32 | Basic Addressing Mode | | | | | -| | | Used to set addressing mode | +| | | Used to set addressing mode:: | | | | | | | | +---------+----------+----------+ | | | | | PSW 31 | PSW 32 | | |
Signature · 1 line
2.21.0
cover PDF output fixes
In order to be able to build all PDF books, besides the two patches I already sent:
docs: pdf: add all Documentation/*/index.rst to PDF output
docs: automarkup.py: ignore exceptions when seeking for xrefs
A few others are needed:
- patch 1 removes nested tables for a few files I converted, as Sphinx LaTeX builder doesn't support it;
- Patches 2 to 4 addresses some minor issues on some books, usually requiring some blank lines, extra whitespaces or some tag replacement;
- Patch 5 is required in order to be able to build the translations PDF book, as it adds Asian fonts support to XeLaTeX.
This patch series is at:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=extra_fixes_v1
And it is on the top of the ReST conversions that IMO should be sent at the end of this merge window.
Mauro Carvalho Chehab (5):
docs: don't use nested tables
docs: arm: fix a breakage with pdf output
docs: block: fix pdf output
docs: kbuild: fix build with pdf and fix some minor issues
docs: conf.py: add CJK package needed by translations
Documentation/admin-guide/laptops/sonypi.rst | 26 +++++++++---------- .../admin-guide/laptops/toshiba_haps.rst | 8 +++--- Documentation/arm/spear/overview.rst | 1 + Documentation/block/biodoc.rst | 9 ++++--- Documentation/conf.py | 4 +++ Documentation/driver-api/nvdimm/btt.rst | 2 +- Documentation/kbuild/issues.rst | 20 ++++++++------ Documentation/kbuild/kbuild.rst | 3 ++- Documentation/kbuild/kconfig-language.rst | 12 +++++++++ Documentation/kbuild/kconfig.rst | 8 ++++-- Documentation/kbuild/makefiles.rst | 1 + Documentation/s390/debugging390.rst | 2 +- 12 files changed, 61 insertions(+), 35 deletions(-)
Signature · 1 line
2.21.0
PATCH 2/5 docs: arm: fix a breakage with pdf output
Add an extra blank line, as otherwise XeLaTex will complain with:
! LaTeX Error: Too deeply nested.
--- Documentation/arm/spear/overview.rst | 1 + 1 file changed, 1 insertion(+)
Documentation/arm/spear/overview.rst +1 -0
@@ -15,6 +15,7 @@ Introduction Hierarchy in SPEAr is as follows: SPEAr (Platform) + - SPEAr3XX (3XX SOC series, based on ARM9) - SPEAr300 (SOC) - SPEAr300 Evaluation Board
Signature · 1 line
2.21.0
PATCH 5/5 docs: conf.py: add CJK package needed by translations
In reply to Mauro Carvalho ChehabIn order to be able to output Asian symbols with XeLaTeX, we need the xeCJK package, and a default font for CJK symbols.
--- Documentation/conf.py | 4 ++++ 1 file changed, 4 insertions(+)
Documentation/conf.py +4 -0
@@ -277,6 +277,10 @@ latex_elements = { \\setromanfont{DejaVu Serif} \\setmonofont{DejaVu Sans Mono} + % This is needed for translations + \\usepackage{xeCJK} + \\setCJKmainfont{Noto Sans CJK SC} + ''' }
Signature · 1 line
2.21.0
PATCH 3/5 docs: block: fix pdf output
In reply to Mauro Carvalho ChehabAdd an extra blank line and use a markup for the enumberated list, in order to make it possible to build the block book on pdf format.
--- Documentation/block/biodoc.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-)
Documentation/block/biodoc.rst +5 -4
@@ -9,6 +9,7 @@ Notes on the Generic Block Layer Rewrite in Linux 2.5 here might still be useful. Notes Written on Jan 15, 2002: + - Jens Axboe <[email protected]> - Suparna Bhattacharya <[email protected]>
@@ -172,8 +173,8 @@ Some new queue property settings: New queue flags: - QUEUE_FLAG_CLUSTER (see 3.2.2) - QUEUE_FLAG_QUEUED (see 3.2.4) + - QUEUE_FLAG_CLUSTER (see 3.2.2) + - QUEUE_FLAG_QUEUED (see 3.2.4) ii. High-mem i/o capabilities are now considered the default
@@ -478,7 +479,7 @@ With this multipage bio design: - Splitting of an i/o request across multiple devices (as in the case of lvm or raid) is achieved by cloning the bio (where the clone points to the same bi_io_vec array, but with the index and size accordingly modified) -- A linked list of bios is used as before for unrelated merges [*]_ - this +- A linked list of bios is used as before for unrelated merges [#]_ - this avoids reallocs and makes independent completions easier to handle. - Code that traverses the req list can find all the segments of a bio by using rq_for_each_segment. This handles the fact that a request
@@ -489,7 +490,7 @@ With this multipage bio design: [TBD: Should preferably also have a bi_voffset and bi_vlen to avoid modifying bi_offset an len fields] -.. [*] +.. [#] unrelated merges -- a request ends up containing two or more bios that didn't originate from the same place.
Signature · 1 line
2.21.0
Jonathan Corbet
maintainerRe: [PATCH 5/5] docs: conf.py: add CJK package needed by translations
In reply to Mauro Carvalho ChehabQuoted 13 lines · On Tue, 9 Jul 2019 15:33:23 -0300 Mauro Carvalho Chehab…
In order to be able to output Asian symbols with XeLaTeX, we need the xeCJK package, and a default font for CJK symbols.
Signed-off-by Mauro Carvalho Chehab <[email protected]>--- Documentation/conf.py | 4 ++++ 1 file changed, 4 insertions(+)Documentation/conf.py +0
-0
Documentation/conf.py latex_elements = { · line 285
Quoted 9 lines
Documentation/conf.py +4
-0@@ -277,6 +277,10 @@ latex_elements = { \\setromanfont{DejaVu Serif} \\setmonofont{DejaVu Sans Mono} + % This is needed for translations + \\usepackage{xeCJK} + \\setCJKmainfont{Noto Sans CJK SC} + ''' }
Should there be a change to sphinx-pre-install as well so we don't send people down the "which of 5,000 packages do I need now?" rathole?
jon
Jonathan Corbet
maintainerQuoted 8 lines · On Tue, 9 Jul 2019 15:33:18 -0300 Mauro Carvalho Chehab…
In order to be able to build all PDF books, besides the two patches I already sent:
docs: pdf: add all
Documentation/*/index.rstto PDF output
docs:automarkup.py: ignore exceptions when seeking for xrefsA few others are needed:
Quoted 7 lines
- patch 1 removes nested tables for a few files I converted, as Sphinx LaTeX builder doesn't support it;
- Patches 2 to 4 addresses some minor issues on some books, usually requiring some blank lines, extra whitespaces or some tag replacement;
- Patch 5 is required in order to be able to build the translations PDF book, as it adds Asian fonts support to XeLaTeX.
So, modulo my one comment on the last patch the series seems OK, though I don't like having to work around limitations in PDF generation this way. Can't you just make rst2pdf work instead? :)
I guess it makes sense for these to go with the big band-aid-removal patch set.
Thanks,
jon
P.S. it seems that rst2pdf is actually being developed again:
https://akrabat.com/rst2pdf-back-from-the-dead/ . I wonder how far they'll get with it.
Re: [PATCH 5/5] docs: conf.py: add CJK package needed by translations
In reply to Jonathan CorbetEm Fri, 12 Jul 2019 14:12:40 -0600
Jonathan Corbet <[email protected]> escreveu:
Quoted 19 lines
Quoted 16 lines · On Tue, 9 Jul 2019 15:33:23 -0300 Mauro Carvalho Chehab…
In order to be able to output Asian symbols with XeLaTeX, we need the xeCJK package, and a default font for CJK symbols.
Signed-off-by Mauro Carvalho Chehab <[email protected]>--- Documentation/conf.py | 4 ++++ 1 file changed, 4 insertions(+)Documentation/conf.py +0
-0@@ -277,6 +277,10 @@ latex_elements = { \\setromanfont{DejaVu Serif} \\setmonofont{DejaVu Sans Mono}
Quoted 9 lines
Documentation/conf.py latex_elements = { · line 285
Quoted 6 lines
Documentation/conf.py +4
-0+ % This is needed for translations + \\usepackage{xeCJK} + \\setCJKmainfont{Noto Sans CJK SC} + ''' }Should there be a change to sphinx-pre-install as well so we don't send people down the "which of 5,000 packages do I need now?" rathole?
Makes sense. I'll try to add those, probably as a separate patch.
Adding dependencies for the xeCJK package should likely be easy, but the requirements for the Noto font is trickier, as it seems that it requires both a texlive package and a distro-specific one (at least on Fedora - but I suspect the same will likely be true on other distros as well).
I'll need to run it though all VMs I used when I created sphinx-pre-install (or recreate them - I haven't touched them for a while).
Thanks,
Mauro
Em Fri, 12 Jul 2019 14:19:21 -0600
Jonathan Corbet <[email protected]> escreveu:
Quoted 19 lines
Quoted 8 lines · On Tue, 9 Jul 2019 15:33:18 -0300 Mauro Carvalho Chehab…
In order to be able to build all PDF books, besides the two patches I already sent:
docs: pdf: add all
Documentation/*/index.rstto PDF output
docs:automarkup.py: ignore exceptions when seeking for xrefsA few others are needed:
Quoted 7 lines
- patch 1 removes nested tables for a few files I converted, as Sphinx LaTeX builder doesn't support it;
- Patches 2 to 4 addresses some minor issues on some books, usually requiring some blank lines, extra whitespaces or some tag replacement;
- Patch 5 is required in order to be able to build the translations PDF book, as it adds Asian fonts support to XeLaTeX.
Quoted 2 lines
So, modulo my one comment on the last patch the series seems OK, though I don't like having to work around limitations in PDF generation this way.
Yeah, I feel the pain. I didn't like writing those patches either.
Quoted 1 line
Can't you just make rst2pdf work instead? :)
Well, we can try. Last time we tried, there were lots of things missing for it to work.
Based on:
https://pypi.org/project/rst2pdf/
The project got stuck back on Dec, 2012, up to the beginning of this year. Maybe the issues we had in the past got fixed.
Also, right now, rst2pdf only supports Python 2.7.
I would wait for it to support Python 3.x before doing the actual migration.
-
I don't remember the exact details, but when rst2pdf were used with some documents, it didn't produce a valid PDF file, but perhaps someone fixed it.
Assuming that rst2pdf works now, there are still several LaTeX specific hacks on some files:
$ git grep -l latex|grep rst|wc -l 28
I guess almost all of them are related to the lack of proper support at ReST markup language that would allow adjusting the output to fit within the page limits.
On media, we need two types of additional features:
1) Sphinx pdf builder uses two different LaTeX ways of producing a table. (tabular x tabularx x longtable - don't remember anymore the exact two dialects it uses).
One of the dialect allows a table to be on multiple pages; the other one doesn't. The builder decides the dialect if a table has more than 30 columns, but there's a way to force longtable (by changing the css style).
Not sure if rst2pdf honors the same css style.
2) Table scaling / font resize. The Sphinx PDF builder doesn't scale the fonts inside a table, nor the ReST dialect allows changing the font size. So, we had to use raw LaTeX dialects for it to work.
Anyway, I'm enclosing an experimental patch that would enable rst2pdf. It is not at production level.
It also shows some crashes like this one:
[ERROR] pdfbuilder.py:133 format not resolved, probably missing URL scheme or undefined destination target for 'Callback%20Registry' Traceback (most recent call last):
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/pdfbuilder.py", line 130, in write
docwriter.write(doctree, destination)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/docutils/writers/__init__.py", line 80, in write
self.translate()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/pdfbuilder.py", line 633, in translate
compressed=self.compressed)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/createpdf.py", line 664, in createPdf
pdfdoc.multiBuild(elements)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/platypus/doctemplate.py", line 1154, in multiBuild
self.canv.save()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfgen/canvas.py", line 1242, in save
self._doc.SaveToFile(self._filename, self)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 215, in SaveToFile
data = self.GetPDFData(canvas)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 241, in GetPDFData
return self.format()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 423, in format
IOf = IO.format(self)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 871, in format
fcontent = format(self.content, document, toplevel=1) # yes this is at top level
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 80, in format
f = element.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 1608, in format
return D.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 679, in format
L = [(format(PDFName(k),document)+b" "+format(dict[k],document)) for k in keys]
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 80, in format
f = element.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 1773, in format
if f is None: raise ValueError("format not resolved, probably missing URL scheme or undefined destination target for '%s'" % self.name)
ValueError: format not resolved, probably missing URL scheme or undefined destination target for 'Callback%20Registry' FAILED
Quoted 3 lines
I guess it makes sense for these to go with the big band-aid-removal patch set.
OK, I'll send it together with the big patchset.
Quoted 8 lines
Thanks,
jon
P.S. it seems that rst2pdf is actually being developed again:
https://akrabat.com/rst2pdf-back-from-the-dead/ . I wonder how far they'll get with it.
Thanks,
Mauro
[PATCH RFC] docs: experimental: build PDF with rst2pdf
Change the logic to use rst2pdf instead of LaTeX.
Documentation/Makefile +3 -2
@@ -95,9 +95,10 @@ pdfdocs: else # HAVE_PDFLATEX -pdfdocs: latexdocs +pdfdocs: @$(srctree)/scripts/sphinx-pre-install --version-check - $(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX="$(PDFLATEX)" LATEXOPTS="$(LATEXOPTS)" -C $(BUILDDIR)/$(var)/latex || exit;) + mkdir -p $(BUILDDIR)/pdf + @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,pdf,$(var),pdf,$(var))) endif # HAVE_PDFLATEX
Documentation/conf.py +16 -12
@@ -35,13 +35,14 @@ needs_sphinx = '1.3' # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', 'cdomain', - 'kfigure', 'sphinx.ext.ifconfig', 'automarkup'] + 'kfigure', 'sphinx.ext.ifconfig', 'automarkup', 'rst2pdf.pdfbuilder'] -# The name of the math extension changed on Sphinx 1.4 -if (major == 1 and minor > 3) or (major > 1): - extensions.append("sphinx.ext.imgmath") -else: - extensions.append("sphinx.ext.pngmath") +# FIXME: when rst2pdf.pdfbuilder is added, the code below causes an error +## The name of the math extension changed on Sphinx 1.4 +#if (major == 1 and minor > 3) or (major > 1): +# extensions.append("sphinx.ext.imgmath") +#else: +# extensions.append("sphinx.ext.pngmath") # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates']
@@ -564,12 +565,15 @@ epub_exclude_files = ['search.html'] # # See the Sphinx chapter of http://ralsina.me/static/manual.pdf # -# FIXME: Do not add the index file here; the result will be too big. Adding -# multiple PDF files here actually tries to get the cross-referencing right -# *between* PDF files. -pdf_documents = [ - ('kernel-documentation', u'Kernel', u'Kernel', u'J. Random Bozo'), -] + +# Add all LaTeX files to PDF documents as well +pdf_documents = [] +for l in latex_documents: + doc = l[0] + fn = l[1].replace("tex", "pdf") + name = l[2] + authors = l[3] + pdf_documents.append((doc, fn, name, authors)) # kernel-doc extension configuration for running Sphinx directly (e.g. by Read # the Docs). In a normal build, these are supplied from the Makefile via command
Documentation/media/Makefile +2 -1
@@ -53,12 +53,13 @@ $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exception # Media build rules -.PHONY: all html epub xml latex +.PHONY: all html epub xml latex pdf all: $(IMGDOT) $(BUILDDIR) ${TARGETS} html: all epub: all xml: all +pdf: all latex: $(IMGPDF) all linkcheck:
Em Fri, 12 Jul 2019 19:27:05 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:
Quoted 128 lines
Em Fri, 12 Jul 2019 14:19:21 -0600
Jonathan Corbet <[email protected]> escreveu:Quoted 19 lines
Quoted 8 lines · On Tue, 9 Jul 2019 15:33:18 -0300 Mauro Carvalho Chehab…
In order to be able to build all PDF books, besides the two patches I already sent:
docs: pdf: add all
Documentation/*/index.rstto PDF output
docs:automarkup.py: ignore exceptions when seeking for xrefsA few others are needed:
Quoted 7 lines
- patch 1 removes nested tables for a few files I converted, as Sphinx LaTeX builder doesn't support it;
- Patches 2 to 4 addresses some minor issues on some books, usually requiring some blank lines, extra whitespaces or some tag replacement;
- Patch 5 is required in order to be able to build the translations PDF book, as it adds Asian fonts support to XeLaTeX.Quoted 2 lines
So, modulo my one comment on the last patch the series seems OK, though I don't like having to work around limitations in PDF generation this way.
Yeah, I feel the pain. I didn't like writing those patches either.
Quoted 1 line
Can't you just make rst2pdf work instead? :)
Well, we can try. Last time we tried, there were lots of things missing for it to work.
Based on:
https://pypi.org/project/rst2pdf/
The project got stuck back on Dec, 2012, up to the beginning of this year. Maybe the issues we had in the past got fixed.
Also, right now, rst2pdf only supports Python 2.7.
I would wait for it to support Python 3.x before doing the actual migration.
-
I don't remember the exact details, but when rst2pdf were used with some documents, it didn't produce a valid PDF file, but perhaps someone fixed it.
Assuming that rst2pdf works now, there are still several LaTeX specific hacks on some files:
$ git grep -l latex|grep rst|wc -l 28I guess almost all of them are related to the lack of proper support at ReST markup language that would allow adjusting the output to fit within the page limits.
On media, we need two types of additional features:
1) Sphinx pdf builder uses two different LaTeX ways of producing a table. (tabular x tabularx x longtable - don't remember anymore the exact two dialects it uses).
One of the dialect allows a table to be on multiple pages; the other one doesn't. The builder decides the dialect if a table has more than 30 columns, but there's a way to force longtable (by changing the css style).
Not sure if rst2pdf honors the same css style.
2) Table scaling / font resize. The Sphinx PDF builder doesn't scale the fonts inside a table, nor the ReST dialect allows changing the font size. So, we had to use raw LaTeX dialects for it to work.
Anyway, I'm enclosing an experimental patch that would enable rst2pdf. It is not at production level.
It also shows some crashes like this one:
[ERROR] pdfbuilder.py:133 format not resolved, probably missing URL scheme or undefined destination target for 'Callback%20Registry' Traceback (most recent call last):
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/pdfbuilder.py", line 130, in write
docwriter.write(doctree, destination)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/docutils/writers/__init__.py", line 80, in write
self.translate()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/pdfbuilder.py", line 633, in translate
compressed=self.compressed)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/rst2pdf/createpdf.py", line 664, in createPdf
pdfdoc.multiBuild(elements)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/platypus/doctemplate.py", line 1154, in multiBuild
self.canv.save()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfgen/canvas.py", line 1242, in save
self._doc.SaveToFile(self._filename, self)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 215, in SaveToFile
data =self.GetPDFData(canvas)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 241, in GetPDFData
returnself.format()
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 423, in format
IOf =IO.format(self)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 871, in format
fcontent =format(self.content, document, toplevel=1)# yes this is at top level
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 80, in format
f =element.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 1608, in format
returnD.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 679, in format
L = [(format(PDFName(k),document)+b" "+format(dict[k],document)) for k in keys]
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 80, in format
f =element.format(document)
File "/devel/v4l/docs/sphinx_1.7.9/lib/python2.7/site-packages/reportlab/pdfbase/pdfdoc.py", line 1773, in format
if f is None: raise ValueError("format not resolved, probably missing URL scheme or undefined destination target for '%s'" % self.name)
ValueError: format not resolved, probably missing URL scheme or undefined destination target for 'Callback%20Registry' FAILEDQuoted 3 lines
I guess it makes sense for these to go with the big band-aid-removal patch set.
OK, I'll send it together with the big patchset.
Quoted 5 lines
Thanks,
jon
Quoted 8 lines
Quoted 3 lines
P.S. it seems that rst2pdf is actually being developed again:
https://akrabat.com/rst2pdf-back-from-the-dead/ . I wonder how far they'll get with it.Thanks,
Mauro[PATCH RFC] docs: experimental: build PDF with rst2pdf
There are a few issues with the quick hack to use rst2pdf. The enclosed one works better.
Yet, from the existing 70 books (on my experimental tree), rst2pdf breaks with 14 ones.
It seems that the problem is related to broken cross-references. The html builder handles it nicely, but rst2pdf seems to crash when it can't solve all references. That sounds somewhat similar to the bug we solved with the automarkup extension.
Thanks,
Mauro
[PATCH] docs: experimental: build PDF with rst2pdf
Change the logic to use rst2pdf instead of LaTeX.
Documentation/Makefile +7 -2
@@ -89,18 +89,22 @@ latexdocs: ifeq ($(HAVE_PDFLATEX),0) -pdfdocs: +oldpdfdocs: $(warning The '$(PDFLATEX)' command was not found. Make sure you have it installed and in PATH to produce PDF output.) @echo " SKIP Sphinx $@ target." else # HAVE_PDFLATEX -pdfdocs: latexdocs +oldpdfdocs: latexdocs @$(srctree)/scripts/sphinx-pre-install --version-check $(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX="$(PDFLATEX)" LATEXOPTS="$(LATEXOPTS)" -C $(BUILDDIR)/$(var)/latex || exit;) endif # HAVE_PDFLATEX +pdfdocs: + @$(srctree)/scripts/sphinx-pre-install --version-check + @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,pdf,$(var),pdf,$(var))) + epubdocs: @$(srctree)/scripts/sphinx-pre-install --version-check @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,epub,$(var),epub,$(var)))
@@ -126,6 +130,7 @@ dochelp: @echo ' htmldocs - HTML' @echo ' latexdocs - LaTeX' @echo ' oldpdfdocs - PDF' + @echo ' pdfdocs - PDF, using experimental rst2pdf support' @echo ' epubdocs - EPUB' @echo ' xmldocs - XML' @echo ' linkcheckdocs - check for broken external links (will connect to external hosts)'
Documentation/conf.py +11 -6
@@ -43,6 +43,8 @@ if (major == 1 and minor > 3) or (major > 1): else: extensions.append("sphinx.ext.pngmath") +extensions.append("rst2pdf.pdfbuilder") + # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates']
@@ -564,12 +566,15 @@ epub_exclude_files = ['search.html'] # # See the Sphinx chapter of http://ralsina.me/static/manual.pdf # -# FIXME: Do not add the index file here; the result will be too big. Adding -# multiple PDF files here actually tries to get the cross-referencing right -# *between* PDF files. -pdf_documents = [ - ('kernel-documentation', u'Kernel', u'Kernel', u'J. Random Bozo'), -] + +# Add all LaTeX files to PDF documents as well +pdf_documents = [] +for l in latex_documents: + doc = l[0] + fn = l[1].replace(".tex", "") + name = l[2] + authors = l[3] + pdf_documents.append((doc, fn, name, authors)) # kernel-doc extension configuration for running Sphinx directly (e.g. by Read # the Docs). In a normal build, these are supplied from the Makefile via command
Documentation/media/Makefile +2 -1
@@ -53,12 +53,13 @@ $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exception # Media build rules -.PHONY: all html epub xml latex +.PHONY: all html epub xml latex pdf all: $(IMGDOT) $(BUILDDIR) ${TARGETS} html: all epub: all xml: all +pdf: all latex: $(IMGPDF) all linkcheck:
Makefile +1 -1
@@ -1562,7 +1562,7 @@ $(help-board-dirs): help-%: # Documentation targets # --------------------------------------------------------------------------- DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \ - linkcheckdocs dochelp refcheckdocs + linkcheckdocs dochelp refcheckdocs oldpdfdocs PHONY += $(DOC_TARGETS) $(DOC_TARGETS): scripts_basic FORCE $(Q)$(MAKE) $(build)=Documentation $@
Using rst2pdf for PDF output - Was: Re: [PATCH 0/5] PDF output fixes
Em Sat, 13 Jul 2019 00:41:25 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:
Quoted 9 lines
Em Fri, 12 Jul 2019 19:27:05 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:Quoted 6 lines
Em Fri, 12 Jul 2019 14:19:21 -0600
Jonathan Corbet <[email protected]> escreveu:Quoted 1 line
Can't you just make rst2pdf work instead? :)
Well, we can try.
Doing some tests right now with upstream version of it. I actually created a fork:
https://github.com/mchehab/rst2pdf
basically upstream + some pending PRs + 2 fixes and a hack:
https://github.com/mchehab/rst2pdf/commits/master
Quoted 4 lines
Quoted 4 lines
Also, right now, rst2pdf only supports Python 2.7.
I would wait for it to support Python 3.x before doing the actual migration.
The upstream version runs on python 3.x. There are a few issues there yet to be solved.
Quoted 2 lines
There are a few issues with the quick hack to use rst2pdf. The enclosed one works better.
Did another improvement (see enclosed). This one should be applied after my PDF fixes branch:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=pdf_fixes_v1
I suspect that we'll also need a patch for kfigure.py, in order for it to support kernel-figure output.
Quoted 3 lines
Yet, from the existing 70 books (on my experimental tree), rst2pdf breaks with 14 ones.
I was able to find one of the reason some books failed: rst2pdf has a "hidden" dependency:
svglib
Without that, it will silently ignore SVG images, causing the script to break.
Even with that, it will still break (reporting success), even on not so complex books. For example:
$ make SPHINXDIRS=hwmon pdfdocs
writing hwmon...
[ERROR] pdfbuilder.py:150 More than 10 pages generated without content - halting layout. Likely that a flowable is too large for any frame. Traceback (most recent call last):
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/rst2pdf-0.95.dev0-py3.7.egg/rst2pdf/pdfbuilder.py", line 147, in write
docwriter.write(doctree, destination)
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/docutils/writers/__init__.py", line 80, in write
self.translate()
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/rst2pdf-0.95.dev0-py3.7.egg/rst2pdf/pdfbuilder.py", line 643, in translate
compressed=self.compressed)
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/rst2pdf-0.95.dev0-py3.7.egg/rst2pdf/createpdf.py", line 643, in createPdf
pdfdoc.multiBuild(elements)
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/reportlab/platypus/doctemplate.py", line 1144, in multiBuild
self.build(tempStory, **buildKwds)
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/reportlab/platypus/doctemplate.py", line 1057, in build
self.handle_flowable(flowables)
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/rst2pdf-0.95.dev0-py3.7.egg/rst2pdf/createpdf.py", line 791, in handle_flowable
self.handle_frameEnd()
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/reportlab/platypus/doctemplate.py", line 709, in handle_frameEnd
self.handle_pageEnd()
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/reportlab/platypus/doctemplate.py", line 651, in handle_pageEnd
raise LayoutError(ident)
reportlab.platypus.doctemplate.LayoutError: More than 10 pages generated without content - halting layout. Likely that a flowable is too large for any frame. FAILED
build succeeded.
Patch enclosed.
Thanks,
Mauro
---
[PATCH] docs: experimental: build PDF with rst2pdf
Change the logic to use rst2pdf instead of LaTeX.
Documentation/Makefile +7 -2
@@ -94,18 +94,22 @@ latexdocs: ifeq ($(HAVE_PDFLATEX),0) -pdfdocs: +oldpdfdocs: $(warning The '$(PDFLATEX)' command was not found. Make sure you have it installed and in PATH to produce PDF output.) @echo " SKIP Sphinx $@ target." else # HAVE_PDFLATEX -pdfdocs: latexdocs +oldpdfdocs: latexdocs @$(srctree)/scripts/sphinx-pre-install --version-check $(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX="$(PDFLATEX)" LATEXOPTS="$(LATEXOPTS)" -C $(BUILDDIR)/$(var)/latex || exit;) endif # HAVE_PDFLATEX +pdfdocs: + @$(srctree)/scripts/sphinx-pre-install --version-check + @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,pdf,$(var),pdf,$(var))) + epubdocs: @$(srctree)/scripts/sphinx-pre-install --version-check @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,epub,$(var),epub,$(var)))
@@ -131,6 +135,7 @@ dochelp: @echo ' htmldocs - HTML' @echo ' latexdocs - LaTeX' @echo ' pdfdocs - PDF' + @echo ' rst2pdf - PDF, using experimental rst2pdf support' @echo ' epubdocs - EPUB' @echo ' xmldocs - XML' @echo ' linkcheckdocs - check for broken external links (will connect to external hosts)'
Documentation/conf.py +11 -6
@@ -46,6 +46,8 @@ if (major == 1 and minor > 3) or (major > 1): else: extensions.append("sphinx.ext.pngmath") +extensions.append("rst2pdf.pdfbuilder") + # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates']
@@ -574,12 +576,15 @@ epub_exclude_files = ['search.html'] # # See the Sphinx chapter of http://ralsina.me/static/manual.pdf # -# FIXME: Do not add the index file here; the result will be too big. Adding -# multiple PDF files here actually tries to get the cross-referencing right -# *between* PDF files. -pdf_documents = [ - ('kernel-documentation', u'Kernel', u'Kernel', u'J. Random Bozo'), -] + +# Add all LaTeX files to PDF documents as well +pdf_documents = [] +for l in latex_documents: + doc = l[0] + fn = l[1].replace(".tex", "") + name = l[2] + authors = l[3] + pdf_documents.append((doc, fn, name, authors)) # kernel-doc extension configuration for running Sphinx directly (e.g. by Read # the Docs). In a normal build, these are supplied from the Makefile via command
Documentation/media/Makefile +2 -1
@@ -53,12 +53,13 @@ $(BUILDDIR)/lirc.h.rst: ${UAPI}/lirc.h ${PARSER} $(SRC_DIR)/lirc.h.rst.exception # Media build rules -.PHONY: all html epub xml latex +.PHONY: all html epub xml latex pdf all: $(IMGDOT) $(BUILDDIR) ${TARGETS} html: all epub: all xml: all +pdf: all latex: $(IMGPDF) all linkcheck:
Documentation/sphinx/load_config.py +11 -0
@@ -43,6 +43,17 @@ def loadConfig(namespace): namespace['latex_documents'] = new_latex_docs + # Add LaTeX files to PDF documents as well + pdf_documents = [] + for l in new_latex_docs: + doc = l[0] + fn = l[1].replace(".tex", "") + name = l[2] + authors = l[3] + pdf_documents.append((doc, fn, name, authors)) + + namespace['pdf_documents'] = pdf_documents + # If there is an extra conf.py file, load it if os.path.isfile(config_file): sys.stdout.write("load additional sphinx-config: %s\n" % config_file)
Makefile +1 -1
@@ -1564,7 +1564,7 @@ $(help-board-dirs): help-%: # Documentation targets # --------------------------------------------------------------------------- DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \ - linkcheckdocs dochelp refcheckdocs + linkcheckdocs dochelp refcheckdocs oldpdfdocs PHONY += $(DOC_TARGETS) $(DOC_TARGETS): scripts_basic FORCE $(Q)$(MAKE) $(build)=Documentation $@
Re: Using rst2pdf for PDF output - Was: Re: [PATCH 0/5] PDF output fixes
Am 18.07.19 um 19:46 schrieb Mauro Carvalho Chehab:
Quoted 12 lines
Em Sat, 13 Jul 2019 00:41:25 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:Quoted 9 lines
Em Fri, 12 Jul 2019 19:27:05 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:Quoted 6 lines
Em Fri, 12 Jul 2019 14:19:21 -0600
Jonathan Corbet <[email protected]> escreveu:Quoted 1 line
Can't you just make rst2pdf work instead? :)
Well, we can try.
Thanks a lot for your investigation on this. I also checked the rst2pdf sources a while ago, for me it was crap with crap requirements [1] .. my tip: don't waste to much time on it.
[1] https://github.com/mchehab/rst2pdf/blob/master/requirements.txt#L31
-- Markus --
Re: Using rst2pdf for PDF output - Was: Re: [PATCH 0/5] PDF output fixes
Em Thu, 18 Jul 2019 19:56:57 +0200
Markus Heiser <[email protected]> escreveu:
Quoted 12 lines
Am 18.07.19 um 19:46 schrieb Mauro Carvalho Chehab:
Quoted 11 lines
Em Sat, 13 Jul 2019 00:41:25 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:Quoted 8 lines
Em Fri, 12 Jul 2019 19:27:05 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:Quoted 5 lines
Em Fri, 12 Jul 2019 14:19:21 -0600
Jonathan Corbet <[email protected]> escreveu:Quoted 1 line
Can't you just make rst2pdf work instead? :)
Quoted 8 lines
Quoted 1 line
Quoted 1 line
Quoted 1 line
Well, we can try.
Thanks a lot for your investigation on this. I also checked the rst2pdf sources a while ago, for me it was crap with crap requirements [1] .. my tip: don't waste to much time on it.
[1] https://github.com/mchehab/rst2pdf/blob/master/requirements.txt#L31
Yeah, a simple test shows that this upstream rst2pdf + latest reportlab has some issues.
Running this:
$ rst2pdf Documentation/process/license-rules.rst
causes an error with reportlab-3.5.23. It has to be downgraded to version 3.4 in order to avoid this error:
File "/devel/v4l/docs_temp/sphinx_2.0.1/lib/python3.7/site-packages/reportlab/platypus/doctemplate.py", line 651, in handle_pageEnd
raise LayoutError(ident)
reportlab.platypus.doctemplate.LayoutError: More than 10 pages generated without content - halting layout. Likely that a flowable is too large for any frame.
Another solution would be to do this:
Documentation/process/license-rules.rst +3 -0
@@ -452,7 +452,10 @@ _`MODULE_LICENSE` module source is dual licensed under a GPL v2 variant and MIT license. Please do not use in new code. + ============================= ============================================= + + ============================= ============================================= "Dual MIT/GPL" The correct way of expressing that the module is dual licensed under a GPL v2 variant or MIT license choice.
But it sucks needing to break long tables because reportlab's handling for big tables is broken.
Thanks,
Mauro