[core] Fix ugly comment formating
In my last commit I have messed up the comment formats so that they not longer show correctly in help buffers. This fixes it.
This commit is contained in:
parent
793898f818
commit
ca2cdd0fcc
|
@ -457,11 +457,11 @@ and todos. If non nil only the file name is shown.")
|
||||||
(defvar dotspacemacs--pretty-ignore-subdirs
|
(defvar dotspacemacs--pretty-ignore-subdirs
|
||||||
'(".cache/junk")
|
'(".cache/junk")
|
||||||
"Subdirectories of `spacemacs-start-directory' to ignore when
|
"Subdirectories of `spacemacs-start-directory' to ignore when
|
||||||
prettifying Org files.")
|
prettifying Org files.")
|
||||||
|
|
||||||
(defun dotspacemacs//prettify-spacemacs-docs ()
|
(defun dotspacemacs//prettify-spacemacs-docs ()
|
||||||
"Run `spacemacs/prettify-org-buffer' if `buffer-file-name'
|
"Run `spacemacs/prettify-org-buffer' if `buffer-file-name'
|
||||||
looks like Spacemacs documentation."
|
looks like Spacemacs documentation."
|
||||||
(when (and dotspacemacs-pretty-docs
|
(when (and dotspacemacs-pretty-docs
|
||||||
spacemacs-start-directory
|
spacemacs-start-directory
|
||||||
buffer-file-name)
|
buffer-file-name)
|
||||||
|
@ -477,8 +477,8 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defmacro dotspacemacs|call-func (func &optional msg)
|
(defmacro dotspacemacs|call-func (func &optional msg)
|
||||||
"Call the function from the dotfile only if it is bound.
|
"Call the function from the dotfile only if it is bound.
|
||||||
If MSG is not nil then display a message in `*Messages*'. Errors
|
If MSG is not nil then display a message in `*Messages*'. Errors
|
||||||
are caught and signaled to user in spacemacs buffer."
|
are caught and signaled to user in spacemacs buffer."
|
||||||
`(progn
|
`(progn
|
||||||
(when ,msg (spacemacs-buffer/message ,msg))
|
(when ,msg (spacemacs-buffer/message ,msg))
|
||||||
(when (fboundp ',func)
|
(when (fboundp ',func)
|
||||||
|
@ -508,7 +508,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs//check-layers-changed ()
|
(defun dotspacemacs//check-layers-changed ()
|
||||||
"Check if the value of `dotspacemacs-configuration-layers'
|
"Check if the value of `dotspacemacs-configuration-layers'
|
||||||
changed, and issue a warning if it did."
|
changed, and issue a warning if it did."
|
||||||
(unless (eq dotspacemacs-configuration-layers
|
(unless (eq dotspacemacs-configuration-layers
|
||||||
dotspacemacs--configuration-layers-saved)
|
dotspacemacs--configuration-layers-saved)
|
||||||
(spacemacs-buffer/warning (concat
|
(spacemacs-buffer/warning (concat
|
||||||
|
@ -519,8 +519,8 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs//read-editing-style-config (config)
|
(defun dotspacemacs//read-editing-style-config (config)
|
||||||
"Read editing style CONFIG: apply variables and return the editing style.
|
"Read editing style CONFIG: apply variables and return the editing style.
|
||||||
CONFIG can be the symbol of an editing style or a list where the car is
|
CONFIG can be the symbol of an editing style or a list where the car is
|
||||||
the symbol of an editing style and the cdr is a list of keyword arguments like
|
the symbol of an editing style and the cdr is a list of keyword arguments like
|
||||||
`:variables'."
|
`:variables'."
|
||||||
(cond
|
(cond
|
||||||
((symbolp config) config)
|
((symbolp config) config)
|
||||||
|
@ -543,7 +543,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs/add-layer (layer-name)
|
(defun dotspacemacs/add-layer (layer-name)
|
||||||
"Add LAYER_NAME to dotfile and reload the it.
|
"Add LAYER_NAME to dotfile and reload the it.
|
||||||
Returns non nil if the layer has been effectively inserted."
|
Returns non nil if the layer has been effectively inserted."
|
||||||
(unless (configuration-layer/layer-used-p layer-name)
|
(unless (configuration-layer/layer-used-p layer-name)
|
||||||
(with-current-buffer (find-file-noselect (dotspacemacs/location))
|
(with-current-buffer (find-file-noselect (dotspacemacs/location))
|
||||||
(beginning-of-buffer)
|
(beginning-of-buffer)
|
||||||
|
@ -570,8 +570,8 @@ and todos. If non nil only the file name is shown.")
|
||||||
(defun dotspacemacs/sync-configuration-layers (&optional arg)
|
(defun dotspacemacs/sync-configuration-layers (&optional arg)
|
||||||
"Synchronize declared layers in dotfile with spacemacs.
|
"Synchronize declared layers in dotfile with spacemacs.
|
||||||
|
|
||||||
Called with `C-u' skips `dotspacemacs/user-config'.
|
Called with `C-u' skips `dotspacemacs/user-config'.
|
||||||
Called with `C-u C-u' skips `dotspacemacs/user-config' _and_ preliminary tests."
|
Called with `C-u C-u' skips `dotspacemacs/user-config' _and_ preliminary tests."
|
||||||
(interactive "P")
|
(interactive "P")
|
||||||
(when (file-exists-p dotspacemacs-filepath)
|
(when (file-exists-p dotspacemacs-filepath)
|
||||||
(with-current-buffer (find-file-noselect dotspacemacs-filepath)
|
(with-current-buffer (find-file-noselect dotspacemacs-filepath)
|
||||||
|
@ -622,8 +622,8 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defmacro dotspacemacs|symbol-value (symbol)
|
(defmacro dotspacemacs|symbol-value (symbol)
|
||||||
"Return the value of SYMBOL corresponding to a dotspacemacs variable.
|
"Return the value of SYMBOL corresponding to a dotspacemacs variable.
|
||||||
If SYMBOL value is `display-graphic-p' then return the result of
|
If SYMBOL value is `display-graphic-p' then return the result of
|
||||||
`(display-graphic-p)', otherwise return the value of the symbol."
|
`(display-graphic-p)', otherwise return the value of the symbol."
|
||||||
`(if (eq 'display-graphic-p ,symbol) (display-graphic-p) ,symbol))
|
`(if (eq 'display-graphic-p ,symbol) (display-graphic-p) ,symbol))
|
||||||
|
|
||||||
(defun dotspacemacs/location ()
|
(defun dotspacemacs/location ()
|
||||||
|
@ -632,7 +632,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs/copy-template ()
|
(defun dotspacemacs/copy-template ()
|
||||||
"Copy `.spacemacs.template' in home directory. Ask for confirmation
|
"Copy `.spacemacs.template' in home directory. Ask for confirmation
|
||||||
before copying the file if the destination already exists."
|
before copying the file if the destination already exists."
|
||||||
(interactive)
|
(interactive)
|
||||||
(let* ((copy? (if (file-exists-p dotspacemacs-filepath)
|
(let* ((copy? (if (file-exists-p dotspacemacs-filepath)
|
||||||
(y-or-n-p
|
(y-or-n-p
|
||||||
|
@ -646,7 +646,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs//ido-completing-read (prompt candidates)
|
(defun dotspacemacs//ido-completing-read (prompt candidates)
|
||||||
"Call `ido-completing-read' with a CANDIDATES alist where the key is
|
"Call `ido-completing-read' with a CANDIDATES alist where the key is
|
||||||
a display strng and the value is the actual value to return."
|
a display strng and the value is the actual value to return."
|
||||||
(let ((ido-max-window-height (1+ (length candidates))))
|
(let ((ido-max-window-height (1+ (length candidates))))
|
||||||
(cadr (assoc (ido-completing-read prompt (mapcar 'car candidates))
|
(cadr (assoc (ido-completing-read prompt (mapcar 'car candidates))
|
||||||
candidates))))
|
candidates))))
|
||||||
|
@ -661,7 +661,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
(defun dotspacemacs/install (arg)
|
(defun dotspacemacs/install (arg)
|
||||||
"Install the dotfile, return non nil if the doftile has been installed.
|
"Install the dotfile, return non nil if the doftile has been installed.
|
||||||
|
|
||||||
If ARG is non nil then ask questions to the user before installing the dotfile."
|
If ARG is non nil then ask questions to the user before installing the dotfile."
|
||||||
(interactive "P")
|
(interactive "P")
|
||||||
;; preferences is an alist where the key is the text to replace by
|
;; preferences is an alist where the key is the text to replace by
|
||||||
;; the value in the dotfile
|
;; the value in the dotfile
|
||||||
|
@ -787,9 +787,9 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs/safe-load ()
|
(defun dotspacemacs/safe-load ()
|
||||||
"Error recovery from malformed .spacemacs.
|
"Error recovery from malformed .spacemacs.
|
||||||
Loads default .spacemacs template and suspends pruning of orphan packages.
|
Loads default .spacemacs template and suspends pruning of orphan packages.
|
||||||
Informs users of error and prompts for default editing style for use during
|
Informs users of error and prompts for default editing style for use during
|
||||||
error recovery."
|
error recovery."
|
||||||
(load (concat dotspacemacs-template-directory
|
(load (concat dotspacemacs-template-directory
|
||||||
".spacemacs.template"))
|
".spacemacs.template"))
|
||||||
(defadvice dotspacemacs/layers
|
(defadvice dotspacemacs/layers
|
||||||
|
@ -942,7 +942,7 @@ and todos. If non nil only the file name is shown.")
|
||||||
|
|
||||||
(defun dotspacemacs/test-dotfile (&optional hide-buffer)
|
(defun dotspacemacs/test-dotfile (&optional hide-buffer)
|
||||||
"Test settings in dotfile for correctness.
|
"Test settings in dotfile for correctness.
|
||||||
Return non-nil if all the tests passed."
|
Return non-nil if all the tests passed."
|
||||||
(interactive)
|
(interactive)
|
||||||
(configuration-layer/discover-layers 'refresh-index)
|
(configuration-layer/discover-layers 'refresh-index)
|
||||||
(let ((min-version "0.0"))
|
(let ((min-version "0.0"))
|
||||||
|
|
Loading…
Reference in a new issue