age-keygen: add page; age: update page (#10424)

* age-keygen: add page; age: update page

* age: remove `_` before numbers in placeholders

* age: update `--recipient` example

pages/common/age-keygen.md

@@ -0,0 +1,13 @@
+# age-keygen
+
+> Generate `age` key pairs.
+> See `age` for how to encrypt/decrypt files.
+> More information: <https://manned.org/age-keygen>.
+
+- Generate a key pair, save it to an unencrypted file and print the public key to `stdout`:
+
+`age-keygen --output {{path/to/file}}`
+
+- Convert an identity to a recipient and print the public key to `stdout`:
+
+`age-keygen -y {{path/to/file}}`

pages/common/age.md

@@ -1,19 +1,16 @@
 # age
 
 > A simple, modern and secure file encryption tool.
+> See `age-keygen` for how to generate key pairs.
 > More information: <https://github.com/FiloSottile/age>.
 
 - Generate an encrypted file that can be decrypted with a passphrase:
 
 `age --passphrase --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}`
 
-- Generate a key pair, saving the private key to an unencrypted file and printing the public key to `stdout`:
+- Encrypt a file with one or more public keys entered as literals (repeat the `--recipient` flag to specify multiple public keys):
 
-`age-keygen --output {{path/to/file}}`
+`age --recipient {{public_key}} --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}`
-
-- Encrypt a file with one or more public keys that are entered as literals:
-
-`age --recipient {{public_key_1}} --recipient {{public_key_2}} --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}`
 
 - Encrypt a file to one or more recipients with their public keys specified in a file (one per line):