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

Bug report : git-status manual fibs about semantics of --porcelain

From
Mark Jason Dominus <mjd@plover.com>
Date
May 19, 2011, 18:01 UTC
Message-ID
<30543.1305828072@plover.com>
The 1.7.5.1 manual says:
     --porcelain::
    	Give the output in a stable, easy-to-parse format for scripts.
    	Currently this is identical to --short output, but is guaranteed
    	not to change in the future, making it safe for scripts.

However, this is not actually true. --porcelain differs from --short in at least two ways, one of them significant.

--short is colorized when color.status = auto, while --porcelain is not.

More importantly, --short reports file paths relative to the current directory, while --porcelain reports file paths relative to the root of the repository.

All of this was the case in 1.7.0.4 also, and presumably the versions in between.

Mark Jason Dominus 	  			                 mjd@plover.com
Next: Jeff King
Message 1 of 6 in “Bug report : git-status manual fibs about semantics of --porcelain”
  1. Mark Jason DominusMay 19, 2011
  2. 1/4 docs: minor grammar fixes to git-statusJeff King, May 27, 2011
  3. 2/4 docs: update status --porcelain formatJeff King, May 27, 2011
  4. 3/4 docs: make sure literal "->" isn't converted to arrowJeff King, May 27, 2011
  5. 4/4 docs: fix some antique example outputJeff King, May 27, 2011
  6. Junio C HamanoMay 27, 2011

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.