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

Re: [PATCH] git-push.txt: describe how to default to pushing only current branch

From
Jeff King <peff@peff.net>
Date
Mar 14, 2009, 20:34 UTC
Message-ID
<20090314203434.GA15444@coredump.intra.peff.net>
In-Reply-To
<7vd4cjc3da.fsf@gitster.siamese.dyndns.org>
On Fri, Mar 13, 2009 at 08:27:31PM -0500, Chris Johnsen wrote:
Show 7 quoted lines
> In the resulting manpage the inline commands are not very
> obvious (the HTML looks OK though). There is some sort of
> formatting in there, but it does not seem to display any
> differently from the surrounding text when I use man to view it
> on my system.  Would it be better to do something like wrap
> double quotes around the inline commands to help readers viewing
> the manpage?

The problem is that they are supposed to set in a monospaced font, but most terminals are already monospaced. This is actually a problem throughout the documentation, although it is usually only for single-word phrases (like `git-foo`), which don't look nearly as bad as multi-word ones.

Actually, looking closer, the information seems to be lost entirely. Asciidoc renders this to <literal> in the XML, but docbook seems to throw it away when converting to a manpage. In theory it's possible to apply our own xsl style to turn this into something else, and I think that is a better solution than just trying to fix this one spot.

The question is how it _should_ be rendered. Monospace isn't really useful for terminals. Maybe simply putting quotation marks around it would cover all situations (I'm worried it will look funny for single-word instances).

On Sat, Mar 14, 2009 at 12:26:41PM -0700, Junio C Hamano wrote:
> The new text looks reasonable.  Sign-off?
> 
> Any improvement suggestions from others?

It looks fine to me; my only concern is the typesetting, but I think that should be fixed elsewhere, as outlined above.

-Peff
Previous: Junio C HamanoNext: Jeff King
Message 19 of 27 in “Not pushing all branches?”
  1. Peter KreftingMar 13, 2009
  2. Imran M YousufMar 13, 2009
  3. Peter KreftingMar 13, 2009
  4. Johannes SchindelinMar 13, 2009
  5. Finn Arne GangstadMar 13, 2009
  6. John TapsellMar 13, 2009
  7. Johannes SchindelinMar 13, 2009
  8. John TapsellMar 13, 2009
  9. Johannes SchindelinMar 13, 2009
  10. John TapsellMar 13, 2009
  11. Michael J GruberMar 13, 2009
  12. Johannes SchindelinMar 13, 2009
  13. Junio C HamanoMar 13, 2009
  14. Miles BaderMar 14, 2009
  15. Jeff KingMar 17, 2009
  16. Jeff KingMar 13, 2009
  17. git-push.txt: describe how to default to pushing only current branchChris Johnsen, Mar 14, 2009
  18. Junio C HamanoMar 14, 2009
  19. Jeff KingMar 14, 2009
  20. Jeff KingMar 14, 2009
  21. Chris JohnsenMar 15, 2009
  22. Chris JohnsenMar 15, 2009
  23. Jeff KingMar 17, 2009
  24. Junio C HamanoMar 14, 2009
  25. Jeff KingMar 14, 2009
  26. Junio C HamanoMar 16, 2009
  27. git-push.txt: describe how to default to pushing only current branchChris Johnsen, Mar 15, 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.