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

Re: quote in help code example

From
BLbill lam <cbill.lam@gmail.com>
Date
Oct 13, 2009, 02:16 UTC
Message-ID
<20091013021616.GA10554@debian.b2j>
In-Reply-To
<20091012194016.GS23777@genesis.frugalware.org>
On Mon, 12 Oct 2009, Miklos Vajna wrote:
Show 16 quoted lines
> On Mon, Oct 12, 2009 at 06:29:26PM +0800, bill lam <cbill.lam@gmail.com> wrote:
> > In git man, eg. git help filter-branch
> > The code examples for command line or shell scripts inside .ft pairs
> > use (smart?) quote instead of single quotes, like
> > 
> >   .ft C
> >    git filter-branch --tree-filter ´rm filename´ HEAD
> >    .ft
> > 
> > Is this intentional or just some configuration problem during
> > compiling.
> 
> Just a guess: do you have docbook-xsl >=1.73.0 and you did not set
> ASCIIDOC_NO_ROFF?
> 
> Try rebuilding the documentation using 'make ASCIIDOC_NO_ROFF=YesPlease'.
I'm not familiar with how to twist git makefile.  By adding a line to ./Makefile

# Platform specific tweaks #

# We choose to avoid "if .. else if .. else .. endif endif" # because maintaining the nesting to match is a pain. If # we had "elif" things would have been much nicer...

ASCIIDOC_NO_ROFF = YesPlease # <--- this line added ifeq ($(uname_S),Linux)

However, the man page still display the same
  .ft C
   git filter-branch --tree-filter ´rm filename´ HEAD
   .ft
I use debian lenny 64bit with
Package: docbook-xsl
Version: 1.73.2.dfsg.1-5
Package: asciidoc
Version: 8.2.7-3~lenny1
-- 
regards,
====================================================
GPG key 1024D/4434BAB3 2008-08-24
gpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3
Previous: Miklos VajnaNext: Miklos Vajna
Message 3 of 18 in “quote in help code example”
  1. bill lamOct 12, 2009
  2. Miklos VajnaOct 12, 2009
  3. bill lamOct 13, 2009
  4. Miklos VajnaOct 13, 2009
  5. bill lamOct 13, 2009
  6. Miklos VajnaOct 13, 2009
  7. Thomas RastOct 13, 2009
  8. Thomas RastOct 15, 2009
  9. Quote ' as \(aq in manpagesThomas Rast, Oct 21, 2009
  10. Miklos VajnaOct 21, 2009
  11. Anders KaseorgOct 21, 2009
  12. Quote ' as \(aq in manpagesThomas Rast, Oct 21, 2009
  13. Document GNU_ROFF in MakefileMiklos Vajna, Oct 21, 2009
  14. Junio C HamanoOct 21, 2009
  15. Anders KaseorgOct 21, 2009
  16. Quote ' as \(aq in manpagesThomas Rast, Oct 22, 2009
  17. Anders KaseorgOct 21, 2009
  18. Junio C HamanoOct 12, 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.