branch: externals/taxy
commit 9f9cfef1677e2e3fc5d9288f07271ee1566d37c3
Author: Adam Porter <a...@alphapapa.net>
Commit: Adam Porter <a...@alphapapa.net>
Docs: Reorder sections
---
README.org | 238 +++++++++++++++++++++----------------------
taxy.info | 340 ++++++++++++++++++++++++++++++-------------------------------
2 files changed, 289 insertions(+), 289 deletions(-)
diff --git a/README.org b/README.org
index 529f475..b1988f9 100644
--- a/README.org
+++ b/README.org
@@ -424,10 +424,10 @@ Some example applications may be found in the
[[file:examples/README.org][exampl
:TOC: :include descendants :depth 1 :ignore (descendants)
:END:
:CONTENTS:
-- [[#dynamic-taxys][Dynamic taxys]]
- [[#reusable-taxys][Reusable taxys]]
- [[#threading-macros][Threading macros]]
- [[#modifying-filled-taxys][Modifying filled taxys]]
+- [[#dynamic-taxys][Dynamic taxys]]
- [[#magit-section][Magit section]]
:END:
@@ -449,6 +449,124 @@ After defining a taxy, call ~taxy-fill~ with it and a
list of objects to fill th
To return a taxy in a more human-readable format (with only relevant fields
included), use ~taxy-plain~. You may also use ~taxy-mapcar~ to replace items
in a taxy with, e.g. a more useful representation.
+** Reusable taxys
+
+Since taxys are structs, they may be stored in variables and used in other
structs (being sure to copy the root taxy with ~taxy-emptied~ before filling).
For example, this shows using =taxy= to classify Matrix rooms in
[[https://github.com/alphapapa/ement.el][Ement.el]]:
+
+#+BEGIN_SRC elisp
+ (defun ement-roomy-buffer (room)
+ (alist-get 'buffer (ement-room-local room)))
+
+ (defvar ement-roomy-unread
+ (make-taxy :name "Unread"
+ :predicate (lambda (room)
+ (buffer-modified-p (ement-roomy-buffer room)))))
+
+ (defvar ement-roomy-opened
+ (make-taxy :name "Opened"
+ :description "Rooms with buffers"
+ :predicate #'ement-roomy-buffer
+ :taxys (list ement-roomy-unread
+ (make-taxy))))
+
+ (defvar ement-roomy-closed
+ (make-taxy :name "Closed"
+ :description "Rooms without buffers"
+ :predicate (lambda (room)
+ (not (ement-roomy-buffer room)))))
+
+ (defvar ement-roomy
+ (make-taxy
+ :name "Ement Rooms"
+ :taxys (list (make-taxy
+ :name "Direct"
+ :description "Direct messaging rooms"
+ :predicate (lambda (room)
+ (ement-room--direct-p room ement-session))
+ :taxys (list ement-roomy-opened
+ ement-roomy-closed))
+ (make-taxy
+ :name "Non-direct"
+ :description "Group chat rooms"
+ :taxys (list ement-roomy-opened
+ ement-roomy-closed)))))
+#+END_SRC
+
+Note how the taxys defined in the first three variables are used in subsequent
taxys. As well, the ~ement-roomy-opened~ taxy has an "anonymous" taxy, which
collects any rooms that aren't collected by its sibling taxy (otherwise those
objects would be collected into the parent, "Opened" taxy, which may not always
be the most useful way to present the objects).
+
+Using those defined taxys, we then fill the ~ement-roomy~ taxy with all of the
rooms in the user's session, and then use ~taxy-mapcar~ to replace the room
structs with useful representations for display:
+
+#+BEGIN_SRC elisp
+ (taxy-plain
+ (taxy-mapcar (lambda (room)
+ (list (ement-room--room-display-name room)
+ (ement-room-id room)))
+ (taxy-fill (ement-session-rooms ement-session)
+ (taxy-emptied ement-roomy))))
+#+END_SRC
+
+This produces:
+
+#+BEGIN_SRC elisp
+ ("Ement Rooms"
+ (("Direct" "Direct messaging rooms"
+ (("Opened" "Rooms with buffers"
+ (("Unread"
+ (("Lars Ingebrigtsen" "!nope:gnus.org")))))
+ ("Closed" "Rooms without buffers"
+ (("John Wiegley" "!not-really:newartisans.com")
+ ("Eli Zaretskii" "!im-afraid-not:gnu.org")))))
+ ("Non-direct" "Group chat rooms"
+ (("Opened" "Rooms with buffers"
+ (("Unread"
+ (("Emacs" "!WfZsmtnxbxTdoYPkaT:greyface.org")
+ ("#emacs" "!KuaCUVGoCiunYyKEpm:libera.chat")))
+ ;; The non-unread buffers in the "anonymous" taxy.
+ ((("magit/magit" "!HZYimOcmEAsAxOcgpE:gitter.im")
+ ("Ement.el" "!NicAJNwJawmHrEhqZs:matrix.org")
+ ("#emacsconf" "!UjTTDnYmSAslLTtMCF:libera.chat")
+ ("Emacs Matrix Client" "!ZrZoyXEyFrzcBZKNis:matrix.org")
+ ("org-mode" "!rUhEinythPhVTdddsb:matrix.org")
+ ("This Week in Matrix (TWIM)" "!xYvNcQPhnkrdUmYczI:matrix.org")))))
+ ("Closed" "Rooms without buffers"
+ (("#matrix-spec" "!NasysSDfxKxZBzJJoE:matrix.org")
+ ("#commonlisp" "!IiGsrmKRHzpupHRaKS:libera.chat")
+ ("Matrix HQ" "!OGEhHVWSdvArJzumhm:matrix.org")
+ ("#lisp" "!czLxhhEegTEGNKUBgo:libera.chat")
+ ("Emacs" "!gLamGIXTWBaDFfhEeO:matrix.org")
+ ("#matrix-dev:matrix.org" "!jxlRxnrZCsjpjDubDX:matrix.org")))))))
+#+END_SRC
+
+** Threading macros
+
+If you happen to like macros, ~taxy~ works well with threading (i.e.
~thread-last~ or ~->>~):
+
+#+BEGIN_SRC elisp
+ (thread-last ement-roomy
+ taxy-emptied
+ (taxy-fill (ement-session-rooms ement-session))
+ (taxy-mapcar (lambda (room)
+ (list (ement-room--room-display-name room)
+ (ement-room-id room))))
+ taxy-plain)
+#+END_SRC
+
+** Modifying filled taxys
+
+Sometimes it's necessary to modify a taxy after filling it with objects, e.g.
to sort the items and/or the sub-taxys. For this, use the function
~taxy-mapc-taxys~ (a.k.a. ~taxy-mapc*~). For example, in the sample
application [[file:examples/musicy.el][musicy.el]], the taxys and their items
are sorted after filling, like so:
+
+#+BEGIN_SRC elisp
+ (defun musicy-files (files)
+ (thread-last musicy-taxy
+ taxy-emptied
+ (taxy-fill files)
+ ;; Sort sub-taxys by their name.
+ (taxy-sort* #'string< #'taxy-name)
+ ;; Sort sub-taxys' items by name.
+ (taxy-sort #'string< #'identity)
+ taxy-magit-section-pp))
+#+END_SRC
+
** Dynamic taxys
:PROPERTIES:
:TOC: :include descendants
@@ -736,124 +854,6 @@ And this produces:
("Soccer" "Tennis" "Football" "Baseball"))))))
#+end_src
-** Reusable taxys
-
-Since taxys are structs, they may be stored in variables and used in other
structs (being sure to copy the root taxy with ~taxy-emptied~ before filling).
For example, this shows using =taxy= to classify Matrix rooms in
[[https://github.com/alphapapa/ement.el][Ement.el]]:
-
-#+BEGIN_SRC elisp
- (defun ement-roomy-buffer (room)
- (alist-get 'buffer (ement-room-local room)))
-
- (defvar ement-roomy-unread
- (make-taxy :name "Unread"
- :predicate (lambda (room)
- (buffer-modified-p (ement-roomy-buffer room)))))
-
- (defvar ement-roomy-opened
- (make-taxy :name "Opened"
- :description "Rooms with buffers"
- :predicate #'ement-roomy-buffer
- :taxys (list ement-roomy-unread
- (make-taxy))))
-
- (defvar ement-roomy-closed
- (make-taxy :name "Closed"
- :description "Rooms without buffers"
- :predicate (lambda (room)
- (not (ement-roomy-buffer room)))))
-
- (defvar ement-roomy
- (make-taxy
- :name "Ement Rooms"
- :taxys (list (make-taxy
- :name "Direct"
- :description "Direct messaging rooms"
- :predicate (lambda (room)
- (ement-room--direct-p room ement-session))
- :taxys (list ement-roomy-opened
- ement-roomy-closed))
- (make-taxy
- :name "Non-direct"
- :description "Group chat rooms"
- :taxys (list ement-roomy-opened
- ement-roomy-closed)))))
-#+END_SRC
-
-Note how the taxys defined in the first three variables are used in subsequent
taxys. As well, the ~ement-roomy-opened~ taxy has an "anonymous" taxy, which
collects any rooms that aren't collected by its sibling taxy (otherwise those
objects would be collected into the parent, "Opened" taxy, which may not always
be the most useful way to present the objects).
-
-Using those defined taxys, we then fill the ~ement-roomy~ taxy with all of the
rooms in the user's session, and then use ~taxy-mapcar~ to replace the room
structs with useful representations for display:
-
-#+BEGIN_SRC elisp
- (taxy-plain
- (taxy-mapcar (lambda (room)
- (list (ement-room--room-display-name room)
- (ement-room-id room)))
- (taxy-fill (ement-session-rooms ement-session)
- (taxy-emptied ement-roomy))))
-#+END_SRC
-
-This produces:
-
-#+BEGIN_SRC elisp
- ("Ement Rooms"
- (("Direct" "Direct messaging rooms"
- (("Opened" "Rooms with buffers"
- (("Unread"
- (("Lars Ingebrigtsen" "!nope:gnus.org")))))
- ("Closed" "Rooms without buffers"
- (("John Wiegley" "!not-really:newartisans.com")
- ("Eli Zaretskii" "!im-afraid-not:gnu.org")))))
- ("Non-direct" "Group chat rooms"
- (("Opened" "Rooms with buffers"
- (("Unread"
- (("Emacs" "!WfZsmtnxbxTdoYPkaT:greyface.org")
- ("#emacs" "!KuaCUVGoCiunYyKEpm:libera.chat")))
- ;; The non-unread buffers in the "anonymous" taxy.
- ((("magit/magit" "!HZYimOcmEAsAxOcgpE:gitter.im")
- ("Ement.el" "!NicAJNwJawmHrEhqZs:matrix.org")
- ("#emacsconf" "!UjTTDnYmSAslLTtMCF:libera.chat")
- ("Emacs Matrix Client" "!ZrZoyXEyFrzcBZKNis:matrix.org")
- ("org-mode" "!rUhEinythPhVTdddsb:matrix.org")
- ("This Week in Matrix (TWIM)" "!xYvNcQPhnkrdUmYczI:matrix.org")))))
- ("Closed" "Rooms without buffers"
- (("#matrix-spec" "!NasysSDfxKxZBzJJoE:matrix.org")
- ("#commonlisp" "!IiGsrmKRHzpupHRaKS:libera.chat")
- ("Matrix HQ" "!OGEhHVWSdvArJzumhm:matrix.org")
- ("#lisp" "!czLxhhEegTEGNKUBgo:libera.chat")
- ("Emacs" "!gLamGIXTWBaDFfhEeO:matrix.org")
- ("#matrix-dev:matrix.org" "!jxlRxnrZCsjpjDubDX:matrix.org")))))))
-#+END_SRC
-
-** Threading macros
-
-If you happen to like macros, ~taxy~ works well with threading (i.e.
~thread-last~ or ~->>~):
-
-#+BEGIN_SRC elisp
- (thread-last ement-roomy
- taxy-emptied
- (taxy-fill (ement-session-rooms ement-session))
- (taxy-mapcar (lambda (room)
- (list (ement-room--room-display-name room)
- (ement-room-id room))))
- taxy-plain)
-#+END_SRC
-
-** Modifying filled taxys
-
-Sometimes it's necessary to modify a taxy after filling it with objects, e.g.
to sort the items and/or the sub-taxys. For this, use the function
~taxy-mapc-taxys~ (a.k.a. ~taxy-mapc*~). For example, in the sample
application [[file:examples/musicy.el][musicy.el]], the taxys and their items
are sorted after filling, like so:
-
-#+BEGIN_SRC elisp
- (defun musicy-files (files)
- (thread-last musicy-taxy
- taxy-emptied
- (taxy-fill files)
- ;; Sort sub-taxys by their name.
- (taxy-sort* #'string< #'taxy-name)
- ;; Sort sub-taxys' items by name.
- (taxy-sort #'string< #'identity)
- taxy-magit-section-pp))
-#+END_SRC
-
** Magit section
Showing a =taxy= with =magit-section= is very easy:
diff --git a/taxy.info b/taxy.info
index 9f28f9e..8da2494 100644
--- a/taxy.info
+++ b/taxy.info
@@ -50,10 +50,10 @@ Examples
Usage
-* Dynamic taxys::
* Reusable taxys::
* Threading macros::
* Modifying filled taxys::
+* Dynamic taxys::
* Magit section::
Dynamic taxys
@@ -535,16 +535,151 @@ replace items in a taxy with, e.g. a more useful
representation.
* Menu:
-* Dynamic taxys::
* Reusable taxys::
* Threading macros::
* Modifying filled taxys::
+* Dynamic taxys::
* Magit section::
-File: README.info, Node: Dynamic taxys, Next: Reusable taxys, Up: Usage
+File: README.info, Node: Reusable taxys, Next: Threading macros, Up: Usage
+
+3.1 Reusable taxys
+==================
+
+Since taxys are structs, they may be stored in variables and used in
+other structs (being sure to copy the root taxy with ‘taxy-emptied’
+before filling). For example, this shows using ‘taxy’ to classify
+Matrix rooms in Ement.el (https://github.com/alphapapa/ement.el):
+
+ (defun ement-roomy-buffer (room)
+ (alist-get 'buffer (ement-room-local room)))
+
+ (defvar ement-roomy-unread
+ (make-taxy :name "Unread"
+ :predicate (lambda (room)
+ (buffer-modified-p (ement-roomy-buffer room)))))
+
+ (defvar ement-roomy-opened
+ (make-taxy :name "Opened"
+ :description "Rooms with buffers"
+ :predicate #'ement-roomy-buffer
+ :taxys (list ement-roomy-unread
+ (make-taxy))))
+
+ (defvar ement-roomy-closed
+ (make-taxy :name "Closed"
+ :description "Rooms without buffers"
+ :predicate (lambda (room)
+ (not (ement-roomy-buffer room)))))
+
+ (defvar ement-roomy
+ (make-taxy
+ :name "Ement Rooms"
+ :taxys (list (make-taxy
+ :name "Direct"
+ :description "Direct messaging rooms"
+ :predicate (lambda (room)
+ (ement-room--direct-p room ement-session))
+ :taxys (list ement-roomy-opened
+ ement-roomy-closed))
+ (make-taxy
+ :name "Non-direct"
+ :description "Group chat rooms"
+ :taxys (list ement-roomy-opened
+ ement-roomy-closed)))))
+
+ Note how the taxys defined in the first three variables are used in
+subsequent taxys. As well, the ‘ement-roomy-opened’ taxy has an
+"anonymous" taxy, which collects any rooms that aren’t collected by its
+sibling taxy (otherwise those objects would be collected into the
+parent, "Opened" taxy, which may not always be the most useful way to
+present the objects).
+
+ Using those defined taxys, we then fill the ‘ement-roomy’ taxy with
+all of the rooms in the user’s session, and then use ‘taxy-mapcar’ to
+replace the room structs with useful representations for display:
+
+ (taxy-plain
+ (taxy-mapcar (lambda (room)
+ (list (ement-room--room-display-name room)
+ (ement-room-id room)))
+ (taxy-fill (ement-session-rooms ement-session)
+ (taxy-emptied ement-roomy))))
+
+ This produces:
+
+ ("Ement Rooms"
+ (("Direct" "Direct messaging rooms"
+ (("Opened" "Rooms with buffers"
+ (("Unread"
+ (("Lars Ingebrigtsen" "!nope:gnus.org")))))
+ ("Closed" "Rooms without buffers"
+ (("John Wiegley" "!not-really:newartisans.com")
+ ("Eli Zaretskii" "!im-afraid-not:gnu.org")))))
+ ("Non-direct" "Group chat rooms"
+ (("Opened" "Rooms with buffers"
+ (("Unread"
+ (("Emacs" "!WfZsmtnxbxTdoYPkaT:greyface.org")
+ ("#emacs" "!KuaCUVGoCiunYyKEpm:libera.chat")))
+ ;; The non-unread buffers in the "anonymous" taxy.
+ ((("magit/magit" "!HZYimOcmEAsAxOcgpE:gitter.im")
+ ("Ement.el" "!NicAJNwJawmHrEhqZs:matrix.org")
+ ("#emacsconf" "!UjTTDnYmSAslLTtMCF:libera.chat")
+ ("Emacs Matrix Client" "!ZrZoyXEyFrzcBZKNis:matrix.org")
+ ("org-mode" "!rUhEinythPhVTdddsb:matrix.org")
+ ("This Week in Matrix (TWIM)"
"!xYvNcQPhnkrdUmYczI:matrix.org")))))
+ ("Closed" "Rooms without buffers"
+ (("#matrix-spec" "!NasysSDfxKxZBzJJoE:matrix.org")
+ ("#commonlisp" "!IiGsrmKRHzpupHRaKS:libera.chat")
+ ("Matrix HQ" "!OGEhHVWSdvArJzumhm:matrix.org")
+ ("#lisp" "!czLxhhEegTEGNKUBgo:libera.chat")
+ ("Emacs" "!gLamGIXTWBaDFfhEeO:matrix.org")
+ ("#matrix-dev:matrix.org" "!jxlRxnrZCsjpjDubDX:matrix.org")))))))
+
+
+File: README.info, Node: Threading macros, Next: Modifying filled taxys,
Prev: Reusable taxys, Up: Usage
+
+3.2 Threading macros
+====================
+
+If you happen to like macros, ‘taxy’ works well with threading (i.e.
+‘thread-last’ or ‘->>’):
+
+ (thread-last ement-roomy
+ taxy-emptied
+ (taxy-fill (ement-session-rooms ement-session))
+ (taxy-mapcar (lambda (room)
+ (list (ement-room--room-display-name room)
+ (ement-room-id room))))
+ taxy-plain)
+
+
+File: README.info, Node: Modifying filled taxys, Next: Dynamic taxys, Prev:
Threading macros, Up: Usage
+
+3.3 Modifying filled taxys
+==========================
+
+Sometimes it’s necessary to modify a taxy after filling it with objects,
+e.g. to sort the items and/or the sub-taxys. For this, use the
+function ‘taxy-mapc-taxys’ (a.k.a. ‘taxy-mapc*’). For example, in the
+sample application musicy.el (examples/musicy.el), the taxys and their
+items are sorted after filling, like so:
+
+ (defun musicy-files (files)
+ (thread-last musicy-taxy
+ taxy-emptied
+ (taxy-fill files)
+ ;; Sort sub-taxys by their name.
+ (taxy-sort* #'string< #'taxy-name)
+ ;; Sort sub-taxys' items by name.
+ (taxy-sort #'string< #'identity)
+ taxy-magit-section-pp))
+
+
+File: README.info, Node: Dynamic taxys, Next: Magit section, Prev:
Modifying filled taxys, Up: Usage
-3.1 Dynamic taxys
+3.4 Dynamic taxys
=================
• • •
@@ -611,7 +746,7 @@ and it produces this taxonomy of buffers:
File: README.info, Node: Multi-level dynamic taxys, Next: "Chains" of
independent multi-level dynamic taxys, Up: Dynamic taxys
-3.1.1 Multi-level dynamic taxys
+3.4.1 Multi-level dynamic taxys
-------------------------------
Of course, the point of taxonomies is that they aren’t restricted to a
@@ -666,7 +801,7 @@ directory.
File: README.info, Node: "Chains" of independent multi-level dynamic taxys,
Next: Defining a classification domain-specific language, Prev: Multi-level
dynamic taxys, Up: Dynamic taxys
-3.1.2 "Chains" of independent, multi-level dynamic taxys
+3.4.2 "Chains" of independent, multi-level dynamic taxys
--------------------------------------------------------
_Naming things is hard._
@@ -738,7 +873,7 @@ use:
File: README.info, Node: Defining a classification domain-specific language,
Prev: "Chains" of independent multi-level dynamic taxys, Up: Dynamic taxys
-3.1.3 Defining a classification domain-specific language
+3.4.3 Defining a classification domain-specific language
--------------------------------------------------------
When writing a larger Taxy-based application, it may be necessary to
@@ -855,142 +990,7 @@ function so that users can pass their own list of keys:
("Soccer" "Tennis" "Football" "Baseball"))))))
-File: README.info, Node: Reusable taxys, Next: Threading macros, Prev:
Dynamic taxys, Up: Usage
-
-3.2 Reusable taxys
-==================
-
-Since taxys are structs, they may be stored in variables and used in
-other structs (being sure to copy the root taxy with ‘taxy-emptied’
-before filling). For example, this shows using ‘taxy’ to classify
-Matrix rooms in Ement.el (https://github.com/alphapapa/ement.el):
-
- (defun ement-roomy-buffer (room)
- (alist-get 'buffer (ement-room-local room)))
-
- (defvar ement-roomy-unread
- (make-taxy :name "Unread"
- :predicate (lambda (room)
- (buffer-modified-p (ement-roomy-buffer room)))))
-
- (defvar ement-roomy-opened
- (make-taxy :name "Opened"
- :description "Rooms with buffers"
- :predicate #'ement-roomy-buffer
- :taxys (list ement-roomy-unread
- (make-taxy))))
-
- (defvar ement-roomy-closed
- (make-taxy :name "Closed"
- :description "Rooms without buffers"
- :predicate (lambda (room)
- (not (ement-roomy-buffer room)))))
-
- (defvar ement-roomy
- (make-taxy
- :name "Ement Rooms"
- :taxys (list (make-taxy
- :name "Direct"
- :description "Direct messaging rooms"
- :predicate (lambda (room)
- (ement-room--direct-p room ement-session))
- :taxys (list ement-roomy-opened
- ement-roomy-closed))
- (make-taxy
- :name "Non-direct"
- :description "Group chat rooms"
- :taxys (list ement-roomy-opened
- ement-roomy-closed)))))
-
- Note how the taxys defined in the first three variables are used in
-subsequent taxys. As well, the ‘ement-roomy-opened’ taxy has an
-"anonymous" taxy, which collects any rooms that aren’t collected by its
-sibling taxy (otherwise those objects would be collected into the
-parent, "Opened" taxy, which may not always be the most useful way to
-present the objects).
-
- Using those defined taxys, we then fill the ‘ement-roomy’ taxy with
-all of the rooms in the user’s session, and then use ‘taxy-mapcar’ to
-replace the room structs with useful representations for display:
-
- (taxy-plain
- (taxy-mapcar (lambda (room)
- (list (ement-room--room-display-name room)
- (ement-room-id room)))
- (taxy-fill (ement-session-rooms ement-session)
- (taxy-emptied ement-roomy))))
-
- This produces:
-
- ("Ement Rooms"
- (("Direct" "Direct messaging rooms"
- (("Opened" "Rooms with buffers"
- (("Unread"
- (("Lars Ingebrigtsen" "!nope:gnus.org")))))
- ("Closed" "Rooms without buffers"
- (("John Wiegley" "!not-really:newartisans.com")
- ("Eli Zaretskii" "!im-afraid-not:gnu.org")))))
- ("Non-direct" "Group chat rooms"
- (("Opened" "Rooms with buffers"
- (("Unread"
- (("Emacs" "!WfZsmtnxbxTdoYPkaT:greyface.org")
- ("#emacs" "!KuaCUVGoCiunYyKEpm:libera.chat")))
- ;; The non-unread buffers in the "anonymous" taxy.
- ((("magit/magit" "!HZYimOcmEAsAxOcgpE:gitter.im")
- ("Ement.el" "!NicAJNwJawmHrEhqZs:matrix.org")
- ("#emacsconf" "!UjTTDnYmSAslLTtMCF:libera.chat")
- ("Emacs Matrix Client" "!ZrZoyXEyFrzcBZKNis:matrix.org")
- ("org-mode" "!rUhEinythPhVTdddsb:matrix.org")
- ("This Week in Matrix (TWIM)"
"!xYvNcQPhnkrdUmYczI:matrix.org")))))
- ("Closed" "Rooms without buffers"
- (("#matrix-spec" "!NasysSDfxKxZBzJJoE:matrix.org")
- ("#commonlisp" "!IiGsrmKRHzpupHRaKS:libera.chat")
- ("Matrix HQ" "!OGEhHVWSdvArJzumhm:matrix.org")
- ("#lisp" "!czLxhhEegTEGNKUBgo:libera.chat")
- ("Emacs" "!gLamGIXTWBaDFfhEeO:matrix.org")
- ("#matrix-dev:matrix.org" "!jxlRxnrZCsjpjDubDX:matrix.org")))))))
-
-
-File: README.info, Node: Threading macros, Next: Modifying filled taxys,
Prev: Reusable taxys, Up: Usage
-
-3.3 Threading macros
-====================
-
-If you happen to like macros, ‘taxy’ works well with threading (i.e.
-‘thread-last’ or ‘->>’):
-
- (thread-last ement-roomy
- taxy-emptied
- (taxy-fill (ement-session-rooms ement-session))
- (taxy-mapcar (lambda (room)
- (list (ement-room--room-display-name room)
- (ement-room-id room))))
- taxy-plain)
-
-
-File: README.info, Node: Modifying filled taxys, Next: Magit section, Prev:
Threading macros, Up: Usage
-
-3.4 Modifying filled taxys
-==========================
-
-Sometimes it’s necessary to modify a taxy after filling it with objects,
-e.g. to sort the items and/or the sub-taxys. For this, use the
-function ‘taxy-mapc-taxys’ (a.k.a. ‘taxy-mapc*’). For example, in the
-sample application musicy.el (examples/musicy.el), the taxys and their
-items are sorted after filling, like so:
-
- (defun musicy-files (files)
- (thread-last musicy-taxy
- taxy-emptied
- (taxy-fill files)
- ;; Sort sub-taxys by their name.
- (taxy-sort* #'string< #'taxy-name)
- ;; Sort sub-taxys' items by name.
- (taxy-sort #'string< #'identity)
- taxy-magit-section-pp))
-
-
-File: README.info, Node: Magit section, Prev: Modifying filled taxys, Up:
Usage
+File: README.info, Node: Magit section, Prev: Dynamic taxys, Up: Usage
3.5 Magit section
=================
@@ -1253,33 +1253,33 @@ Node: Sporty (understanding completely)10410
Node: Applications16397
Node: Installation16797
Node: Usage17110
-Node: Dynamic taxys19247
-Node: Multi-level dynamic taxys21866
-Node: "Chains" of independent multi-level dynamic taxys24059
-Node: Defining a classification domain-specific language26990
-Node: Reusable taxys31152
-Node: Threading macros35327
-Node: Modifying filled taxys35866
-Node: Magit section36684
-Node: Changelog37372
-Node: 06-pre37564
-Node: Additions37676
-Node: 0538514
-Node: Additions (1)38653
-Node: Fixes39759
-Node: 0439913
-Node: 0340135
-Node: Changes40264
-Node: Fixes (1)40627
-Node: 0241062
-Node: Changes (1)41231
-Node: Additions (2)41523
-Node: Fixes (2)42382
-Node: 0142636
-Node: Development42735
-Node: Copyright assignment42941
-Node: Credits43529
-Node: License43719
+Node: Reusable taxys19247
+Node: Threading macros23400
+Node: Modifying filled taxys23939
+Node: Dynamic taxys24757
+Node: Multi-level dynamic taxys27406
+Node: "Chains" of independent multi-level dynamic taxys29599
+Node: Defining a classification domain-specific language32530
+Node: Magit section36692
+Node: Changelog37371
+Node: 06-pre37563
+Node: Additions37675
+Node: 0538513
+Node: Additions (1)38652
+Node: Fixes39758
+Node: 0439912
+Node: 0340134
+Node: Changes40263
+Node: Fixes (1)40626
+Node: 0241061
+Node: Changes (1)41230
+Node: Additions (2)41522
+Node: Fixes (2)42381
+Node: 0142635
+Node: Development42734
+Node: Copyright assignment42940
+Node: Credits43528
+Node: License43718
End Tag Table
