Mercurial > projects > pwm

diff pwm.1.xml @ 12:8768fbd09bc5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add generatepassword command to generate random passwords Refactor and generalize handling of named arguments.
author Guido Berhoerster <guido+pwm@berhoerster.name>
date Thu, 03 Aug 2017 10:22:07 +0200
parents 85bce13237cf
children cf81eb0c2d5a
line wrap: on
line diff
--- a/pwm.1.xml	Mon Jul 31 09:20:21 2017 +0200
+++ b/pwm.1.xml	Thu Aug 03 10:22:07 2017 +0200
@@ -34,7 +34,7 @@
       <email>guido+pwm@berhoerster.name</email>
       <personblurb/>
     </author>
-    <date>31 July, 2017</date>
+    <date>3 August, 2017</date>
   </info>
   <refmeta>
     <refentrytitle>pwm</refentrytitle>
@@ -393,6 +393,54 @@
           </listitem>
         </varlistentry>
         <varlistentry>
+          <term>Generate a random password</term>
+          <listitem>
+            <cmdsynopsis>
+              <command>generatepassword</command>
+              <arg choice="opt">
+                <replaceable>id</replaceable>
+              </arg>
+              <arg choice="opt">
+                len=<replaceable>n</replaceable>
+              </arg>
+              <arg choice="opt" rep="repeat">
+                chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable>
+              </arg>
+              <arg choice="opt" rep="repeat">
+                charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable>
+              </arg>
+            </cmdsynopsis>
+            <cmdsynopsis>
+              <command>gp</command>
+              <arg choice="opt">
+                <replaceable>id</replaceable>
+              </arg>
+              <arg choice="opt">
+                len=<replaceable>n</replaceable>
+              </arg>
+              <arg choice="opt" rep="repeat">
+                chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable>
+              </arg>
+              <arg choice="opt" rep="repeat">
+                charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable>
+              </arg>
+              <sbr/>
+            </cmdsynopsis>
+            <para>Randomly generate a new password according to the specified
+            constraints. The <literal>len</literal> argument sets the length of
+            the generated password to <replaceable>n</replaceable> characters.
+            The <literal>chars</literal> argument constrains the password to
+            <replaceable>n</replaceable> from the set of characters
+            <replaceable>chars</replaceable>. Similarly, the
+            <literal>charclass</literal> argument to
+            <replaceable>n</replaceable> characters from the extended regular
+            expression character class <replaceable>class</replaceable>.
+            Multiple <literal>char</literal> and <literal>charclass</literal>
+            arguments may be specified, in which case the generated passwords
+            match all of them.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
           <term>Change the master password</term>
           <listitem>
             <cmdsynopsis>