BREAKING CHANGE: work around current org-fold and isearch bug

* This changes how `org-fill-paragraph' fills.
* BUG: (org-open-at-point) on a link may prompt to visit a tags table

README.org

@@ -239,6 +239,7 @@ recommendation of [[info:emacs#Saving Customizations][saving customizations (inf
  kill-ring-max 300
  lazy-count-prefix-format nil
  lazy-count-suffix-format " (%s/%s)"
+ lazy-highlight-initial-delay 1.0
  mode-line-compact 'long
  next-error-message-highlight t
  recentf-mode t
@@ -2225,7 +2226,17 @@ unbind the `org-babel' interface functions when ACTIVE is nil."
 #+name: lst:set-org-link-options
 #+begin_src emacs-lisp -n :results silent
 (with-eval-after-load 'ol
-  (setopt org-link-file-path-type 'relative))
+  ;; I prefer setting `org-link-descriptive' to `nil' over the hook
+  ;; below to make `isearch' bearable when finding matches in links.
+  ;; Setting `org-link-descriptive' to `nil' is a breaking change,
+  ;; since it changes how `org-fill-paragraph' fills.
+  ;; (add-hook 'isearch-mode-hook
+  ;;           (defun unset-org-link-descriptive ()
+  ;;             (when (and (derived-mode-p 'org-mode)
+  ;;                        (bound-and-true-p org-link-descriptive))
+  ;;               (org-toggle-link-display))))
+  (setopt org-link-descriptive nil
+          org-link-file-path-type 'relative))
 #+end_src
 
 #+caption[Setup =org-mode-map=]: