diff --git a/calibredb-core.el b/calibredb-core.el index 9798ea2..2a9df9b 100644 --- a/calibredb-core.el +++ b/calibredb-core.el @@ -52,7 +52,7 @@ (defgroup calibredb nil - "calibredb group" + "Calibredb group." :group 'calibredb) (defcustom calibredb-db-dir nil diff --git a/calibredb-search.el b/calibredb-search.el index 1ac0da0..76f9b96 100644 --- a/calibredb-search.el +++ b/calibredb-search.el @@ -781,8 +781,7 @@ ebook record will be shown. (calibredb-search-update-buffer)) (defun calibredb-search-update-buffer (&optional page) - "Update the calibredb-search buffer listing to match the database. -When FORCE is non-nil, redraw even when the database hasn't changed." + "Update the calibredb-search buffer listing to match the database with PAGE." (interactive) (with-current-buffer (calibredb-search-buffer) (let* ((inhibit-read-only t) @@ -810,6 +809,7 @@ When FORCE is non-nil, redraw even when the database hasn't changed." entries))) (defun calibredb-search-more-data (page) + "Render candidates with PAGE." (let ((inhibit-read-only t)) (setq calibredb-search-current-page page) (beginning-of-line) @@ -818,6 +818,7 @@ When FORCE is non-nil, redraw even when the database hasn't changed." (defun calibredb-search-next-page () + "Render next calibredb page." (interactive) (if (< calibredb-search-current-page calibredb-search-pages) (progn @@ -826,6 +827,7 @@ When FORCE is non-nil, redraw even when the database hasn't changed." (message "Last page."))) (defun calibredb-search-previous-page () + "Render previous calibredb page." (interactive) (if (> calibredb-search-current-page 1) (progn diff --git a/calibredb-utils.el b/calibredb-utils.el index 9a2829f..ca97139 100644 --- a/calibredb-utils.el +++ b/calibredb-utils.el @@ -845,7 +845,7 @@ Argument TITLE prompts to input the title. Optional argument ISBN prompts to input the isbn." (let* ((fetch-cover (cond ((string= calibredb-fetch-covers "yes") t) ((string= calibredb-fetch-covers "no") nil) - (t (yes-or-no-p "Fetch cover?: ")))) + (t (yes-or-no-p "Fetch cover? ")))) (results (calibredb-fetch-metadata-from-sources author title ids isbn fetch-cover))) (cond (results (when fetch-cover (calibredb-select-and-set-cover)) @@ -947,7 +947,8 @@ With universal ARG \\[universal-argument] use title as initial value." ;; convert ebooks (defmacro calibredb-convert (type) - "Macro of function calibredb-convert-to-TYPE." + "Macro of function calibredb-convert-to-TYPE. +Argument TYPE ebook type." `(defun ,(intern (format "calibredb-convert-to-%s" type)) (&optional candidate) ,(format "TODO: Convert the slected CANDIDATE to %s." type) (interactive) @@ -1046,7 +1047,8 @@ With universal ARG \\[universal-argument] use title as initial value." ))) (defmacro calibredb-all (field) - "Macro of function calibredb-all-FIELD." + "Macro of function calibredb-all-FIELD. +Argument FIELD table name in database." `(defun ,(intern (format "calibredb-all-%s" field)) () ,(format "Get all %s and return as a list." field) (seq-uniq