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

Re: [PATCH 2/4] Emphasize options and force ASCIIDOC escaping of "--"

From
Johannes Sixt <j6t@kdbg.org>
Date
Nov 9, 2013, 08:13 UTC
Message-ID
<527DEE9A.2090503@kdbg.org>
In-Reply-To
<1383958133-4207-1-git-send-email-jstjohn@purdue.edu>
Am 09.11.2013 01:48, schrieb Jason St. John:
> -`--since=<date1>` limits to commits newer than `<date1>`, and using it
> -with `--grep=<pattern>` further limits to commits whose log message
> +'\--since=<date1>' limits to commits newer than `<date1>`, and using it
> +with '\--grep=<pattern>' further limits to commits whose log message

I don't think this kind of change goes in the right direction. Currently, the general style seems to be that options are typeset in monospaced font. I looked at git-merge and git-rebase (and git-log, of course). But after your change, they are typeset in italics, in the HTML version of the manual pages.

I did not find an advice on the preferred formatting, though, except for the last sentence in Documentation/CodingGuidelines.

-- Hannes
Previous: Jonathan NiederNext: Junio C Hamano
Message 6 of 8 in “Emphasize options and force ASCIIDOC escaping of "--"”
  1. 2/4 Emphasize options and force ASCIIDOC escaping of "--"Jason St. John, Nov 9, 2013
  2. 3/4 Correct word usage of "timezone" in "Documentation" directoryJason St. John, Nov 9, 2013
  3. Junio C HamanoNov 12, 2013
  4. 4/4 Correct word usage of "timezone" in "Documentation/RelNotes" directoryJason St. John, Nov 9, 2013
  5. Jonathan NiederNov 9, 2013
  6. Johannes SixtNov 9, 2013
  7. Junio C HamanoNov 11, 2013
  8. Jeff KingNov 12, 2013

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.