?
Current Path : /usr/share/emacs/24.3/lisp/ |
Linux gator3171.hostgator.com 4.19.286-203.ELK.el7.x86_64 #1 SMP Wed Jun 14 04:33:55 CDT 2023 x86_64 |
Current File : //usr/share/emacs/24.3/lisp/newcomment.elc |
;ELC ;;; Compiled by mockbuild@buildfarm06-new.corp.cloudlinux.com on Fri Oct 11 10:12:50 2024 ;;; from file /builddir/build/BUILD/emacs-24.3/lisp/newcomment.el ;;; in Emacs version 24.3 ;;; with all optimizations. ;;; This file uses dynamic docstrings, first added in Emacs 19.29. ;;; This file does not contain utf-8 non-ASCII characters, ;;; and so can be loaded in Emacs versions earlier than 23. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (byte-code "\300\301\302\"\210\300\303\304\"\210\300\305\306\"\210\300\307\310\"\210\311\312\313\314\315\316\317\320\321\322& \207" [defalias indent-for-comment comment-indent set-comment-column comment-set-column kill-comment comment-kill indent-new-comment-line comment-indent-new-line custom-declare-group comment nil "Indenting and filling of comments." :prefix "comment-" :version "21.1" :group fill] 10) #@287 Non-nil if syntax-tables can be used instead of regexps. Can also be `undecided' which means that a somewhat expensive test will be used to try to determine whether syntax-tables should be trusted to understand comments or not in the given buffer. Major modes should set this variable. (defvar comment-use-syntax 'undecided (#$ . 962)) (byte-code "\300\301\302\303\304DD\305\306\307\310\311&\210\300\312\302\303\313DD\314\306\315\310\311&\210\316\312!\210\317\312\320\321#\207" [custom-declare-variable comment-fill-column funcall function #[0 "\300\207" [nil] 1 "\n\n(fn)"] "Column to use for `comment-indent'. If nil, use `fill-column' instead." :type (choice (const nil) integer) :group comment comment-column #[0 "\300\207" [32] 1 "\n\n(fn)"] "Column to indent right-margin comments to.\nEach mode may establish a different default value for this variable; you\ncan set the value for a particular mode using that mode's hook.\nComments might be indented to a different value in order not to go beyond\n`comment-fill-column' or in order to align them with surrounding comments." integer make-variable-buffer-local put safe-local-variable integerp] 8) #@71 String to insert to start a new comment, or nil if no comment syntax. (defvar comment-start nil (#$ . 2125)) (put 'comment-start 'safe-local-variable 'string-or-null-p) #@201 Regexp to match the start of a comment plus everything up to its body. If there are any \(...\) pairs, the comment delimiter text is held to begin at the place matched by the close of the first pair. (defvar comment-start-skip nil (#$ . 2301)) (put 'comment-start-skip 'safe-local-variable 'stringp) #@72 Regexp to match the end of a comment plus everything back to its body. (defvar comment-end-skip nil (#$ . 2607)) (put 'comment-end-skip 'safe-local-variable 'stringp) #@109 String to insert to end a new comment. Should be an empty string if comments are terminated by end-of-line. (defvar comment-end (purecopy "") (#$ . 2781)) (put 'comment-end 'safe-local-variable 'stringp) #@297 Function to compute desired indentation for a comment. This function is called with no args with point at the beginning of the comment's starting delimiter and should return either the desired column indentation or nil. If nil is returned, indentation is delegated to `indent-according-to-mode'. (defvar comment-indent-function 'comment-indent-default (#$ . 2992)) #@203 Function to insert a comment when a line doesn't contain one. The function has no args. Applicable at least in modes for languages like fixed-format Fortran where comments always start in column zero. (defvar comment-insert-comment-function nil (#$ . 3364)) #@292 Function to comment a region. Its args are the same as those of `comment-region', but BEG and END are guaranteed to be correctly ordered. It is called within `save-excursion'. Applicable at least in modes for languages like fixed-format Fortran where comments always start in column zero. (defvar comment-region-function 'comment-region-default (#$ . 3630)) #@296 Function to uncomment a region. Its args are the same as those of `uncomment-region', but BEG and END are guaranteed to be correctly ordered. It is called within `save-excursion'. Applicable at least in modes for languages like fixed-format Fortran where comments always start in column zero. (defvar uncomment-region-function 'uncomment-region-default (#$ . 3997)) (defvar block-comment-start nil) (defvar block-comment-end nil) #@103 Non-nil if nested comments should be quoted. This should be locally set by each major mode if needed. (defvar comment-quote-nested t (#$ . 4436)) #@443 Continuation string to insert for multiline comments. This string will be added at the beginning of each line except the very first one when commenting a region with a commenting style that allows comments to span several lines. It should generally have the same length as `comment-start' in order to preserve indentation. If it is nil a value will be automatically derived from `comment-start' by replacing its first character with a space. (defvar comment-continue nil (#$ . 4589)) #@333 How many more comment chars should be inserted by `comment-region'. This determines the default value of the numeric argument of `comment-region'. The `plain' comment style doubles this value. This should generally stay 0, except for a few modes like Lisp where it is 1 so that regions are commented with two or three semi-colons. (defvar comment-add 0 (#$ . 5080)) #@1396 Comment region style definitions. Each style is defined with a form (STYLE . (MULTI ALIGN EXTRA INDENT DOC)). DOC should succinctly describe the style. STYLE should be a mnemonic symbol. MULTI specifies that comments are allowed to span multiple lines. e.g. in C it comments regions as /* blabla * bli */ rather than /* blabla */ /* bli */ if `comment-end' is empty, this has no effect. ALIGN specifies that the `comment-end' markers should be aligned. e.g. in C it comments regions as /* blabla */ /* bli */ rather than /* blabla */ /* bli */ if `comment-end' is empty, this has no effect, unless EXTRA is also set, in which case the comment gets wrapped in a box. EXTRA specifies that an extra line should be used before and after the region to comment (to put the `comment-end' and `comment-start'). e.g. in C it comments regions as /* * blabla * bli */ rather than /* blabla * bli */ if the comment style is not multi line, this has no effect, unless ALIGN is also set, in which case the comment gets wrapped in a box. INDENT specifies that the `comment-start' markers should not be put at the left margin but at the current indentation of the region to comment. If INDENT is `multi-char', that means indent multi-character comment starters, but not one-character comment starters. (defconst comment-styles '((plain nil nil nil nil "Start in column 0 (do not indent), as in Emacs-20") (indent-or-triple nil nil nil multi-char "Start in column 0, but only for single-char starters") (indent nil nil nil t "Full comment per line, ends not aligned") (aligned nil t nil t "Full comment per line, ends aligned") (box nil t t t "Full comment per line, ends aligned, + top and bottom") (extra-line t nil t t "One comment for all lines, end on a line by itself") (multi-line t nil nil t "One comment for all lines, end on last commented line") (box-multi t t t t "One comment for all lines, + top and bottom")) (#$ . 5455)) (byte-code "\301\302\303\304\305DD\306\307\310\300!\203 \311\312\313\"B\202 \314\315\316\317\320& \210\301\321\303\304\322DD\323\307\324\317\320&\210\301\325\303\304\326DD\327\315\330\307\331\317\320& \210\301\332\303\304\333DD\334\307\335\317\320&\210\301\336\303\304\337DD\340\307\341\317\320&\207" [comment-styles custom-declare-variable comment-style funcall function #[0 "\300\207" [indent] 1 "\n\n(fn)"] "Style to be used for `comment-region'.\nSee `comment-styles' for a list of available styles." :type boundp choice mapcar #[257 "\300\301\302\303@\3048#@F\207" [const :tag format "%s: %s" 5] 8 "\n\n(fn S)"] symbol :version "23.1" :group comment comment-padding #[0 "\300\301!\207" [purecopy " "] 2 "\n\n(fn)"] "Padding string that `comment-region' puts between comment chars and text.\nCan also be an integer which will be automatically turned into a string\nof the corresponding number of spaces.\n\nExtra spacing between the comment characters and the comment text\nmakes the comment easier to read. Default is 1. nil means 0." (choice string integer (const nil)) comment-inline-offset #[0 "\300\207" [1] 1 "\n\n(fn)"] "Inline comments have to be preceded by at least this many spaces.\nThis is useful when style-conventions require a certain minimal offset.\nPython's PEP8 for example recommends two spaces, so you could do:\n\n(add-hook 'python-mode-hook\n (lambda () (set (make-local-variable 'comment-inline-offset) 2)))\n\nSee `comment-padding' for whole-line comments." "24.3" integer comment-multi-line #[0 "\300\207" [nil] 1 "\n\n(fn)"] "Non-nil means `comment-indent-new-line' continues comments.\nThat is, it inserts no new terminator or starter.\nThis affects `auto-fill-mode', which is the main reason to\ncustomize this variable.\n\nIt also affects \\[indent-new-comment-line]. However, if you want this\nbehavior for explicit filling, you might as well use \\[newline-and-indent]." boolean comment-empty-lines #[0 "\300\207" [nil] 1 "\n\n(fn)"] "If nil, `comment-region' does not comment out empty lines.\nIf t, it always comments out empty lines.\nIf `eol' it only comments out empty lines if comments are\nterminated by the end of line (i.e. `comment-end' is empty)." (choice (const :tag "Never" nil) (const :tag "Always" t) (const :tag "EOl-terminated" 'eol))] 10) #@99 Strip STR of any leading (if BEFOREP) and/or trailing (if AFTERP) space. (fn STR BEFOREP AFTERP) (defalias 'comment-string-strip #[771 "\300\301\205 \302\303\205 \304\305\260\"\210\306\307\"\207" [string-match "\\`" "\\s-*" "\\(.*?\\)" "\\s-*\n?" "\\'" match-string 1] 9 (#$ . 9799)]) #@74 Return the mirror image of string S, without any trailing space. (fn S) (defalias 'comment-string-reverse #[257 "\301\302\303\")\237\260\303\304#\207" [string comment-string-strip append nil t] 5 (#$ . 10098)]) #@337 Check and set up variables needed by other commenting functions. All the `comment-*' commands call this function to set up various variables, like `comment-start', to ensure that the commenting functions work correctly. Lisp callers of any other `comment-*' function should first call this function explicitly. (fn &optional NOERROR) (defalias 'comment-normalize-vars #[256 "?\205 \211?\205\204, \306\307!\310G!\203 \311\312!\210\202+ \313\300!\210\211\313\301!\210\211\210\n\314=\203v \313\302!\210\315 \316\230\203C \317\202D \320\321!r\211q\210\322\323\324\325\326\327!\330\"\331\332%DC\216\333!\210\334\261\210eb\210\335\336!\205p m*\262\266\203\f\204| \324\f\250\203\206 \337\f\340\" \204\246 \316\230\204\246 \313\305!\210\341\342\"\203\237 \343\202\240 \344\336\345OP \203\261 \341 \"\204\300 \313\301!\210\346\347\350\351\211#!\352Q+\205\324 \341+\316\230\203\322 \317\202\323 \"?\205\316\230\203\342 \317\202\347 \350\351\211#\313\353!\210\3540\203\365 \316\202\366 \355\356\347\324\336O!0\203 G\336X\203 \316\202\355\347\336\345O!\357\260\211+\262\207" [comment-start comment-start-skip comment-use-syntax comment-end comment-padding comment-continue read-string "No comment syntax is defined. Use: " zerop error "No comment syntax defined" make-local-variable undecided syntax-table "" "\n" generate-new-buffer " *temp*" funcall make-byte-code 0 "\301\300!\205 \302\300!\207" vconcat vector [buffer-name kill-buffer] 2 "\n\n(fn)" set-syntax-table " hello " forward-comment 1 make-string 32 string-match "\\S-\\S-" " " "|" nil "\\(\\(^\\|[^\\\n]\\)\\(\\\\\\\\\\)*\\)\\(\\s<+\\|" regexp-quote comment-string-strip t "+\\)[ ]*" comment-end-skip "[ ]*\\(\\s>" "+" "\\|" "\\)" comment-quote-nested] 12 (#$ . 10321)]) (defalias 'comment-quote-re #[514 "\300\301\302O!\303\203 \304\202 \305\300\302\306O!R\207" [regexp-quote 0 1 "\\\\" "+" "*" nil] 9 "\n\n(fn STR UNP)"]) #@102 Quote or unquote nested comments. If UNP is non-nil, unquote nested comment markers. (fn CS CE UNP) (defalias 'comment-quote-nested #[771 "\301\302\211#\262\301\302\211#\262\205\211 G\303V\205\211 \304\"\305\304\"Qeb\210\306\307\302#\205\207 \303\224b\210\310u\210\203@ \311\310!\210\202C \312c\210G\310U\203&