Use proper HTML for variables in the basic setup (passphrase) tutorial
Marco Ricci

Marco Ricci commited on 2024-10-16 17:33:28
Zeige 1 geänderte Dateien mit 5 Einfügungen und 5 Löschungen.

... ...
@@ -77,20 +77,20 @@ For our email account, we choose the straightforward service name `email`.
77 77
 
78 78
 We need to translate the passphrase policy into options for `derivepassphrase`:
79 79
 
80
-- A policy "(at least) `n` lower case letters" translates to the option `--lower n`, for any `n` greater than 0.
80
+- A policy "(at least) <var>n</var> lower case letters" translates to the option <code>-<span/>-lower <var>n</var></code>, for any <var>n</var> > 0.
81 81
   Upper case letters (`--upper`), digits (`--number`), symbols (`--symbol`), spaces (`--space`) and dashes (`--dash`) work similarly.
82 82
 - A policy "spaces *forbidden*" translates to the option `--space 0`.
83 83
   Again, other character classes behave similarly.
84
-- A policy "no character may appear `n` times (or more) in a row" translates to the option `--repeat n-1`, for any `n` greater than 1.
84
+- A policy "no character may appear <var>n</var> times (or more) in a row" translates to the option <code>-<span/>-repeat (<var>n</var> − 1)</code>, for any <var>n</var> > 1.
85 85
   In particular, `--repeat 1` means no character may be immediately repeated.
86 86
   (See the mnemonic below.)
87
-* A policy "between `n` and `m` characters long" translates to `--length k`, for any `k` between `n` and `m` which you choose.
88
-  (`derivepassphrase` does not explicitly choose a passphrase length for you.)
87
+* A policy "between <var>n</var> and <var>m</var> characters long" translates to <code>-<span/>-length <var>k</var></code>, for any choice of <var>k</var> which satisfies <var>n</var> ≤ <var>k</var> ≤ <var>m</var>.
88
+  (`derivepassphrase` does not explicitly choose <var>k</var> for you.)
89 89
 
90 90
 ??? note "Mnemonic: the `--repeat` option"
91 91
 
92 92
     The `--repeat` option denotes the *total* number of consecutive occurrences of the same character.
93
-    Or alternatively: if you request `--repeat n`, then `derivepassphrase` will *avoid* deriving any passphrase that repeats a character *another `n` times*.
93
+    Or alternatively: if you request <code>-<span/>-repeat <var>n</var></code>, then `derivepassphrase` will *avoid* deriving any passphrase that repeats a character *another <var>n</var> times*.
94 94
 
95 95
     Examples:
96 96
 
97 97