Improve help

openssl-encrypt

@@ -2,26 +2,23 @@
 #
 # OpenSSL script to encrypt a file with our best settings.
 #
+# Syntax:
+#
+#     openssl-encrypt <file>
+#
 # Example:
 #
 #     $ openssl-encrypt foo.txt
-#     (prompt for password)
-#     #=> foo.txt.aes
+#
+# Output is a new encrypted file:
+#
+#     example.txt.aes
+#
+# To decrypt the file:
+#
+#     $ openssl-decrypt example.txt.aes
 #
 #
-## Related
-# 
-# These commands are related:
-# 
-#   * `gpg-encrypt`: use GPG to encrypt a file using our best settings.
-#   
-#   * `gpg-decrypt`: use GPG to decrypt a file using our best settings.
-# 
-#   * `openssl-encrypt`: use OpenSLL to encrypt a file using our best settings.
-#   
-#   * `openssl-decrypt`: use OpenSSL to decrypt a file using our best settings.
-# 
-# 
 # ## Settings
 # 
 #   * Symmetric encryption, i.e. we use the same password for encryption and decryption.
@@ -32,6 +29,23 @@
 # 
 #   * Salt
 # 
+#
+# ## See also
+# 
+# These commands are similar:
+# 
+#   * [`gpg-encrypt`](https://github.com/SixArm/gpg-encrypt): 
+#     use GPG to encrypt a file using our best settings.
+#   
+#   * [`gpg-decrypt`](https://github.com/SixArm/gpg-decrypt): 
+#     use GPG to decrypt a file using our best settings.
+#
+#   * [`openssl-encrypt`](https://github.com/SixArm/openssl-encrypt): 
+#     use OpenSLL to encrypt a file using our best settings.
+#   
+#   * [`openssl-decrypt`](https://github.com/SixArm/openssl-decrypt): 
+#     use OpenSSL to decrypt a file using our best settings.
+# 
 # 
 # ## Command
 #