On Sat, Mar 14, 2009 at 09:49:09PM -0500, Chris Johnsen wrote:
> 1) literals that contain a double quote
>
> $ git grep '`[^`]*"[^`]`' | cat
> config.txt:You can have `[section]` if you have `[section "subsection"]`, but you
>
> There might be a better regexp to find these, I did not think
> about it too long. The above "hit" seems like a reasonable
> literal string. Maybe it is OK to live with this one
> ("[section "subsection"]").
Hmm, good point. Something with typeface that could not be in the string
contents would probably be a better choice. The linkgit: links appear
bolded. We could do that. We could also try underlining, though that
might be hard to read if any strings contained underscores.
I tried to find examples of other manpages that faced the same problem.
I would guess that bold is the best bet (for example, the 'cat' manpage
on my system looks like (excuse my fake markup):
-A, --show-all
equivalent to <b>-vET</b>
> 2) manpage-1.72.xsl
>
> I have been setting DOCBOOK_XSL_172 to avoid the ".ft" problem
> (<http://article.gmane.org/gmane.comp.version-control.git/112943>;
> my system is Mac OS X 10.4.11 with MacPorts asciidoc 8.3.1,
> xmlto version 0.0.21, and docbook-xsl 1.74.0). Since non-null
> DOCBOOK_XSL_172 replaces callouts.xsl with manpage-1.72.xsl, I
> added the line to manpage-1.72.xsl.
The "callouts" XSL is obviously becoming more than that (there is
already a "I know, this is not a callout, but where else to put it?"
comment in it). It probably makes sense to rename it to manpage.xsl (or
even manpage-1.8.xsl), factor out common parts to manpage-base.xsl, and
then include the -base version from both manpage and manpage-1.72.xsl.
Want to do a patch?
-Peff
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
