From f01b2ffc74a7d919332ec886cfabdf1fe5b1b96d Mon Sep 17 00:00:00 2001
From: Thomas Schoebel-Theuer <mars@box>
Date: Sat, 9 May 2020 15:33:29 +0200
Subject: [PATCH] doc: describe new marsadm macros

---
 docu/mars-user-manual.lyx | 48 +++++++++++++++++++++++++++++++++++++--
 docu/marsadm.help         |  2 +-
 2 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/docu/mars-user-manual.lyx b/docu/mars-user-manual.lyx
index 4c99e198..2e8483dd 100644
--- a/docu/mars-user-manual.lyx
+++ b/docu/mars-user-manual.lyx
@@ -5395,7 +5395,11 @@ Primary
 \family typewriter
 RemainsPrimary
 \family default
-, or 
+, 
+\family typewriter
+ForcedPrimary
+\family default
+ or 
 \family typewriter
 Secondary
 \family default
@@ -5428,6 +5432,25 @@ should
 /dev/mars/mydata
 \family default
  device is currently in use .
+ 
+\family typewriter
+ForcedPrimary
+\family default
+ indicates that 
+\emph on
+multiple
+\emph default
+ cluster hosts (see 
+\family typewriter
+%nr-primary{}
+\family default
+) are claiming to be in actual primary role, e.g.
+ when another one is in role 
+\family typewriter
+RemainsPrimary
+\family default
+, or when network interruption is preventing role change information from
+ propagating.
 \begin_inset Newline newline
 \end_inset
 
@@ -5539,7 +5562,7 @@ RemainsPrimary
 \begin_layout Plain Layout
 
 \family typewriter
-Primary
+Primary / ForcedPrimary
 \end_layout
 
 \end_inset
@@ -31389,6 +31412,27 @@ reference "subsec:Emergency-Mode"
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
+\family typewriter
+nr-{attach,sync,fetch,replay,primary}
+\family default
+ Show the 
+\emph on
+total number
+\emph default
+ of cluster hosts which are in corresponding state 
+\family typewriter
+%is-
+\emph on
+$something
+\emph default
+{}
+\family default
+.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
 \family typewriter
 rest-space
 \family default
diff --git a/docu/marsadm.help b/docu/marsadm.help
index 6d045cdf..429e182e 100644
--- a/docu/marsadm.help
+++ b/docu/marsadm.help
@@ -664,7 +664,7 @@ marsadm [<global_options>] view[-<macroname>] [<resource_names> | all ]
   {fetch,replay,work}-{lognr,logcount}
   {get,actual}-primary
   {implemented,usable}-{digests,compressions}
-  {is,todo}-{attach,sync,fetch,replay,primary}
+  {is,todo,nr}-{attach,sync,fetch,replay,primary}
   {my,all}-resources
   {potential,implemented,usable}-features
   {sync,fetch,replay,work,syncpos}-{size,pos}