* lisp/ses.el: Fix 80-column-docstring warnings
Also remove redundant `:group` args and prefer #' to quote function names.
This commit is contained in:
parent
fc62efc563
commit
9b8b39cce1
1 changed files with 27 additions and 29 deletions
56
lisp/ses.el
56
lisp/ses.el
|
@ -84,17 +84,14 @@
|
|||
|
||||
(defcustom ses-initial-size '(1 . 1)
|
||||
"Initial size of a new spreadsheet, as a cons (NUMROWS . NUMCOLS)."
|
||||
:group 'ses
|
||||
:type '(cons (integer :tag "numrows") (integer :tag "numcols")))
|
||||
|
||||
(defcustom ses-initial-column-width 7
|
||||
"Initial width of columns in a new spreadsheet."
|
||||
:group 'ses
|
||||
:type '(integer :match (lambda (widget value) (> value 0))))
|
||||
|
||||
(defcustom ses-initial-default-printer "%.7g"
|
||||
"Initial default printer for a new spreadsheet."
|
||||
:group 'ses
|
||||
:type '(choice string
|
||||
(list :tag "Parenthesized string" string)
|
||||
function))
|
||||
|
@ -103,30 +100,27 @@
|
|||
"Things to do after entering a value into a cell.
|
||||
An abnormal hook that usually runs a cursor-movement function.
|
||||
Each function is called with ARG=1."
|
||||
:group 'ses
|
||||
:type 'hook
|
||||
:options '(forward-char backward-char next-line previous-line))
|
||||
|
||||
(defcustom ses-mode-hook nil
|
||||
"Hook functions to be run upon entering SES mode."
|
||||
:group 'ses
|
||||
:type 'hook)
|
||||
|
||||
(defcustom ses-jump-cell-name-function 'upcase
|
||||
"Function to process the string passed to function ‘ses-jump’. Set it to 'identity to make no change.
|
||||
(defcustom ses-jump-cell-name-function #'upcase
|
||||
"Function to process the string passed to function ‘ses-jump’.
|
||||
Set it to 'identity to make no change.
|
||||
Set it to 'upcase to make cell name change case isensitive.
|
||||
|
||||
May return
|
||||
|
||||
* a string, in this case this must be a cell name.
|
||||
* a (row . col) cons cell, in this case that must be valid cell coordinate."
|
||||
:group 'ses
|
||||
:type 'function)
|
||||
|
||||
(defcustom ses-jump-prefix-function 'ses-jump-prefix
|
||||
"Function that takes the prefix argument passed to function ‘ses-jump’. It may return the same
|
||||
sort of thing as ‘ses-jump-cell-name-function’."
|
||||
:group 'ses
|
||||
(defcustom ses-jump-prefix-function #'ses-jump-prefix
|
||||
"Function that takes the prefix argument passed to function ‘ses-jump’.
|
||||
It may return the same sort of thing as ‘ses-jump-cell-name-function’."
|
||||
:type 'function)
|
||||
|
||||
|
||||
|
@ -251,7 +245,7 @@ Used for listing local printers or renamed cells.")
|
|||
(suppress-keymap newmap t)
|
||||
;;These keys insert themselves as the beginning of a numeric value
|
||||
(dotimes (x (length numeric))
|
||||
(define-key newmap (substring numeric x (1+ x)) 'ses-read-cell))
|
||||
(define-key newmap (substring numeric x (1+ x)) #'ses-read-cell))
|
||||
(define-key newmap [remap clipboard-kill-region] #'ses-kill-override)
|
||||
(define-key newmap [remap end-of-line] #'ses-end-of-line)
|
||||
(define-key newmap [remap kill-line] #'ses-delete-row)
|
||||
|
@ -363,7 +357,7 @@ printer and then modify its output.")
|
|||
(t (error "Unexpected elements `%S' in list `ses-localvars'" x)))))
|
||||
|
||||
;;; This variable is documented as being permitted in file-locals:
|
||||
(put 'ses--symbolic-formulas 'safe-local-variable 'consp)
|
||||
(put 'ses--symbolic-formulas 'safe-local-variable #'consp)
|
||||
|
||||
(defconst ses-paramlines-plist
|
||||
'(ses--col-widths -5 ses--col-printers -4 ses--default-printer -3
|
||||
|
@ -1074,8 +1068,7 @@ the old and FORCE is nil."
|
|||
(defcustom ses-self-reference-early-detection nil
|
||||
"Non-nil if cycle detection is early for cells that refer to themselves."
|
||||
:version "24.1"
|
||||
:type 'boolean
|
||||
:group 'ses)
|
||||
:type 'boolean)
|
||||
|
||||
(defun ses-update-cells (list &optional force)
|
||||
"Recalculate cells in LIST, checking for dependency loops.
|
||||
|
@ -2082,8 +2075,8 @@ formula:
|
|||
;; Not to use tab characters for safe (tabs may do bad for column
|
||||
;; calculation).
|
||||
indent-tabs-mode nil)
|
||||
(1value (add-hook 'change-major-mode-hook 'ses-cleanup nil t))
|
||||
(1value (add-hook 'kill-buffer-hook 'ses-killbuffer-hook nil t))
|
||||
(1value (add-hook 'change-major-mode-hook #'ses-cleanup nil t))
|
||||
(1value (add-hook 'kill-buffer-hook #'ses-killbuffer-hook nil t))
|
||||
(cl-pushnew (current-buffer) ses--ses-buffer-list :test 'eq)
|
||||
;; This makes revert impossible if the buffer is read-only.
|
||||
;; (1value (add-hook 'before-revert-hook 'ses-cleanup nil t))
|
||||
|
@ -2134,8 +2127,8 @@ formula:
|
|||
;; find-alternate-file, post-command-hook doesn't get run for some reason,
|
||||
;; so use an idle timer to make sure.
|
||||
(setq ses--deferred-narrow 'ses-mode)
|
||||
(1value (add-hook 'post-command-hook 'ses-command-hook nil t))
|
||||
(run-with-idle-timer 0.01 nil 'ses-command-hook)
|
||||
(1value (add-hook 'post-command-hook #'ses-command-hook nil t))
|
||||
(run-with-idle-timer 0.01 nil #'ses-command-hook)
|
||||
(run-mode-hooks 'ses-mode-hook)))
|
||||
|
||||
(put 'ses-mode 'mode-class 'special)
|
||||
|
@ -2252,7 +2245,9 @@ Based on the current set of columns and `window-hscroll' position."
|
|||
;; Redisplay and recalculation
|
||||
;;----------------------------------------------------------------------------
|
||||
(defun ses-jump-prefix (prefix-int)
|
||||
"Convert an integer into a (ROW . COL), by numbering cells starting from 0 from top left to bottom right, going row by row."
|
||||
"Convert an integer (unversal prefix) into a (ROW . COL).
|
||||
Does it by numbering cells starting from 0 from top left to bottom right,
|
||||
going row by row."
|
||||
(and (>= prefix-int 0)
|
||||
(< prefix-int (* ses--numcols ses--numrows))
|
||||
(cons (/ prefix-int ses--numcols) (% prefix-int ses--numcols))))
|
||||
|
@ -2542,7 +2537,7 @@ Return nil if cell formula was unsafe and user declined confirmation."
|
|||
;; Position cursor inside close-quote.
|
||||
(setq initial (cons initial (length initial))))
|
||||
(dolist (key ses-completion-keys)
|
||||
(define-key ses-mode-edit-map key 'ses-edit-cell-complete-symbol))
|
||||
(define-key ses-mode-edit-map key #'ses-edit-cell-complete-symbol))
|
||||
;; make it globally visible, so that it can be visible from the minibuffer.
|
||||
(setq ses--completion-table ses--named-cell-hashmap)
|
||||
(list row col
|
||||
|
@ -2639,8 +2634,9 @@ With prefix, deletes several cells."
|
|||
;;----------------------------------------------------------------------------
|
||||
(defun ses-read-printer-complete-symbol ()
|
||||
(interactive)
|
||||
(let ((completion-at-point-functions (cons 'ses--read-printer-completion-at-point-function
|
||||
completion-at-point-functions)))
|
||||
(let ((completion-at-point-functions
|
||||
(cons #'ses--read-printer-completion-at-point-function
|
||||
completion-at-point-functions)))
|
||||
(completion-at-point)))
|
||||
|
||||
(defun ses--read-printer-completion-at-point-function ()
|
||||
|
@ -2682,7 +2678,7 @@ canceled."
|
|||
(setq default "")
|
||||
(setq prompt (format-prompt prompt default)))
|
||||
(dolist (key ses-completion-keys)
|
||||
(define-key ses-mode-edit-map key 'ses-read-printer-complete-symbol))
|
||||
(define-key ses-mode-edit-map key #'ses-read-printer-complete-symbol))
|
||||
;; make it globally visible, so that it can be visible from the minibuffer.
|
||||
(setq ses--completion-table ses--local-printer-hashmap)
|
||||
(let ((new (read-from-minibuffer prompt
|
||||
|
@ -4114,13 +4110,15 @@ SPAN indicates how many rightward columns to include in width (default = 0)."
|
|||
(ses-center value span ?- printer))
|
||||
|
||||
(defun ses-dashfill-span (value &optional printer)
|
||||
"Print VALUE, centered using dashes within the span that starts in the
|
||||
current column and continues until the next nonblank column."
|
||||
"Print VALUE, centered using dashes.
|
||||
Centers within the span that starts in the current column and continues
|
||||
until the next nonblank column."
|
||||
(ses-center-span value ?- printer))
|
||||
|
||||
(defun ses-tildefill-span (value &optional printer)
|
||||
"Print VALUE, centered using tildes within the span that starts in the
|
||||
current column and continues until the next nonblank column."
|
||||
"Print VALUE, centered using tildes.
|
||||
Centers within the span that starts in the current column and continues
|
||||
until the next nonblank column."
|
||||
(ses-center-span value ?~ printer))
|
||||
|
||||
(defun ses-prin1 (value)
|
||||
|
|
Loading…
Add table
Reference in a new issue