branch: externals/taxy-magit-section
commit c113fda80dcbb76b0a21048896f347530ac9d138
Author: Adam Porter <a...@alphapapa.net>
Commit: Adam Porter <a...@alphapapa.net>
Fix: (taxy-magit-section-define-column-definer) Reduce docstring width
---
README.org | 3 ++-
taxy-magit-section.el | 8 ++++++--
taxy-magit-section.info | 26 ++++++++++++++------------
3 files changed, 22 insertions(+), 15 deletions(-)
diff --git a/README.org b/README.org
index c13b3b6e49..00e6196382 100644
--- a/README.org
+++ b/README.org
@@ -34,7 +34,8 @@ This library renders
[[https://github.com/alphapapa/taxy.el][Taxy]] structs with
** 0.14-pre
-Nothing new yet.
+*Fixes*
++ Reduce the potential width of macro-expanded docstrings to prevent
byte-compiler warnings.
** 0.13
diff --git a/taxy-magit-section.el b/taxy-magit-section.el
index 3c0ab5b84a..cf4c15ee94 100644
--- a/taxy-magit-section.el
+++ b/taxy-magit-section.el
@@ -276,8 +276,12 @@ PLIST may be a plist setting the following options:
(format "Columns defined by `%s'."
definer-name)))
(column-formatters-variable-name (intern (format
"%s-column-formatters" prefix)))
- (column-formatters-variable-docstring (format "Column formatters
defined by `%s'."
- definer-name)))
+ (column-formatters-variable-docstring
+ ;; For the best chance for this docstring to not exceed 80
characters in width,
+ ;; the macro's name goes on its own line.
+ (format "Column formatters defined by the macro:
+`%s'."
+ definer-name)))
`(let ((columns-variable ',columns-variable-name)
(column-formatters-variable ',column-formatters-variable-name))
(defcustom ,level-indent-variable-name 2
diff --git a/taxy-magit-section.info b/taxy-magit-section.info
index b78bc334ce..c37cd5a9b9 100644
--- a/taxy-magit-section.info
+++ b/taxy-magit-section.info
@@ -75,7 +75,9 @@ File: README.info, Node: 014-pre, Next: 013, Up: Changelog
2.1 0.14-pre
============
-Nothing new yet.
+*Fixes*
+ • Reduce the potential width of macro-expanded docstrings to prevent
+ byte-compiler warnings.
File: README.info, Node: 013, Next: 0122, Prev: 014-pre, Up: Changelog
@@ -192,17 +194,17 @@ Node: Top221
Node: Installation834
Node: Changelog1188
Node: 014-pre1443
-Node: 0131553
-Node: 01222028
-Node: 01212160
-Node: 0122293
-Node: 0112430
-Node: 0102631
-Node: 0912786
-Node: 093178
-Node: Development3368
-Node: Credits3595
-Node: License3785
+Node: 0131647
+Node: 01222122
+Node: 01212254
+Node: 0122387
+Node: 0112524
+Node: 0102725
+Node: 0912880
+Node: 093272
+Node: Development3462
+Node: Credits3689
+Node: License3879
End Tag Table
