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

* *sum: update pages to make them consistent

* shasum: remove redundant option

* shasum: update page

pages/common/b2sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | b2sum`
 
-- Read a file of BLAKE2 sums and filenames and verify all files have matching checksums:
+- Read a file of BLAKE2 checksums and filenames and verify all files have matching checksums:
 
 `b2sum --check {{path/to/file.b2}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `b2sum --ignore-missing --check --quiet {{path/to/file.b2}}`
+
+- Check a known BLAKE2 checksum of a file:
+
+`echo {{known_blake2_checksum_of_the_file}} {{path/to/file}} | b2sum --check`

pages/common/b3sum.md

@@ -15,10 +15,14 @@
 
 `{{command}} | b3sum`
 
-- Read a file of BLAKE3 sums and filenames and verify all files have matching checksums:
+- Read a file of BLAKE3 checksums 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}}`
+
+- Check a known BLAKE3 checksum of a file:
+
+`echo {{known_blake3_checksum_of_the_file}} {{path/to/file}} | b3sum --check`

pages/common/md5sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | md5sum`
 
-- Read a file of MD5 sums and filenames and verify all files have matching checksums:
+- Read a file of MD5 checksums and filenames and verify all files have matching checksums:
 
 `md5sum --check {{path/to/file.md5}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `md5sum --ignore-missing --check --quiet {{path/to/file.md5}}`
+
+- Check a known MD5 checksum of a file:
+
+`echo {{known_md5_checksum_of_the_file}} {{path/to/file}} | md5sum --check`

pages/common/sha1sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | sha1sum`
 
-- Read a file of SHA1 sums and filenames and verify all files have matching checksums:
+- Read a file of SHA1 checksums and filenames and verify all files have matching checksums:
 
 `sha1sum --check {{path/to/file.sha1}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `sha1sum --ignore-missing --check --quiet {{path/to/file.sha1}}`
+
+- Check a known SHA1 checksum of a file:
+
+`echo {{known_sha1_checksum_of_the_file}} {{path/to/file}} | sha1sum --check`

pages/common/sha224sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | sha224sum`
 
-- Read a file of SHA224 sums and filenames and verify all files have matching checksums:
+- Read a file of SHA224 checksums and filenames and verify all files have matching checksums:
 
 `sha224sum --check {{path/to/file.sha224}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `sha224sum --ignore-missing --check --quiet {{path/to/file.sha224}}`
+
+- Check a known SHA224 checksum of a file:
+
+`echo {{known_sha224_checksum_of_the_file}} {{path/to/file}} | sha224sum --check`

pages/common/sha256sum.md

@@ -27,6 +27,6 @@
 
 `sha256sum --ignore-missing --check --quiet {{path/to/file.sha256}}`
 
-- Check known SHA256 checksum of a file:
+- Check a known SHA256 checksum of a file:
 
 `echo {{known_sha256_checksum_of_the_file}} {{path/to/file}} | sha256sum --check`

pages/common/sha384sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | sha384sum`
 
-- Read a file of SHA384 sums and filenames and verify all files have matching checksums:
+- Read a file of SHA384 checksums and filenames and verify all files have matching checksums:
 
 `sha384sum --check {{path/to/file.sha384}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `sha384sum --ignore-missing --check --quiet {{path/to/file.sha384}}`
+
+- Check a known SHA384 checksum of a file:
+
+`echo {{known_sha384_checksum_of_the_file}} {{path/to/file}} | sha384sum --check`

pages/common/sha512sum.md

@@ -15,7 +15,7 @@
 
 `{{command}} | sha512sum`
 
-- Read a file of SHA512 sums and filenames and verify all files have matching checksums:
+- Read a file of SHA512 checksums and filenames and verify all files have matching checksums:
 
 `sha512sum --check {{path/to/file.sha512}}`
 
@@ -26,3 +26,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `sha512sum --ignore-missing --check --quiet {{path/to/file.sha512}}`
+
+- Check a known SHA512 checksum of a file:
+
+`echo {{known_sha512_checksum_of_the_file}} {{path/to/file}} | sha512sum --check`

pages/common/shasum.md

@@ -7,13 +7,9 @@
 
 `shasum {{path/to/file1 path/to/file2 ...}}`
 
-- Calculate the SHA256 checksum for one or more files:
+- Calculate the SHA checksum for one or more files with the specified algorithm:
 
-`shasum --algorithm 256 {{path/to/file1 path/to/file2 ...}}`
-
-- Calculate the SHA512 checksum for one or more files:
-
-`shasum --algorithm 512 {{path/to/file1 path/to/file2 ...}}`
+`shasum --algorithm {{1|224|256|384|512|512224|512256}} {{path/to/file1 path/to/file2 ...}}`
 
 - Calculate a SHA1 checksum from `stdin`:
 
@@ -23,7 +19,7 @@
 
 `shasum --algorithm 256 {{path/to/file1 path/to/file2 ...}} > {{path/to/file.sha256}}`
 
-- Read a file of SHA1 sums and filenames and verify all files have matching checksums:
+- Read a file of SHA checksums and filenames and verify all files have matching checksums (the algorithm will be automatically detected):
 
 `shasum --check {{path/to/file}}`
 
@@ -34,3 +30,7 @@
 - Only show a message when verification fails, ignoring missing files:
 
 `shasum --ignore-missing --check --quiet {{path/to/file}}`
+
+- Check a known SHA checksum of a file:
+
+`echo {{known_sha_checksum_of_the_file}} {{path/to/file}} | shasum --check`