From: Ben Pfaff <blp@cs.stanford.edu>
Date: Mon, 25 Aug 2025 19:01:36 +0000 (-0700)
Subject: rust: Document `pspp decrypt`.
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=be1811adc12d3042b23d42d19674fb19f53f7fa1;p=pspp

rust: Document `pspp decrypt`.
---

diff --git a/rust/doc/src/invoking/pspp-decrypt.md b/rust/doc/src/invoking/pspp-decrypt.md
index 1f8b5447df..8d17c020e6 100644
--- a/rust/doc/src/invoking/pspp-decrypt.md
+++ b/rust/doc/src/invoking/pspp-decrypt.md
@@ -1 +1,27 @@
 # Decrypting SPSS files with `pspp decrypt`
+
+SPSS supports encryption using a password for data, viewer, and syntax
+files.  `pspp decrypt <INPUT> <OUTPUT>` reads an encrypted file
+`<INPUT>` and writes an equivalent plaintext file `<OUTPUT>`.
+
+Other commands, such as [`pspp convert`](pspp-convert.md), can also
+read encrypted files directly.
+
+PSPP does not support writing encrypted files, only reading them.
+
+> ⚠️ Warning: The SPSS encryption format is insecure: when the password
+> is unknown, it is much cheaper and faster to decrypt a file
+> encrypted this way than if a well designed alternative were used.
+
+## Options
+
+`pspp decrypt` accepts the following options:
+
+* `-p <PASSWORD>`  
+  `--password <PASSWORD>`  
+  Specifies the password for reading the encrypted input file.
+  Without this option, PSPP will interactively prompt for the
+  password.
+
+  > ⚠️ The password (and other command-line options) may be visible to
+  other users on multiuser systems.