diff --git a/pages/linux/mkswap.md b/pages/linux/mkswap.md
index 6dcabd927..02773cf53 100644
--- a/pages/linux/mkswap.md
+++ b/pages/linux/mkswap.md
@@ -1,20 +1,17 @@
 # mkswap
 
-> Sets up a Linux swap area on a device or in a file.
+> Set up a Linux swap area on a device or in a file.
+> Note: `path/to/file` can either point to a regular file or a swap partition.
 > More information: <https://manned.org/mkswap>.
 
-- Setup a given partition as swap area:
-
-`sudo mkswap {{/dev/sdb7}}`
-
-- Use a given file as swap area:
+- Set up a given swap area:
 
 `sudo mkswap {{path/to/file}}`
 
 - Check a partition for bad blocks before creating the swap area:
 
-`sudo mkswap -c {{/dev/sdb7}}`
+`sudo mkswap -c {{path/to/file}}`
 
-- Specify a label for the file (to allow `swapon` to use the label):
+- Specify a label for the partition (to allow `swapon` to use the label):
 
-`sudo mkswap -L {{swap1}} {{path/to/file}}`
+`sudo mkswap -L {{label}} {{/dev/sda1}}`
diff --git a/pages/linux/swapoff.md b/pages/linux/swapoff.md
index a1837c14f..266c772c0 100644
--- a/pages/linux/swapoff.md
+++ b/pages/linux/swapoff.md
@@ -1,20 +1,17 @@
 # swapoff
 
-> Disables device or file for swapping.
+> Disable devices and files for swapping.
+> Note: `path/to/file` can either point to a regular file or a swap partition.
 > More information: <https://manned.org/swapoff>.
 
-- Disable a given swap partition:
-
-`swapoff {{/dev/sdb7}}`
-
-- Disable a given swap file:
+- Disable a given swap area:
 
 `swapoff {{path/to/file}}`
 
-- Disable all swap areas:
+- Disable all swap areas in `/proc/swaps`:
 
-`swapoff -a`
+`swapoff --all`
 
-- Disable swap by label of a device or file:
+- Disable a swap partition by its label:
 
-`swapoff -L {{swap1}}`
+`swapoff -L {{label}}`
diff --git a/pages/linux/swapon.md b/pages/linux/swapon.md
index 9ea999c4f..59212e4ea 100644
--- a/pages/linux/swapon.md
+++ b/pages/linux/swapon.md
@@ -1,24 +1,21 @@
 # swapon
 
-> Enables device or file for swapping.
+> Enable devices and files for swapping.
+> Note: `path/to/file` can either point to a regular file or a swap partition.
 > More information: <https://manned.org/swapon>.
 
-- Get swap information:
+- Show swap information:
 
-`swapon -s`
+`swapon`
 
-- Enable a given swap partition:
-
-`swapon {{/dev/sdb7}}`
-
-- Enable a given swap file:
+- Enable a given swap area:
 
 `swapon {{path/to/file}}`
 
-- Enable all swap areas:
+- Enable all swap areas specified in `/etc/fstab` except those with the `noauto` option:
 
-`swapon -a`
+`swapon --all`
 
-- Enable swap by label of a device or file:
+- Enable a swap partition by its label:
 
-`swapon -L {{swap1}}`
+`swapon -L {{label}}`