From 90ab0210d07580eea7099813c114e80b86f026b2 Mon Sep 17 00:00:00 2001 From: Daniel Borchmann Date: Sun, 15 Jun 2025 18:31:21 +0200 Subject: [PATCH] Make checkdoc happy and apply fill-column --- site-lisp/db-customize.el | 43 +++++++++++++++++++-------------------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/site-lisp/db-customize.el b/site-lisp/db-customize.el index ca1850c..17f73c5 100644 --- a/site-lisp/db-customize.el +++ b/site-lisp/db-customize.el @@ -100,42 +100,41 @@ If this path is not set, i.e., is null, no automatic download will happen." -;; NB: some of those files should also be elements of `org-agenda-files', but -;; this is not done automatically. The reason is that automatically changing -;; `org-agenda-files' when setting those variables may conflict with the -;; customization of `org-agenda-files' itself. Thus, when setting one of those -;; variables would update `org-agenda-files' (possibly saving the customiztion), -;; the original value of `org-agenda-files' would be gone. Conversely, loading -;; the customization for `org-agenda-files' would overwrite the work done by -;; custom setters. Thus, the only reasonable thing to do is to not update -;; `org-agenda-files' automatically and leave it to the user to update it. +;; NB: some of those files should also be elements of `org-agenda-files', but this is not done +;; automatically. The reason is that automatically changing `org-agenda-files' when setting those +;; variables may conflict with the customization of `org-agenda-files' itself. Thus, when setting +;; one of those variables would update `org-agenda-files' (possibly saving the customiztion), the +;; original value of `org-agenda-files' would be gone. Conversely, loading the customization for +;; `org-agenda-files' would overwrite the work done by custom setters. Thus, the only reasonable +;; thing to do is to not update `org-agenda-files' automatically and leave it to the user to update +;; it. (defcustom db/org-default-org-file nil - "Path to default org-mode file for general use. + "Path to default Org mode file for general use. You may also want to add this file to `org-agenda-files'." :group 'personal-settings :type '(choice (const nil) file)) (defcustom db/org-default-work-file nil - "Path to default org-mode file at work. + "Path to default Org mode file at work. You may also want to add this file to `org-agenda-files'." :group 'personal-settings :type '(choice (const nil) file)) (defcustom db/org-default-home-file nil - "Path to default org-mode file at home. + "Path to default Org mode file at home. You may also want to add this file to `org-agenda-files'." :group 'personal-settings :type '(choice (const nil) file)) (defcustom db/org-default-notes-file nil - "Path to default org-mode file for notes. + "Path to default Org mode file for notes. You may also want to add this file to `org-agenda-files'." :group 'personal-settings :type '(choice (const nil) file)) (defcustom db/org-default-refile-file nil - "Path to default org-mode file for capturing. + "Path to default `org-mode' file for capturing. This file is used by `org-agenda' to query for tasks that need to be refiled, independently of whether it's part of `org-agenda-files' or not. You may still want to add this file @@ -166,13 +165,13 @@ in the main agenda view." ("Unicode Lookup" ?U insert-char) ("Timeline of Day" ?T timeline-tools-format-timeline-of-day) ("Copy template to point" ?C db/org-insert-checklist)) - "Mapping of frequently used features to functions implementing -them. Can be used in application shortcuts such as -`db/helm-shortcuts’. Each entry is a list of three items: a -short description, a shortcut character, and the function to -call. Customizing this variable redefines the global -`hydra-feature-shortcuts'. Instead of a shortcut character, nil -can be chosen, in which case no entry in the + "Mapping of frequently used features to functions implementing them. + + Can be used in application shortcuts such as `db/helm-shortcuts’. Each +entry is a list of three items: a short description, a shortcut +character, and the function to call. Customizing this variable +redefines the global `hydra-feature-shortcuts'. Instead of a shortcut +character, nil can be chosen, in which case no entry in the `hydra-feature-shortcuts' will be generated." :group 'personal-settings :type '(repeat (list string (choice character (const nil)) function)) @@ -188,4 +187,4 @@ can be chosen, in which case no entry in the (provide 'db-customize) -;;; db-customize ends here +;;; db-customize.el ends here