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

[PATCH] Improve user-manual html and pdf formatting

From
Thomas Ackermann <th.acker@arcor.de>
Date
Jan 4, 2014, 09:07 UTC
Message-ID
<352636633.1492236.1388826471175.JavaMail.ngmail@webmail10.arcor-online.net>

Use asciidoc style 'article' instead of 'book' and change asciidoc title level. This removes blank first page and superfluous "Part I" page (there is no "Part II") in pdf output. Also pdf size is decreased by this from 77 to 67 pages. In html output this removes unnecessary sub-tocs and chapter numbering.

Signed-off-by: Thomas Ackermann <th.acker@arcor.de>
---
 Documentation/Makefile        | 2 +-
 Documentation/user-manual.txt | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 91a12c7..36c58fc 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -324,7 +324,7 @@ manpage-base-url.xsl: manpage-base-url.xsl.in
 
 user-manual.xml: user-manual.txt user-manual.conf
 	$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
-	$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d book -o $@+ $< && \
+	$(ASCIIDOC) $(ASCIIDOC_EXTRA) -b docbook -d article -o $@+ $< && \
 	mv $@+ $@
 
 technical/api-index.txt: technical/api-index-skel.txt \
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index cbb01a1..130c2f4 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -1,5 +1,5 @@
-Git User Manual
-_______________
+&#65279;Git User Manual
+===============
 
 Git is a fast distributed revision control system.
 
-- 
1.8.5.2.msysgit.0


---
Thomas
Next: Jonathan Nieder
Message 1 of 7 in “Improve user-manual html and pdf formatting”
  1. Improve user-manual html and pdf formattingThomas Ackermann, Jan 4, 2014
  2. Jonathan NiederJan 4, 2014
  3. Øystein WalleJan 4, 2014
  4. Andreas SchwabJan 4, 2014
  5. Øystein WalleJan 4, 2014
  6. Aw: Re: [PATCH] Improve user-manual html and pdf formattingThomas Ackermann, Jan 5, 2014
  7. Junio C HamanoJan 6, 2014

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.