*sum: update pages to make them consistent (#10136)

* *sum: update pages to make them consistent

* md5sum: fix typo, shasum: change 'the' to 'a' for consistency

pages/common/b2sum.md

@@ -3,15 +3,15 @@
 > Calculate BLAKE2 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/b2sum>.
 
-- Calculate the BLAKE2 checksum for a file:
+- Calculate the BLAKE2 checksum for one or more files:
 
-`b2sum {{path/to/file}}`
+`b2sum {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate BLAKE2 checksums for multiple files:
+- Calculate and save the list of BLAKE2 checksums to a file:
 
-`b2sum {{path/to/file1}} {{path/to/file2}}`
+`b2sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.b2}}`
 
-- Calculate the BLAKE2 checksum from `stdin`:
+- Calculate a BLAKE2 checksum from `stdin`:
 
 `{{some_command}} | b2sum`
 
@@ -23,6 +23,6 @@
 
 `b2sum --check --quiet {{path/to/file.b2}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `b2sum --ignore-missing --check --quiet {{path/to/file.b2}}`

pages/common/b3sum.md

@@ -1,25 +1,24 @@
 # b3sum
 
-> Command line utility for calculating BLAKE3 hashes.
-> It is similar to Coreutils tools like b2sum or md5sum.
+> Calculate BLAKE3 cryptographic checksums.
 > More information: <https://github.com/BLAKE3-team/BLAKE3/tree/master/b3sum>.
 
-- Calculate the BLAKE3 checksum for a file:
+- Calculate the BLAKE3 checksum for one or more files:
 
-`b3sum {{path/to/file}}`
+`b3sum {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate BLAKE3 checksums for multiple files:
+- Calculate and save the list of BLAKE3 checksums to a file:
 
-`b3sum {{path/to/file1}} {{path/to/file2}}`
+`b3sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.b3}}`
 
-- Calculate the BLAKE3 checksum from `stdin`:
+- Calculate a BLAKE3 checksum from `stdin`:
 
 `{{some_command}} | b3sum`
 
-- Create a file of BLAKE3 checksums:
-
-`b3sum {{path/to/file}} > {{path/to/file.b3}}`
-
-- Read and verify a file of BLAKE3 checksums:
+- Read a file of BLAKE3 sums and filenames and verify all files have matching checksums:
 
 `b3sum --check {{path/to/file.b3}}`
+
+- Only show a message for missing files or when verification fails:
+
+`b3sum --check --quiet {{path/to/file.b3}}`

pages/common/md5sum.md

@@ -3,19 +3,19 @@
 > Calculate MD5 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/md5sum>.
 
-- Calculate the MD5 checksum for a file:
+- Calculate the MD5 checksum for one or more files:
 
-`md5sum {{path/to/file}}`
+`md5sum {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate MD5 checksums for multiple files:
+- Calculate and save the list of MD5 checksums to a file:
 
-`md5sum {{path/to/file1}} {{path/to/file2}}`
+`md5sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.md5}}`
 
 - Calculate an MD5 checksum from `stdin`:
 
-`{{some_command}}" | md5sum`
+`{{some_command}} | md5sum`
 
-- Read a file of MD5SUMs and verify all files have matching checksums:
+- Read a file of MD5 sums and filenames and verify all files have matching checksums:
 
 `md5sum --check {{path/to/file.md5}}`
 
@@ -23,6 +23,6 @@
 
 `md5sum --check --quiet {{path/to/file.md5}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `md5sum --ignore-missing --check --quiet {{path/to/file.md5}}`

pages/common/sha1sum.md

@@ -3,19 +3,19 @@
 > Calculate SHA1 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/sha1sum>.
 
-- Calculate the SHA1 checksum for a file:
+- Calculate the SHA1 checksum for one or more files:
 
-`sha1sum {{path/to/file}}`
-
-- Calculate SHA1 checksums for multiple files:
-
-`sha1sum {{path/to/file1}} {{path/to/file2}}`
+`sha1sum {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate and save the list of SHA1 checksums to a file:
 
-`sha1sum {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha1}}`
+`sha1sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha1}}`
 
-- Read a file of SHA1 sums and verify all files have matching checksums:
+- Calculate a SHA1 checksum from `stdin`:
+
+`{{some_command}} | sha1sum`
+
+- Read a file of SHA1 sums and filenames and verify all files have matching checksums:
 
 `sha1sum --check {{path/to/file.sha1}}`
 
@@ -23,6 +23,6 @@
 
 `sha1sum --check --quiet {{path/to/file.sha1}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `sha1sum --ignore-missing --check --quiet {{path/to/file.sha1}}`

pages/common/sha224sum.md

@@ -3,19 +3,19 @@
 > Calculate SHA224 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html>.
 
-- Calculate the SHA224 checksum for a file:
+- Calculate the SHA224 checksum for one or more files:
 
-`sha224sum {{path/to/file}}`
-
-- Calculate SHA224 checksums for multiple files:
-
-`sha224sum {{path/to/file1}} {{path/to/file2}}`
+`sha224sum {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate and save the list of SHA224 checksums to a file:
 
-`sha224sum {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha224}}`
+`sha224sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha224}}`
 
-- Read a file of SHA224 sums and verify all files have matching checksums:
+- Calculate a SHA224 checksum from `stdin`:
+
+`{{some_command}} | sha224sum`
+
+- Read a file of SHA224 sums and filenames and verify all files have matching checksums:
 
 `sha224sum --check {{path/to/file.sha224}}`
 
@@ -23,6 +23,6 @@
 
 `sha224sum --check --quiet {{path/to/file.sha224}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `sha224sum --ignore-missing --check --quiet {{path/to/file.sha224}}`

pages/common/sha256sum.md

@@ -3,19 +3,19 @@
 > Calculate SHA256 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html>.
 
-- Calculate the SHA256 checksum for a file:
+- Calculate the SHA256 checksum for one or more files:
 
-`sha256sum {{path/to/file}}`
-
-- Calculate SHA256 checksums for multiple files:
-
-`sha256sum {{path/to/file1}} {{path/to/file2}}`
+`sha256sum {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate and save the list of SHA256 checksums to a file:
 
-`sha256sum {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha256}}`
+`sha256sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha256}}`
 
-- Read a file of SHA256 sums and verify all files have matching checksums:
+- Calculate a SHA256 checksum from `stdin`:
+
+`{{some_command}} | sha256sum`
+
+- Read a file of SHA256 sums and filenames and verify all files have matching checksums:
 
 `sha256sum --check {{path/to/file.sha256}}`
 
@@ -23,6 +23,6 @@
 
 `sha256sum --check --quiet {{path/to/file.sha256}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `sha256sum --ignore-missing --check --quiet {{path/to/file.sha256}}`

pages/common/sha384sum.md

@@ -3,19 +3,19 @@
 > Calculate SHA384 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html>.
 
-- Calculate the SHA384 checksum for a file:
+- Calculate the SHA384 checksum for one or more files:
 
-`sha384sum {{path/to/file}}`
-
-- Calculate SHA384 checksums for multiple files:
-
-`sha384sum {{path/to/file1}} {{path/to/file2}}`
+`sha384sum {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate and save the list of SHA384 checksums to a file:
 
-`sha384sum {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha384}}`
+`sha384sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha384}}`
 
-- Read a file of SHA384 sums and verify all files have matching checksums:
+- Calculate a SHA384 checksum from `stdin`:
+
+`{{some_command}} | sha384sum`
+
+- Read a file of SHA384 sums and filenames and verify all files have matching checksums:
 
 `sha384sum --check {{path/to/file.sha384}}`
 
@@ -23,6 +23,6 @@
 
 `sha384sum --check --quiet {{path/to/file.sha384}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `sha384sum --ignore-missing --check --quiet {{path/to/file.sha384}}`

pages/common/sha512sum.md

@@ -3,19 +3,19 @@
 > Calculate SHA512 cryptographic checksums.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html>.
 
-- Calculate the SHA512 checksum for a file:
+- Calculate the SHA512 checksum for one or more files:
 
-`sha512sum {{path/to/file}}`
-
-- Calculate SHA512 checksums for multiple files:
-
-`sha512sum {{path/to/file1}} {{path/to/file2}}`
+`sha512sum {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate and save the list of SHA512 checksums to a file:
 
-`sha512sum {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha512}}`
+`sha512sum {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha512}}`
 
-- Read a file of SHA512 sums and verify all files have matching checksums:
+- Calculate a SHA512 checksum from `stdin`:
+
+`{{some_command}} | sha512sum`
+
+- Read a file of SHA512 sums and filenames and verify all files have matching checksums:
 
 `sha512sum --check {{path/to/file.sha512}}`
 
@@ -23,6 +23,6 @@
 
 `sha512sum --check --quiet {{path/to/file.sha512}}`
 
-- Only show a message for files for which verification fails, ignoring missing files:
+- Only show a message when verification fails, ignoring missing files:
 
 `sha512sum --ignore-missing --check --quiet {{path/to/file.sha512}}`

pages/common/shasum.md

@@ -1,32 +1,36 @@
 # shasum
 
-> Calculate or check cryptographic SHA checksums.
+> Calculate SHA cryptographic checksums.
 > More information: <https://manned.org/shasum>.
 
-- Calculate the SHA1 checksum for a file:
+- Calculate the SHA1 checksum for one or more files:
 
-`shasum {{path/to/file}}`
+`shasum {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate the SHA256 checksum for a file:
+- Calculate the SHA256 checksum for one or more files:
 
-`shasum --algorithm 256 {{path/to/file}}`
+`shasum --algorithm 256 {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate the SHA512 checksum for multiple files:
+- Calculate the SHA512 checksum for one or more files:
 
-`shasum --algorithm 512 {{path/to/file1}} {{path/to/file2}}`
+`shasum --algorithm 512 {{path/to/file1 path/to/file2 ...}}`
+
+- Calculate a SHA1 checksum from `stdin`:
+
+`{{some_command}} | shasum`
 
 - Calculate and save the list of SHA256 checksums to a file:
 
-`shasum --algorithm 256 {{path/to/file1}} {{path/to/file2}} > {{path/to/file.sha256}}`
+`shasum --algorithm 256 {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha256}}`
 
-- Check a file with a list of sums against the directory's files:
+- Read a file of SHA1 sums and filenames and verify all files have matching checksums:
 
 `shasum --check {{path/to/file}}`
 
-- Check a list of sums and only show a message for files for which verification fails:
+- Only show a message for missing files or when verification fails:
 
 `shasum --check --quiet {{path/to/file}}`
 
-- Calculate the SHA1 checksum from `stdin`:
+- Only show a message when verification fails, ignoring missing files:
 
-`{{some_command}} | shasum`
+`shasum --ignore-missing --check --quiet {{path/to/file}}`