Skip to content

Commit

Permalink
Indicated force wrapping code lines is fragile with Unicode input
Browse files Browse the repository at this point in the history
  • Loading branch information
jfbu committed Feb 8, 2021
1 parent 702545d commit 0076ad3
Showing 1 changed file with 7 additions and 3 deletions.
10 changes: 7 additions & 3 deletions doc/latex.rst
Original file line number Diff line number Diff line change
Expand Up @@ -642,9 +642,13 @@ macros may be significant.
Boolean to specify if long lines in :rst:dir:`code-block`\ 's contents
which the wrapping algorithm could not reduce to at most an excess of 3
characters on a line will be cut forcefully to achieve this maximal excess
of 3 characters on each line. (*this is possibly fragile, so by default is
not done; please try it out and report issues to the maintainers to help
improve and decide whether to make this default*)
of 3 characters on each line. (*this is possibly fragile, and in
particular will break with* ``'pdflatex'``, *if the code-block contains
Unicode input, so by default is not activated; however it will not have
this problem with Unicode engines. Please try it out and report further
issues to the maintainers; injecting* ``\sphinxsetup{verbatimforcewraps}``
*and* ``\sphinxsetup{verbatimforcewraps=false}`` *via* ``.. raw:: latex``
*directives will localize usage to only certain code-blocks*)

Default: ``false``

Expand Down

0 comments on commit 0076ad3

Please sign in to comment.