[gtkmm] tools/gen_scripts/gtk_generate_extra_defs.sh: Add --make-patch option.

[Kjell Ahlstedt <kjellahl src gnome org>]

commit 26f97780cb9675b014cc93bff5866ffd75ed2e1c
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Thu Sep 5 17:21:51 2013 +0200

    tools/gen_scripts/gtk_generate_extra_defs.sh: Add --make-patch option.

 tools/gen_scripts/gtk_generate_extra_defs.sh |   30 ++++++++++++++++++++++++-
 1 files changed, 28 insertions(+), 2 deletions(-)
---
diff --git a/tools/gen_scripts/gtk_generate_extra_defs.sh b/tools/gen_scripts/gtk_generate_extra_defs.sh
index e6e74a3..1763155 100755
--- a/tools/gen_scripts/gtk_generate_extra_defs.sh
+++ b/tools/gen_scripts/gtk_generate_extra_defs.sh
@@ -2,11 +2,37 @@
 
 # The script assumes that it resides in the tools/gen_scripts directory
 # and the defs files will be placed in gtk/src.
+# It shall be executed from the tools/gen_scripts directory.
+
+# To update the gtk_signals.defs file:
+# 1. ./gtk_generate_extra_defs.sh
+#    Generates gtk/src/gtk_signals.defs.orig and gtk/src/gtk_signals.defs.
+#    If any hunks from the patch file fail to apply, apply them manually to the
+#    gtk_signals.defs file, if required.
+# 2. Optional: Remove gtk/src/gtk_signals.defs.orig.
+
+# To update the gtk_signals.defs file and the patch file:
+# 1. Like step 1 when updating only the gtk_signals.defs file.
+# 2. Apply new patches manually to the gtk_signals.defs file.
+# 3. ./gtk_generate_extra_defs.sh --make-patch
+# 4. Like step 2 when updating only the gtk_signals.defs file.
 
 ROOT_DIR="$(dirname "$0")/../.."
 GEN_DIR="$ROOT_DIR/tools/extra_defs_gen"
 OUT_DIR="$ROOT_DIR/gtk/src"
+OUT_DEFS_FILE="$OUT_DIR"/gtk_signals.defs
 
-"$GEN_DIR"/generate_defs_gtk > "$OUT_DIR"/gtk_signals.defs
-patch "$OUT_DIR"/gtk_signals.defs "$OUT_DIR"/gtk_signals.defs.patch
+if [ $# -eq 0 ]
+then
+  # Without LC_ALL=C documentation (docs "xxx") may be translated in the .defs file.
+  LC_ALL=C "$GEN_DIR"/generate_defs_gtk > "$OUT_DEFS_FILE"
+  PATCH_OPTIONS="--backup --version-control=simple --suffix=.orig"
+  patch $PATCH_OPTIONS "$OUT_DEFS_FILE" "$OUT_DEFS_FILE".patch
+elif [ "$1" = "--make-patch" ]
+then
+  diff --unified=10 "$OUT_DEFS_FILE".orig "$OUT_DEFS_FILE" > "$OUT_DEFS_FILE".patch
+else
+  echo "Usage: $0 [--make-patch]"
+  exit 1
+fi