status: add --porcelain output format
authorJeff King <peff@peff.net>
Sat, 5 Sep 2009 08:55:37 +0000 (04:55 -0400)
committerJunio C Hamano <gitster@pobox.com>
Sun, 6 Sep 2009 06:16:31 +0000 (23:16 -0700)
commit6f15787181a163e158c6fee1d79085b97692ac2f
treea86a4f7b10bc564c40edc0b57306ec0f2f8f7a94
parentdd2be243d62260d4c825c22fdd2f61a7da12de22
status: add --porcelain output format

The "short" format was added to "git status" recently to
provide a less verbose way of looking at the same
information. This has two practical uses:

  1. Users who want a more dense display of the information.

  2. Scripts which want to parse the information and need a
     stable, easy-to-parse interface.

For now, the "--short" format covers both of those uses.
However, as time goes on, users of (1) may want additional
format tweaks, or for "git status" to change its behavior
based on configuration variables. Those wishes will be at
odds with (2), which wants to stability for scripts.

This patch introduces a separate --porcelain option early to
avoid problems later on.  Right now the --short and
--porcelain outputs are identical. However, as time goes on,
we will have the freedom to customize --short for human
consumption while keeping --porcelain stable.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-status.txt
builtin-commit.c