Skip to contentSkip to conversation

scripts/bash_aliases, scripts/modified_pages.sh: Move scripts/modified_pages.sh to a function man_gitstaged()

PATCH In review Alejandro Colomar 2 participants 3 messages Feb 22, 2021 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 scripts/bash_aliases, scripts/modified_pages.sh: Move scripts/modified_pages.sh to a function man_gitstaged()

This allows calling the function from anywhere in the git tree, without having to calculate the relative route to the script. It also makes more sense for this piece of code to be a function than a script.

Minor changes: replace <"> by <'>.

---
 scripts/bash_aliases      | 17 ++++++++++++++++-
 scripts/modified_pages.sh | 34 ----------------------------------
 2 files changed, 16 insertions(+), 35 deletions(-)
 delete mode 100755 scripts/modified_pages.sh
scripts/bash_aliases +16 -1
index c0c8bc33e..127ed5d08 100644
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0-only
 ########################################################################
 #
-# (C) Copyright 2021, Alejandro Colomar
+# (C) Copyright 2020, 2021, Alejandro Colomar
 # These functions are free software; you can redistribute them and/or
 # modify them under the terms of the GNU General Public License
 # as published by the Free Software Foundation; version 2.
@@ -147,6 +147,21 @@ function pdfman()
 	xdg-open ${tmp};
 }
 
+#  man_gitstaged  prints a list of all files with changes staged for commit
+# (basename only if the files are within <man?/>), separated by ", ".
+# Usage example:  .../man-pages$ git commit -m "$(man_gitstaged): msg";
+
+function man_gitstaged()
+{
+	git status							\
+	|sed '/Changes not staged for commit:/q'			\
+	|grep -E '^\s*(modified|deleted|new file):'			\
+	|sed 's/^.*:\s*/, /'						\
+	|sed 's%man[1-9]/%%'						\
+	|tr -d '\n'							\
+	|sed 's/^, //'
+}
+
 ########################################################################
 #	Glibc
 
scripts/modified_pages.sh deleted +0 -34
deleted file mode 100755
index f6c4a6cea..000000000
@@ -1,34 +0,0 @@
-#!/bin/bash
-
-## SPDX-License-Identifier: GPL-2.0-only
-########################################################################
-##
-## (C) Copyright 2020, Alejandro Colomar
-## This program is free software; you can redistribute it and/or
-## modify it under the terms of the GNU General Public License
-## as published by the Free Software Foundation; version 2.
-##
-## This program is distributed in the hope that it will be useful,
-## but WITHOUT ANY WARRANTY; without even the implied warranty of
-## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-## GNU General Public License for more details
-## (http://www.gnu.org/licenses/gpl-2.0.html).
-##
-########################################################################
-##
-## The output of this script is a
-## list of all files with changes staged for commit
-## (basename only if the files are within "man?/"),
-## separated by ", ".
-## Usage:
-## git commit -m "$(./scripts/modified_pages.sh): Short message here"
-##
-
-
-git status							\
-|sed "/Changes not staged for commit:/q"			\
-|grep -E "^\s*(modified|deleted|new file):"			\
-|sed "s/^.*:\s*/, /"						\
-|sed "s%man[1-9]/%%"						\
-|tr -d '\n'							\
-|sed "s/^, //"
Signature · 1 line
2.30.1.721.g45526154a5
#1 lore raw

* Alejandro Colomar <[email protected]>, 2021-02-22, 15:03:

scripts/bash_aliases function pdfman() · line 158

Quoted 3 lines
scripts/bash_aliases +3 -0
+	git status							\
+	|sed '/Changes not staged for commit:/q'			\
+	|grep -E '^\s*(modified|deleted|new file):'			\

"git status" (without further options) is not suitable for scripting: "The default, long format, is designed to be human readable, verbose and descriptive. Its contents and format are subject to change at any time."

You could use "git status --porcelain" instead, which has stable and (supposedly) easy to parse format. Or, better, you could use "git diff --staged --name-only".

Signature · 1 line
Jakub Wilk
#2 lore raw

Hey Jakub,

Quoted 9 lines · Jakub Wilk

* Alejandro Colomar <[email protected]>, 2021-02-22, 15:03:

Quoted 3 lines

+    git status                            \
+    |sed '/Changes not staged for commit:/q'            \
+    |grep -E '^\s*(modified|deleted|new file):'            \

"git status" (without further options) is not suitable for scripting: "The default, long format, is designed to be human readable, verbose and descriptive. Its contents and format are subject to change at any time." > You could use "git status --porcelain" instead, which has stable and (supposedly) easy to parse format. Or, better, you could use "git diff
--staged --name-only".

I know I shouldn't script around 'git status'; actually I found out that yesterday. When I read that, I tried to script around 'git status --porcelain', but it's more complex (at least to me, at first glance), and I gave up.

However, 'git diff --staged --name-only' is exactly what I need! I'll prepare a patch with that in a few minutes.

Michael, so that git can follow the code movement relatively easily, I'll write that patch on top of this one, so you can already apply this one.

Thanks a lot!!

Alex

Signature · 3 lines
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/