git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[RFC PATCH 11/12] test: doc: add check for callouts

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
Apr 13, 2023, 11:57 UTC
Message-ID
<20230413115745.116063-12-felipe.contreras@gmail.com>
In-Reply-To
<20230413115745.116063-1-felipe.contreras@gmail.com>
Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
---
 t/t0600-doc-tools.sh | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)
diff --git a/t/t0600-doc-tools.sh b/t/t0600-doc-tools.sh
index cd88027514..545fb0e199 100755
--- a/t/t0600-doc-tools.sh
+++ b/t/t0600-doc-tools.sh
@@ -26,6 +26,17 @@ DESCRIPTION
 -----------
 description
 
+CALLOUTS
+--------
+----
+$ git diff <1>
+$ git diff --cached <2>
+$ git diff @ <3>
+----
+<1> Callout 1
+<2> Callout 2
+<3> Callout 3
+
 GIT
 ---
 Part of the linkgit:git[1] suite
@@ -49,6 +60,27 @@ git-foo \- Test command
 .SH "DESCRIPTION"
 .sp
 description
+.SH "CALLOUTS"
+.sp
+.if n \{\\
+.RS 4
+.\}
+.nf
+$ git diff \fB(1)\fR
+$ git diff \-\-cached \fB(2)\fR
+$ git diff @ \fB(3)\fR
+.fi
+.if n \{\\
+.RE
+.\}
+.sp
+.sp
+\fB1. \fRCallout 1
+.br
+\fB2. \fRCallout 2
+.br
+\fB3. \fRCallout 3
+.br
 .SH "GIT"
 .sp
 Part of the \fBgit\fR(1) suite
@@ -84,12 +116,12 @@ test_expect_success ASCIIDOC 'legacy asciidoc.py' '
 	check_manpage "git-foo"
 '
 
-test_expect_success ASCIIDOC 'legacy asciidoc.py (docbook5)' '
+test_expect_failure ASCIIDOC 'legacy asciidoc.py (docbook5)' '
 	build_asciidoc_py "git-foo" docbook5 &&
 	check_manpage "git-foo"
 '
 
-test_expect_success ASCIIDOCTOR 'modern asciidoctor (docbook5)' '
+test_expect_failure ASCIIDOCTOR 'modern asciidoctor (docbook5)' '
 	build_asciidoctor "git-foo" &&
 	check_manpage "git-foo"
 '
-- 
2.40.0+fc1
Previous: Felipe ContrerasNext: Felipe Contreras
Message 12 of 13 in “doc: add tests and reimplement xmlto”
  1. 00/12 doc: add tests and reimplement xmltoFelipe Contreras, Apr 13, 2023
  2. 01/12 doc: add test for doc tools outputFelipe Contreras, Apr 13, 2023
  3. 02/12 doc: add missing manpage docinfoFelipe Contreras, Apr 13, 2023
  4. 03/12 doc: remove unnecessary hack for asciidoctorFelipe Contreras, Apr 13, 2023
  5. 04/12 test: doc: add test for docbook5Felipe Contreras, Apr 13, 2023
  6. 05/12 doc: fix support for multiple docbook backendsFelipe Contreras, Apr 13, 2023
  7. 06/12 doc: add gen-stylesheet helperFelipe Contreras, Apr 13, 2023
  8. 07/12 doc: get rid of xmlto dependencyFelipe Contreras, Apr 13, 2023
  9. 08/12 test: doc: use temporary stylesheetFelipe Contreras, Apr 13, 2023
  10. 09/12 doc: remove references to xmltoFelipe Contreras, Apr 13, 2023
  11. 10/12 doc: stylesheet: move all the xslt templatesFelipe Contreras, Apr 13, 2023
  12. 11/12 test: doc: add check for calloutsFelipe Contreras, Apr 13, 2023
  13. 12/12 doc: manpage: remove callout hackFelipe Contreras, Apr 13, 2023

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.