diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index 30db49e2ee..6f1ccd22b2 100644
--- a/completions/fish/brew.fish
+++ b/completions/fish/brew.fish
@@ -870,9 +870,9 @@ __fish_brew_complete_arg 'list' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'list' -l verbose -d 'Make some output more verbose'
 __fish_brew_complete_arg 'list' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided'
 __fish_brew_complete_arg 'list' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal'
-__fish_brew_complete_arg 'list' -l l -d 'List formulae in long format'
-__fish_brew_complete_arg 'list' -l r -d 'Reverse the order of the formulae sort to list the oldest entries first'
-__fish_brew_complete_arg 'list' -l t -d 'Sort formulae by time modified, listing most recently modified first'
+__fish_brew_complete_arg 'list' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument'
+__fish_brew_complete_arg 'list' -l r -d 'Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument'
+__fish_brew_complete_arg 'list' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument'
 __fish_brew_complete_arg 'list' -a '(__fish_brew_suggest_formulae_installed)'
 __fish_brew_complete_arg 'list' -a '(__fish_brew_suggest_casks_installed)'
 
@@ -930,9 +930,9 @@ __fish_brew_complete_arg 'ls' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'ls' -l verbose -d 'Make some output more verbose'
 __fish_brew_complete_arg 'ls' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided'
 __fish_brew_complete_arg 'ls' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal'
-__fish_brew_complete_arg 'ls' -l l -d 'List formulae in long format'
-__fish_brew_complete_arg 'ls' -l r -d 'Reverse the order of the formulae sort to list the oldest entries first'
-__fish_brew_complete_arg 'ls' -l t -d 'Sort formulae by time modified, listing most recently modified first'
+__fish_brew_complete_arg 'ls' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument'
+__fish_brew_complete_arg 'ls' -l r -d 'Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument'
+__fish_brew_complete_arg 'ls' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument'
 __fish_brew_complete_arg 'ls' -a '(__fish_brew_suggest_formulae_installed)'
 __fish_brew_complete_arg 'ls' -a '(__fish_brew_suggest_casks_installed)'
 
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index 50563ed95a..7b27227af0 100644
--- a/completions/zsh/_brew
+++ b/completions/zsh/_brew
@@ -1060,19 +1060,19 @@ _brew_list() {
     '(--versions --unbrewed --pinned --l --r --t)--full-name[Print formulae with fully-qualified names. Unless `--full-name`, `--versions` or `--pinned` are passed, other options (i.e. `-1`, `-l`, `-r` and `-t`) are passed to `ls`(1) which produces the actual output]' \
     '--help[Show this message]' \
     '(--pinned --cask)--multiple[Only show formulae with multiple versions installed]' \
-    '(--multiple --unbrewed --1 --l --r --t --full-name --cask)--pinned[List only pinned formulae, or only the specified (pinned) formulae if formula are provided. See also `pin`, `unpin`]' \
+    '(--multiple --cask --unbrewed --1 --l --r --t --full-name)--pinned[List only pinned formulae, or only the specified (pinned) formulae if formula are provided. See also `pin`, `unpin`]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]' \
     '(--full-name --unbrewed --1 --l --r --t)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \
     '-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \
-    '-l[List formulae in long format]' \
-    '-r[Reverse the order of the formulae sort to list the oldest entries first]' \
-    '-t[Sort formulae by time modified, listing most recently modified first]' \
+    '-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \
+    '-r[Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \
+    '-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \
     - installed_formula \
     '(--cask --unbrewed)--formula[List only formulae, or treat all named arguments as formulae]' \
     '*::installed_formula:__brew_installed_formulae' \
     - installed_cask \
-    '(--formula --multiple --unbrewed --pinned --l --r --t)--cask[List only casks, or treat all named arguments as casks]' \
+    '(--formula --pinned --multiple --unbrewed)--cask[List only casks, or treat all named arguments as casks]' \
     '*::installed_cask:__brew_installed_casks'
 }
 
@@ -1134,19 +1134,19 @@ _brew_ls() {
     '(--versions --unbrewed --pinned --l --r --t)--full-name[Print formulae with fully-qualified names. Unless `--full-name`, `--versions` or `--pinned` are passed, other options (i.e. `-1`, `-l`, `-r` and `-t`) are passed to `ls`(1) which produces the actual output]' \
     '--help[Show this message]' \
     '(--pinned --cask)--multiple[Only show formulae with multiple versions installed]' \
-    '(--multiple --unbrewed --1 --l --r --t --full-name --cask)--pinned[List only pinned formulae, or only the specified (pinned) formulae if formula are provided. See also `pin`, `unpin`]' \
+    '(--multiple --cask --unbrewed --1 --l --r --t --full-name)--pinned[List only pinned formulae, or only the specified (pinned) formulae if formula are provided. See also `pin`, `unpin`]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]' \
     '(--full-name --unbrewed --1 --l --r --t)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \
     '-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \
-    '-l[List formulae in long format]' \
-    '-r[Reverse the order of the formulae sort to list the oldest entries first]' \
-    '-t[Sort formulae by time modified, listing most recently modified first]' \
+    '-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \
+    '-r[Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \
+    '-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \
     - installed_formula \
     '(--cask --unbrewed)--formula[List only formulae, or treat all named arguments as formulae]' \
     '*::installed_formula:__brew_installed_formulae' \
     - installed_cask \
-    '(--formula --multiple --unbrewed --pinned --l --r --t)--cask[List only casks, or treat all named arguments as casks]' \
+    '(--formula --pinned --multiple --unbrewed)--cask[List only casks, or treat all named arguments as casks]' \
     '*::installed_cask:__brew_installed_casks'
 }
 
diff --git a/docs/Manpage.md b/docs/Manpage.md
index b834e4e2dd..10a8fdaf66 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -352,11 +352,11 @@ If *`cask`* is provided, list its artifacts.
 * `-1`:
   Force output to be one entry per line. This is the default when output is not to a terminal.
 * `-l`:
-  List formulae in long format.
+  List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument.
 * `-r`:
-  Reverse the order of the formulae sort to list the oldest entries first.
+  Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument.
 * `-t`:
-  Sort formulae by time modified, listing most recently modified first.
+  Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument.
 
 ### `log` [*`options`*] [*`formula`*]
 
diff --git a/manpages/brew.1 b/manpages/brew.1
index 711dd67a85..1f8c4c0c50 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -478,15 +478,15 @@ Force output to be one entry per line\. This is the default when output is not t
 .
 .TP
 \fB\-l\fR
-List formulae in long format\.
+List formulae and/or casks in long format\. Has no effect when a formula or cask name is passed as an argument\.
 .
 .TP
 \fB\-r\fR
-Reverse the order of the formulae sort to list the oldest entries first\.
+Reverse the order of the formulae and/or casks sort to list the oldest entries first\. Has no effect when a formula or cask name is passed as an argument\.
 .
 .TP
 \fB\-t\fR
-Sort formulae by time modified, listing most recently modified first\.
+Sort formulae and/or casks by time modified, listing most recently modified first\. Has no effect when a formula or cask name is passed as an argument\.
 .
 .SS "\fBlog\fR [\fIoptions\fR] [\fIformula\fR]"
 Show the \fBgit log\fR for \fIformula\fR, or show the log for the Homebrew repository if no formula is provided\.