| Message ID | 20210521224452.530852-7-felipe.contreras@gmail.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | doc: asciidoctor: direct man page creation and fixes | expand |
diff --git a/Documentation/asciidoctor-extensions.rb b/Documentation/asciidoctor-extensions.rb index 6c4153f628..954acb3e7d 100644 --- a/Documentation/asciidoctor-extensions.rb +++ b/Documentation/asciidoctor-extensions.rb @@ -4,6 +4,12 @@ Asciidoctor::Extensions.register :git do doc = document + # Override attributes for man pages. + # https://github.com/asciidoctor/asciidoctor/issues/4059 + if doc.backend == 'manpage' + doc.attributes.merge!({ 'litdd' => '\--', 'plus' => '+' }) + end + inline_macro :linkgit do if doc.doctype == 'book' format = '<ulink url="%1$s.html">%1$s(%2$s)</ulink>'
Currently asciidoctor doesn't convert number character references (&#xx;) correctly for man pages. This hack fixes the issue with minimum changes elsewhere so it's easy to remove when fixed. Fixes doc-diffs like: so line count cannot be shown) and there is no difference between indexed copy and the working tree version (if the working tree version were also different, binary would have been shown in place - of nothing). The other file, git-add--interactive.perl, has 403 - lines added and 35 lines deleted if you commit what is in the - index, but working tree file has further modifications (one + of nothing). The other file, git-add--interactive.perl, + has 403 lines added and 35 lines deleted if you commit what is in + the index, but working tree file has further modifications (one addition and one deletion). https://github.com/asciidoctor/asciidoctor/issues/4059 Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com> --- Documentation/asciidoctor-extensions.rb | 6 ++++++ 1 file changed, 6 insertions(+)