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

Re: [PATCH 1/2] Documentation/Makefile: make most operations "quiet"

From
Chris Johnsen <chris_johnsen@pobox.com>
Date
Mar 25, 2009, 09:55 UTC
Message-ID
<1237974919-3020-1-git-send-email-chris_johnsen@pobox.com>
In-Reply-To
<20090325042842.GB15498@coredump.intra.peff.net>
On 2009 Mar 24, at 23:28, Jeff King wrote:
Show 10 quoted lines
> On Tue, Mar 24, 2009 at 11:21:39PM -0500, Chris Johnsen wrote:
>
> >  technical/api-index.txt: technical/api-index-skel.txt \
> > -	technical/api-index.sh $(patsubst %,%.txt,$(API_DOCS))
> > +	$(QUIET_GEN)technical/api-index.sh $(patsubst %,%.txt,$(API_DOCS)) && \
> >  	cd technical && sh ./api-index.sh
>
> What's going on here? The line you remove is part of the dependencies,
> but you replace it with a line of build instructions (and make barfs, of
> course).

Yes, I botched that one. The QUIET_GEN should have been on the next line. Thanks for catching it. I fixed it along with error propagation and initially-also-botched "&& chaining" for gitman.texi. I also added QUIET_XSLTPROC for user-manual.html.

I tested the man, html, info, and git-add.texi targets (previously I only ran man and info targets; git-add.texi exercises a rule not otherwise used in the usual targets).

An interdiff from "v1" to what I have now follows (it include parts that would be in 1/2 and 2/2 from "v1").

-- >8 --
 Documentation/Makefile |    9 +++++----
 1 files changed, 5 insertions(+), 4 deletions(-)
diff --git c/Documentation/Makefile w/Documentation/Makefile
index 373a2cc..d145372 100644
--- c/Documentation/Makefile
+++ w/Documentation/Makefile
@@ -92,6 +92,7 @@ ifndef V
 	QUIET_DB2TEXI	= @echo '   ' DB2TEXI $@;
 	QUIET_MAKEINFO	= @echo '   ' MAKEINFO $@;
 	QUIET_DBLATEX	= @echo '   ' DBLATEX $@;
+	QUIET_XSLTPROC	= @echo '   ' XSLTPROC $@;
 	QUIET_GEN	= @echo '   ' GEN $@;
 	QUIET_STDERR	= 2> /dev/null
 	QUIET_SUBDIR0	= +@subdir=
@@ -202,8 +203,8 @@ user-manual.xml: user-manual.txt user-manual.conf
 	$(QUIET_ASCIIDOC)$(ASCIIDOC) -b docbook -d book $<
 
 technical/api-index.txt: technical/api-index-skel.txt \
-	$(QUIET_GEN)technical/api-index.sh $(patsubst %,%.txt,$(API_DOCS)) && \
-	cd technical && sh ./api-index.sh
+	technical/api-index.sh $(patsubst %,%.txt,$(API_DOCS))
+	$(QUIET_GEN)cd technical && sh ./api-index.sh
 
 $(patsubst %,%.html,$(API_DOCS) technical/api-index): %.html : %.txt
 	$(QUIET_ASCIIDOC)$(ASCIIDOC) -b xhtml11 -f asciidoc.conf \
@@ -213,7 +214,7 @@ XSLT = docbook.xsl
 XSLTOPTS = --xinclude --stringparam html.stylesheet docbook-xsl.css
 
 user-manual.html: user-manual.xml
-	xsltproc $(XSLTOPTS) -o $@ $(XSLT) $<
+	$(QUIET_XSLTPROC)xsltproc $(XSLTOPTS) -o $@ $(XSLT) $<
 
 git.info: user-manual.texi
 	$(QUIET_MAKEINFO)$(MAKEINFO) --no-split -o $@ user-manual.texi
@@ -233,7 +234,7 @@ user-manual.pdf: user-manual.xml
 gitman.texi: $(MAN_XML) cat-texi.perl
 	$(QUIET_DB2TEXI)$(RM) $@+ $@ && \
 	($(foreach xml,$(MAN_XML),$(DOCBOOK2X_TEXI) --encoding=UTF-8 \
-		--to-stdout $(xml) &&) true) > $@++
+		--to-stdout $(xml) &&) true) > $@++ && \
 	$(PERL_PATH) cat-texi.perl $@ <$@++ >$@+ && \
 	rm $@++ && \
 	mv $@+ $@
Previous: Jeff KingNext: Chris Johnsen
Message 20 of 25 in “Documentation: XSLT/asciidoc.conf cleanup; tty literals”
  1. 0/8 Documentation: XSLT/asciidoc.conf cleanup; tty literalsChris Johnsen, Mar 24, 2009
  2. 1/8 Documentation: move callouts.xsl to manpage-{base,normal}.xslChris Johnsen, Mar 24, 2009
  3. Jeff KingMar 24, 2009
  4. Chris JohnsenMar 24, 2009
  5. Jeff KingMar 26, 2009
  6. 2/8 Documentation: use parametrized manpage-base.xsl with manpage-{1.72,normal}.xslChris Johnsen, Mar 24, 2009
  7. Jeff KingMar 24, 2009
  8. Chris JohnsenMar 24, 2009
  9. 3/8 Documentation: rename docbook-xsl-172 attribute to git-asciidoc-no-roffChris Johnsen, Mar 24, 2009
  10. Jeff KingMar 24, 2009
  11. Chris JohnsenMar 24, 2009
  12. Jeff KingMar 26, 2009
  13. Junio C HamanoMar 26, 2009
  14. Michael J GruberMar 26, 2009
  15. 4/8 Documentation: move quieting params into manpage-base.xslChris Johnsen, Mar 24, 2009
  16. Jeff KingMar 24, 2009
  17. 1/2 Documentation/Makefile: make most operations "quiet"Chris Johnsen, Mar 25, 2009
  18. 2/2 Documentation/Makefile: break up texi pipelineChris Johnsen, Mar 25, 2009
  19. Jeff KingMar 25, 2009
  20. Chris JohnsenMar 25, 2009
  21. 5/8 Documentation: move "spurious .sp" code into manpage-base.xslChris Johnsen, Mar 24, 2009
  22. 6/8 Documentation: asciidoc.conf: always use <literallayout> for [blocktext]Chris Johnsen, Mar 24, 2009
  23. 7/8 Documentation: asciidoc.conf: fix verse block with block titlesChris Johnsen, Mar 24, 2009
  24. 8/8 Documentation: option to render literal text as bold for manpagesChris Johnsen, Mar 24, 2009
  25. Junio C HamanoMar 26, 2009

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.