[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/taxy 9f9cfef 34/42: Docs: Reorder sections
From: |
ELPA Syncer |
Subject: |
[elpa] externals/taxy 9f9cfef 34/42: Docs: Reorder sections |
Date: |
Wed, 15 Sep 2021 12:57:32 -0400 (EDT) |
branch: externals/taxy
commit 9f9cfef1677e2e3fc5d9288f07271ee1566d37c3
Author: Adam Porter <adam@alphapapa.net>
Commit: Adam Porter <adam@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
- [elpa] externals/taxy e92ef13 22/42: Comment: Add FIXME, (continued)
- [elpa] externals/taxy e92ef13 22/42: Comment: Add FIXME, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 0cda29a 38/42: Add: (taxy-magit-section-define-column-definer) Custom-type, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy a7ff557 33/42: Docs: Document new things, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 5020b43 31/42: Change: (deffy-goto-form) Bug #50576 is fixed., ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 0826a47 02/42: WIP: taxy-magit-section column/table formatting, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy d456f88 24/42: Add: (deffy-side-window-action), ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 3787f4f 25/42: Fix: (deffy-buffer) Ensure file name, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 7ecc461 15/42: Fix: (taxy-magit-section-define-column-definer) Use defcustoms, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 8b7a95a 35/42: Docs: Clarify, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 2f4d9c3 05/42: Add: (taxy-magit-section-insert-indent-items), ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 9f9cfef 34/42: Docs: Reorder sections,
ELPA Syncer <=
- [elpa] externals/taxy 7a63677 08/42: Add: (taxy-define-key-definer), ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 69872e4 06/42: Docs: Update readme, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy d682c37 13/42: Add: (taxy-make-take-function), ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 8d108ef 18/42: WIP: Rename elispy to deffy, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 468e9b9 01/42: Meta: Add .dir-locals.el, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 2430282 20/42: Tidy: Indentation, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy b37dd39 17/42: WIP: Tidy, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 43b8504 36/42: Docs: Update changelog, ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 16d4e50 23/42: Fix/Tidy: (deffy-buffer), ELPA Syncer, 2021/09/15
- [elpa] externals/taxy 45372f6 27/42: Fix: (taxy-magit-section-format-items) Width, ELPA Syncer, 2021/09/15