From 5edc00087343c9f1af7f345b86914c1f0fa94bfd Mon Sep 17 00:00:00 2001
From: merakor <cem@ckyln.com>
Date: Sat, 7 Aug 2021 21:00:10 +0000
Subject: global_options: add argument to call silent

FossilOrigin-Name: cab50844d5456d5bb7c10625e3f34038146b84780b93f3abed107c74378cc41f
---
 docs/cpt.org  | 18 +++++++++++-------
 docs/cpt.texi |  8 +++++++-
 docs/cpt.txt  | 18 +++++++++++-------
 3 files changed, 29 insertions(+), 15 deletions(-)

(limited to 'docs')

diff --git a/docs/cpt.org b/docs/cpt.org
index 263c547..abdcd62 100644
--- a/docs/cpt.org
+++ b/docs/cpt.org
@@ -871,13 +871,17 @@ inside. Here is the proper way of doing it.
 The =global_options()= function is a simple convenience call to include flags
 that can be used inside most =cpt= tools. It defines the following flags:
 
-| Flag | Long Option   | Calls        |
-|------+---------------+--------------|
-| ~-f~ | ~--force~     | =CPT_FORCE=  |
-| ~-y~ | ~--no-prompt~ | =CPT_PROMPT= |
-|      | ~--root~      | =CPT_ROOT=   |
-| ~-h~ | ~--help~      | =usage()=    |
-| ~-v~ | ~--version~   | =version()=  |
+| Flag | Long Option   | Calls         |
+|------+---------------+---------------|
+| ~-f~ | ~--force~     | =CPT_FORCE=   |
+| ~-y~ | ~--no-prompt~ | =CPT_PROMPT=  |
+|      | ~--root~      | =CPT_ROOT=    |
+| ~-h~ | ~--help~      | =usage()=     |
+| ~-v~ | ~--version~   | =version()=   |
+|      | ~--verbose~   | =CPT_VERBOSE= |
+
+If you don't want these options to be printed on the usage, you can disable it
+by calling ~global_options silent~ instead.
 
 ** Message functions
 :PROPERTIES:
diff --git a/docs/cpt.texi b/docs/cpt.texi
index 7487209..ab1df89 100644
--- a/docs/cpt.texi
+++ b/docs/cpt.texi
@@ -1034,7 +1034,7 @@ parser_definition() @{
 The @samp{global_options()} function is a simple convenience call to include flags
 that can be used inside most @samp{cpt} tools. It defines the following flags:
 
-@multitable {aaaa} {aaaaaaaaaaaaa} {aaaaaaaaaaaa}
+@multitable {aaaa} {aaaaaaaaaaaaa} {aaaaaaaaaaaaa}
 @headitem Flag
 @tab Long Option
 @tab Calls
@@ -1053,8 +1053,14 @@ that can be used inside most @samp{cpt} tools. It defines the following flags:
 @item @code{-v}
 @tab @code{--version}
 @tab @samp{version()}
+@item 
+@tab @code{--verbose}
+@tab @samp{CPT_VERBOSE}
 @end multitable
 
+If you don't want these options to be printed on the usage, you can disable it
+by calling @code{global_options silent} instead.
+
 @node Message functions
 @section Message functions
 
diff --git a/docs/cpt.txt b/docs/cpt.txt
index 8934c15..ab99f4d 100644
--- a/docs/cpt.txt
+++ b/docs/cpt.txt
@@ -924,13 +924,17 @@ development manual for *Carbs Packaging Tools*. For development logs see
   include flags that can be used inside most `cpt' tools. It defines the
   following flags:
 
-   Flag  Long Option    Calls        
-  -----------------------------------
-   `-f'  `--force'      `CPT_FORCE'  
-   `-y'  `--no-prompt'  `CPT_PROMPT' 
-         `--root'       `CPT_ROOT'   
-   `-h'  `--help'       `usage()'    
-   `-v'  `--version'    `version()'  
+   Flag  Long Option    Calls         
+  ------------------------------------
+   `-f'  `--force'      `CPT_FORCE'   
+   `-y'  `--no-prompt'  `CPT_PROMPT'  
+         `--root'       `CPT_ROOT'    
+   `-h'  `--help'       `usage()'     
+   `-v'  `--version'    `version()'   
+         `--verbose'    `CPT_VERBOSE' 
+
+  If you don't want these options to be printed on the usage, you can
+  disable it by calling `global_options silent' instead.
 
 
 8.3 Message functions
-- 
cgit v1.2.3