diff options
author | Matthew Woehlke <matthew.woehlke@kitware.com> | 2023-03-13 13:31:38 -0400 |
---|---|---|
committer | Matthew Woehlke <matthew.woehlke@kitware.com> | 2023-03-13 13:31:38 -0400 |
commit | 39ecaa5da1f1e42cb62d4ce3d6870409cdefec07 (patch) | |
tree | 19cc31480f40825ec15be1656aeb552b19356e07 /Source/cmXCodeScheme.h | |
parent | 9db40bec4e1004baa8b397c8b52c248d8de71f67 (diff) | |
download | cmake-39ecaa5da1f1e42cb62d4ce3d6870409cdefec07.tar.gz |
Utilities/Sphinx: Improve word wrap of signatures
Implement logic to support several styles of parsing in the new
signature directive that control where line breaks are allowed in a
signature.
The default is 'smart', which forbids breaks inside of square- or
angle-brackets. The 'verbatim' option forbids all breaks. In all cases,
breaks are always allowed where a newline appears in the source.
This seems to Just Work for most writers, but HTML needs some special
handling that is accomplished by a new CSS rule and assigning the 'nbsp'
class to spaces that are not allowed to break. (ROFF's line wrapping is
rather unfortunate here, as it prefers splitting and hyphenating words
rather than breaking at a space.)
Diffstat (limited to 'Source/cmXCodeScheme.h')
0 files changed, 0 insertions, 0 deletions