[projects/git-slug] Rozszerzony opis 'git pld update --help'

[arekm]

commit 72b288513359b27178f23873aa0349f5f24e6450
Author: Arkadiusz Miśkiewicz <arekm at maven.pl>
Date:   Tue Apr 7 09:31:34 2026 +0200

    Rozszerzony opis 'git pld update --help'
    
    Wcześniejszy 'Smart fetch using centralized Refs repo' nie tłumaczył
    co komenda właściwie robi i jakie ma typowe zastosowania. Nowy opis
    wyjaśnia mechanizm (zapytanie do centralnego Refs repo zamiast 'git
    fetch' w każdym repo) oraz wskazuje typowe przepływy: --new dla nowych
    pakietów, --prune dla usuniętych, --branch dla innych gałęzi i
    positional glob dla ograniczenia zakresu.

 slug.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)
---
diff --git a/slug.py b/slug.py
index 5ec173b..55f1896 100755
--- a/slug.py
+++ b/slug.py
@@ -705,7 +705,15 @@ def update_command(options, args):
     in every matching repo.
     """
     p = SlugArgumentParser(prog='git pld update',
-        description='Smart fetch using centralized Refs repo')
+        description=(
+            'Update local PLD package repositories from upstream.  '
+            'Queries a centralized PLD git Refs repository to learn which branches '
+            'changed upstream and fetches only those. '
+            'By default operates on every local repo and only the master '
+            'branch — use --branch to fetch other branches, --new to also '
+            'clone packages that exist upstream but not locally, --prune to '
+            'delete local repos that were removed upstream, and a positional '
+            'repo glob to limit the scope (e.g. "perl-*").'))
     p.add_argument('--new', action='store_true', default=False,
         help='init local repos for packages that exist upstream but not locally')
     p.add_argument('--no-new', dest='new', action='store_false')
================================================================

---- gitweb:

http://git.pld-linux.org/gitweb.cgi/projects/git-slug.git/commitdiff/4a7e426b8f1a3571094b5dc89412bc49b8f29666