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
commit3207fb58da9824918aab8dbd7df5f756559e46b7 (patch)
tree4d47b1d44bd834a6a73662cc53ff974923a9f4e0 /modules/custom-ordering.el
parentf3baaffa5126ece216f698f5296288208c22c64b (diff)
downloaddotemacs-3207fb58da9824918aab8dbd7df5f756559e46b7.tar.gz
dotemacs-3207fb58da9824918aab8dbd7df5f756559e46b7.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 0a499a35..4dc5bff8 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)