From 6bb945de169372257fcea2be4e46c88c4ab62f36 Mon Sep 17 00:00:00 2001
From: Gerard Vermeulen <gerard.vermeulen@neel.cnrs.fr>
Date: Fri, 21 Jan 2022 06:56:03 +0100
Subject: [PATCH] Configure dash and present popular libraries

---
 README.org | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/README.org b/README.org
index ede20f0..82806ee 100644
--- a/README.org
+++ b/README.org
@@ -2101,6 +2101,48 @@ instance [[https://numpy.org/][numpy]] and [[https://scipy.org/][scipy]].
 *** TODO Look into: editing facilities
 1. [[https://github.com/douglasdavis/numpydoc.el/blob/main/numpydoc.el][Emacs extension to insert numpy style docstrings in function definitions]]
 
+* [[https://github.com/emacs-tw/awesome-emacs#library][Libraries]]
+:PROPERTIES:
+:CUSTOM_ID: sec:libraries
+:END:
+** [[info:dash.info#Top][Library dash.el (info)]]
+:PROPERTIES:
+:CUSTOM_ID: sec:dash-library
+:END:
+The library [[info:dash.info#Top][dash.el (info)]]positions itself as a modern alternative for the list
+processing API of [[info:cl#Top][cl]].  It is a requirement of several important packages in this
+Emacs setup (for instance [[https://github.com/pythonic-emacs/anaconda-mode#readme][anaconda]], [[https://github.com/andras-simonyi/citeproc-el#readme][citeproc]], [[https://github.com/magit/magit#readme][magit]], and [[https://github.com/Fuco1/smartparens#readme][smartparens]]).  Listing
+[[lst:configure-dash]] enables fontification of =dash= macros and makes
+=info-lookup-symbol= take into account the =dash= macros.
+
+#+caption[Configure =dash= fontification and info lookup]:
+#+caption: Configure =dash= fontification and info lookup.
+#+name: lst:configure-dash
+#+begin_src emacs-lisp
+  (when (fboundp #'global-dash-fontify-mode)
+    (global-dash-fontify-mode))
+
+  (when (fboundp #'dash-register-info-lookup)
+    (with-eval-after-load 'info-look
+      (dash-register-info-lookup)))
+#+end_src
+
+** [[https://github.com/rejeep/f.el][Library f.el]]
+:PROPERTIES:
+:CUSTOM_ID: sec:s-library
+:END:
+The library [[https://github.com/rejeep/f.el][f.el]] positions itself as a modern API for working with files and
+directories in Emacs.  It is a requirement of several packages in this Emacs
+setup ([[https://github.com/pythonic-emacs/anaconda-mode#readme][anaconda]], [[https://github.com/andras-simonyi/citeproc-el#readme][citeproc]], [[https://github.com/pythonic-emacs/pythonic#readme][pythonic]]) and requires no configuration.
+
+** [[https://github.com/magnars/s.el][Library s.el]]
+:PROPERTIES:
+:CUSTOM_ID: sec:s-library
+:END:
+The library [[https://github.com/magnars/s.el][s.el]] positions itself as the long lost Emacs string manipulation
+library.  It is a requirement of several packages in this Emacs setup ([[https://github.com/pythonic-emacs/anaconda-mode#readme][anaconda]],
+[[https://github.com/andras-simonyi/citeproc-el#readme][citeproc]], [[https://github.com/bdarcus/citar#readme][citar]], and [[https://github.com/pythonic-emacs/company-anaconda][company-anaconda]]) and requires no configuration.
+
 * [[info:emacs#Minor Modes][Minor Modes (info)]]
 :PROPERTIES:
 :CUSTOM_ID: sec:minor-modes