/mandos/release

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/release

« back to all changes in this revision

Viewing changes to mandos-keygen.xml

  • Committer: Teddy Hogeborn
  • Date: 2008-08-30 19:49:24 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080830194924-f4liqq8wxajlbshn
* plugin-runner.xml (NAME): Improved wording.
  (SYNOPSIS): Use <option> and <replaceable> tags.  Unify short and
              long options.  Add "--global-envs" and "--envs-for"
              options.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-keygen.xml
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY VERSION "1.0">
5
5
<!ENTITY COMMANDNAME "mandos-keygen">
6
 
<!ENTITY TIMESTAMP "2008-08-29">
 
6
<!ENTITY TIMESTAMP "2008-08-30">
7
7
]>
8
8
 
9
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
75
75
  <refsynopsisdiv>
76
76
    <cmdsynopsis>
77
77
      <command>&COMMANDNAME;</command>
78
 
      <group choice="opt">
79
 
        <arg choice="plain"><option>--dir</option>
80
 
        <replaceable>directory</replaceable></arg>
81
 
      </group>
82
 
      <group choice="opt">
83
 
        <arg choice="plain"><option>--type</option>
84
 
        <replaceable>type</replaceable></arg>
85
 
      </group>
86
 
      <group choice="opt">
87
 
        <arg choice="plain"><option>--length</option>
88
 
        <replaceable>bits</replaceable></arg>
89
 
      </group>
90
 
      <group choice="opt">
91
 
        <arg choice="plain"><option>--subtype</option>
92
 
        <replaceable>type</replaceable></arg>
93
 
      </group>
94
 
      <group choice="opt">
95
 
        <arg choice="plain"><option>--sublength</option>
96
 
        <replaceable>bits</replaceable></arg>
97
 
      </group>
98
 
      <group choice="opt">
99
 
        <arg choice="plain"><option>--name</option>
100
 
        <replaceable>NAME</replaceable></arg>
101
 
      </group>
102
 
      <group choice="opt">
103
 
        <arg choice="plain"><option>--email</option>
104
 
        <replaceable>EMAIL</replaceable></arg>
105
 
      </group>
106
 
      <group choice="opt">
107
 
        <arg choice="plain"><option>--comment</option>
108
 
        <replaceable>COMMENT</replaceable></arg>
109
 
      </group>
110
 
      <group choice="opt">
111
 
        <arg choice="plain"><option>--expire</option>
112
 
        <replaceable>TIME</replaceable></arg>
113
 
      </group>
114
 
      <group choice="opt">
115
 
        <arg choice="plain"><option>--force</option></arg>
116
 
      </group>
117
 
    </cmdsynopsis>
118
 
    <cmdsynopsis>
119
 
      <command>&COMMANDNAME;</command>
120
 
      <group choice="opt">
121
 
        <arg choice="plain"><option>-d</option>
122
 
        <replaceable>directory</replaceable></arg>
123
 
      </group>
124
 
      <group choice="opt">
125
 
        <arg choice="plain"><option>-t</option>
126
 
        <replaceable>type</replaceable></arg>
127
 
      </group>
128
 
      <group choice="opt">
129
 
        <arg choice="plain"><option>-l</option>
130
 
        <replaceable>bits</replaceable></arg>
131
 
      </group>
132
 
      <group choice="opt">
133
 
        <arg choice="plain"><option>-s</option>
134
 
        <replaceable>type</replaceable></arg>
135
 
      </group>
136
 
      <group choice="opt">
137
 
        <arg choice="plain"><option>-L</option>
138
 
        <replaceable>bits</replaceable></arg>
139
 
      </group>
140
 
      <group choice="opt">
141
 
        <arg choice="plain"><option>-n</option>
142
 
        <replaceable>NAME</replaceable></arg>
143
 
      </group>
144
 
      <group choice="opt">
145
 
        <arg choice="plain"><option>-e</option>
146
 
        <replaceable>EMAIL</replaceable></arg>
147
 
      </group>
148
 
      <group choice="opt">
149
 
        <arg choice="plain"><option>-c</option>
150
 
        <replaceable>COMMENT</replaceable></arg>
151
 
      </group>
152
 
      <group choice="opt">
153
 
        <arg choice="plain"><option>-x</option>
154
 
        <replaceable>TIME</replaceable></arg>
155
 
      </group>
156
 
      <group choice="opt">
157
 
        <arg choice="plain"><option>-f</option></arg>
158
 
      </group>
 
78
      <group>
 
79
        <arg choice="plain"><option>--dir
 
80
        <replaceable>DIRECTORY</replaceable></option></arg>
 
81
        <arg choice="plain"><option>-d
 
82
        <replaceable>DIRECTORY</replaceable></option></arg>
 
83
      </group>
 
84
      <sbr/>
 
85
      <group>
 
86
        <arg choice="plain"><option>--type
 
87
        <replaceable>KEYTYPE</replaceable></option></arg>
 
88
        <arg choice="plain"><option>-t
 
89
        <replaceable>KEYTYPE</replaceable></option></arg>
 
90
      </group>
 
91
      <sbr/>
 
92
      <group>
 
93
        <arg choice="plain"><option>--length
 
94
        <replaceable>BITS</replaceable></option></arg>
 
95
        <arg choice="plain"><option>-l
 
96
        <replaceable>BITS</replaceable></option></arg>
 
97
      </group>
 
98
      <sbr/>
 
99
      <group>
 
100
        <arg choice="plain"><option>--subtype
 
101
        <replaceable>KEYTYPE</replaceable></option></arg>
 
102
        <arg choice="plain"><option>-s
 
103
        <replaceable>KEYTYPE</replaceable></option></arg>
 
104
      </group>
 
105
      <sbr/>
 
106
      <group>
 
107
        <arg choice="plain"><option>--sublength
 
108
        <replaceable>BITS</replaceable></option></arg>
 
109
        <arg choice="plain"><option>-L
 
110
        <replaceable>BITS</replaceable></option></arg>
 
111
      </group>
 
112
      <sbr/>
 
113
      <group>
 
114
        <arg choice="plain"><option>--name
 
115
        <replaceable>NAME</replaceable></option></arg>
 
116
        <arg choice="plain"><option>-n
 
117
        <replaceable>NAME</replaceable></option></arg>
 
118
      </group>
 
119
      <sbr/>
 
120
      <group>
 
121
        <arg choice="plain"><option>--email
 
122
        <replaceable>ADDRESS</replaceable></option></arg>
 
123
        <arg choice="plain"><option>-e
 
124
        <replaceable>ADDRESS</replaceable></option></arg>
 
125
      </group>
 
126
      <sbr/>
 
127
      <group>
 
128
        <arg choice="plain"><option>--comment
 
129
        <replaceable>TEXT</replaceable></option></arg>
 
130
        <arg choice="plain"><option>-c
 
131
        <replaceable>TEXT</replaceable></option></arg>
 
132
      </group>
 
133
      <sbr/>
 
134
      <group>
 
135
        <arg choice="plain"><option>--expire
 
136
        <replaceable>TIME</replaceable></option></arg>
 
137
        <arg choice="plain"><option>-x
 
138
        <replaceable>TIME</replaceable></option></arg>
 
139
      </group>
 
140
      <sbr/>
 
141
      <arg><option>--force</option></arg>
159
142
    </cmdsynopsis>
160
143
    <cmdsynopsis>
161
144
      <command>&COMMANDNAME;</command>
163
146
        <arg choice="plain"><option>-p</option></arg>
164
147
        <arg choice="plain"><option>--password</option></arg>
165
148
      </group>
166
 
      <group choice="opt">
167
 
        <arg choice="plain"><option>--dir</option>
168
 
        <replaceable>directory</replaceable></arg>
 
149
      <sbr/>
 
150
      <group>
 
151
        <arg choice="plain"><option>--dir
 
152
        <replaceable>DIRECTORY</replaceable></option></arg>
 
153
        <arg choice="plain"><option>-d
 
154
        <replaceable>DIRECTORY</replaceable></option></arg>
169
155
      </group>
170
 
      <group choice="opt">
171
 
        <arg choice="plain"><option>--name</option>
172
 
        <replaceable>NAME</replaceable></arg>
 
156
      <sbr/>
 
157
      <group>
 
158
        <arg choice="plain"><option>--name
 
159
        <replaceable>NAME</replaceable></option></arg>
 
160
        <arg choice="plain"><option>-n
 
161
        <replaceable>NAME</replaceable></option></arg>
173
162
      </group>
174
163
    </cmdsynopsis>
175
164
    <cmdsynopsis>
367
356
    <title>ENVIRONMENT</title>
368
357
    <variablelist>
369
358
      <varlistentry>
370
 
        <term><varname>TMPDIR</varname></term>
 
359
        <term><envar>TMPDIR</envar></term>
371
360
        <listitem>
372
361
          <para>
373
362
            If set, temporary files will be created here. See
431
420
        Normal invocation needs no options:
432
421
      </para>
433
422
      <para>
434
 
        <userinput>mandos-keygen</userinput>
 
423
        <userinput>&COMMANDNAME;</userinput>
435
424
      </para>
436
425
    </informalexample>
437
426
    <informalexample>
442
431
      <para>
443
432
 
444
433
<!-- do not wrap this line -->
445
 
<userinput>mandos-keygen --dir ~/keydir --type RSA --force</userinput>
 
434
<userinput>&COMMANDNAME; --dir ~/keydir --type RSA --force</userinput>
446
435
 
447
436
      </para>
448
437
    </informalexample>
466
455
  <refsect1 id="see_also">
467
456
    <title>SEE ALSO</title>
468
457
    <para>
469
 
      <citerefentry><refentrytitle>password-request</refentrytitle>
470
 
      <manvolnum>8mandos</manvolnum></citerefentry>,
 
458
      <citerefentry><refentrytitle>gpg</refentrytitle>
 
459
      <manvolnum>1</manvolnum></citerefentry>,
471
460
      <citerefentry><refentrytitle>mandos</refentrytitle>
472
461
      <manvolnum>8</manvolnum></citerefentry>,
473
 
      <citerefentry><refentrytitle>gpg</refentrytitle>
474
 
      <manvolnum>1</manvolnum></citerefentry>
 
462
      <citerefentry><refentrytitle>password-request</refentrytitle>
 
463
      <manvolnum>8mandos</manvolnum></citerefentry>
475
464
    </para>
476
465
  </refsect1>
477
466