diff --git a/CHANGELOG.md b/CHANGELOG.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Revision history for brick-list-search
 
+## 0.1.2.1 -- 2023-02-26
+
+* Improved documentation
+* Made `listSearchBy` and `listSearchByPages` a bit more efficient
+
 ## 0.1.2.0 -- 2023-02-22
 
 * Added `listShowTheTop` and `listShowTheBottom`.
diff --git a/brick-list-search.cabal b/brick-list-search.cabal
--- a/brick-list-search.cabal
+++ b/brick-list-search.cabal
@@ -1,6 +1,6 @@
 cabal-version: 3.0
 name: brick-list-search
-version: 0.1.2.0
+version: 0.1.2.1
 
 synopsis: Search forward or backward for certain kinds of items in brick list
 
diff --git a/src/Brick/Widgets/List/Search.hs b/src/Brick/Widgets/List/Search.hs
--- a/src/Brick/Widgets/List/Search.hs
+++ b/src/Brick/Widgets/List/Search.hs
@@ -10,7 +10,7 @@
   IncludeCurrent
 -- * Low-level functions
 --
--- | These functions are used in list manipulation.
+-- | These functions are used in list manipulation and list display.
 , searchListForward
 , searchListBackward
 -- * List manipulation
@@ -23,6 +23,8 @@
 , listSearchFromBeginning
 , listSearchFromEnd
 -- * List display
+--
+-- | List display functions do not change the current list element.
 , listShowTheTop
 , listShowTheBottom
 -- * Classes
@@ -108,7 +110,7 @@
                then (searchListBackward, searchListForward)
                else (searchListForward, searchListBackward)
     in case searchList True test l' of
-      Nothing -> case searchListOpposite True test l' of
+      Nothing -> case searchListOpposite False test l' of
         Nothing -> l
         Just idx -> l & L.listSelectedL ?~ idx
       Just idx -> l & L.listSelectedL ?~ idx
@@ -164,7 +166,7 @@
            then (searchListBackward, searchListForward)
            else (searchListForward, searchListBackward)
     modify $ \l -> case searchList True test l of
-      Nothing -> case searchListOpposite True test l of
+      Nothing -> case searchListOpposite False test l of
         Nothing -> origL
         Just idx -> l & L.listSelectedL ?~ idx
       Just idx -> l & L.listSelectedL ?~ idx