aboutsummaryrefslogtreecommitdiff
path: root/modules/custom-ordering.el
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-28 03:49:09 -0400
committerCraig Jennings <c@cjennings.net>2026-06-28 03:49:09 -0400
commit0ee61aba411e2abeee676ca802206cfc1676e04f (patch)
tree6438cea1110885c3d73ac2e32e15e59b9703d947 /modules/custom-ordering.el
parent095ffbb835ceac1841cf53a3cb3c2571c3f00ec3 (diff)
downloaddotemacs-0ee61aba411e2abeee676ca802206cfc1676e04f.tar.gz
dotemacs-0ee61aba411e2abeee676ca802206cfc1676e04f.zip
docs: fix blank package summaries and normalize more module headers
More of the commentary/comment audit. The custom-* command modules, weather-config, and mousetrap-mode had empty package summary lines and verbose summary paragraphs. I filled the summaries and condensed the prose while keeping each module's load-contract metadata. dwim-shell-config and auth-config had malformed ;; headers (now ;;;), local-repository had a leading BOM, and two test files had blank summaries.
Diffstat (limited to 'modules/custom-ordering.el')
-rw-r--r--modules/custom-ordering.el20
1 files changed, 4 insertions, 16 deletions
diff --git a/modules/custom-ordering.el b/modules/custom-ordering.el
index 0a499a35a..4dc5bff84 100644
--- a/modules/custom-ordering.el
+++ b/modules/custom-ordering.el
@@ -1,4 +1,4 @@
-;;; custom-ordering.el --- -*- coding: utf-8; lexical-binding: t; -*-
+;;; custom-ordering.el --- Region sorting and list-format transforms -*- coding: utf-8; lexical-binding: t; -*-
;;; Commentary:
;;
@@ -13,22 +13,10 @@
;; declare-function).
;; Direct test load: yes (requires keybindings explicitly).
;;
-;; Text transformation and sorting utilities for reformatting data structures.
+;; Region transforms under C-; o for sorting, reversing, numbering, quote
+;; toggling, and converting between line lists and comma-separated arrays.
+;; Helpers preserve trailing newlines where line-oriented callers expect them.
;;
-;; Array/list formatting:
-;; - arrayify/listify - convert lines to comma-separated format (with/without quotes, brackets)
-;; - unarrayify - convert arrays back to separate lines
-;;
-;; Line manipulation:
-;; - toggle-quotes - swap double ↔ single quotes
-;; - reverse-lines - reverse line order
-;; - number-lines - add line numbers with custom format (supports zero-padding)
-;; - alphabetize-region - sort words alphabetically
-;; - comma-separated-text-to-lines - split CSV text into lines
-;;
-;; Convenience functions: listify, arrayify-json, arrayify-python
-;; Bound to keymap prefix C-; o
-
;;; Code:
(require 'cl-lib)