From unknown Thu Aug 21 12:12:12 2025 X-Loop: help-debbugs@gnu.org Subject: bug#23060: Elisp Manual: Appendix D.7, comment tips Resent-From: Tianxiang Xiong Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 19 Mar 2016 06:14:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 23060 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 23060@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.145836801231432 (code B ref -1); Sat, 19 Mar 2016 06:14:01 +0000 Received: (at submit) by debbugs.gnu.org; 19 Mar 2016 06:13:32 +0000 Received: from localhost ([127.0.0.1]:53155 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ahA8h-0008As-OT for submit@debbugs.gnu.org; Sat, 19 Mar 2016 02:13:32 -0400 Received: from eggs.gnu.org ([208.118.235.92]:41947) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ah7rM-0004UR-IC for submit@debbugs.gnu.org; Fri, 18 Mar 2016 23:47:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ah7rE-0005Vj-DU for submit@debbugs.gnu.org; Fri, 18 Mar 2016 23:47:22 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, HTML_MESSAGE,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:36806) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ah7rE-0005Vf-9Y for submit@debbugs.gnu.org; Fri, 18 Mar 2016 23:47:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:32867) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ah7rB-0000A3-Gs for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2016 23:47:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ah7r8-0005UI-SE for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2016 23:47:17 -0400 Received: from mail-yw0-x231.google.com ([2607:f8b0:4002:c05::231]:35720) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ah7r8-0005U4-Ll for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2016 23:47:14 -0400 Received: by mail-yw0-x231.google.com with SMTP id g127so161656302ywf.2 for ; Fri, 18 Mar 2016 20:47:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to; bh=Agn4kympWri9uH9FtZ/SsP4H2ENdk8eQOhpFesoV2W0=; b=JSmtyJytxZeJ4p9XpQQxr6kG0DRolmbn1IqagD4PveOQKApIiDF7DEKLjyouAB+cer lnTQrtoqmuoJqWIdJdWQtolUiaySXyjUeX+48lICg1Gl9NxgSKjQExutEt5TWkdgHf0F wQeJ6XgS8DlSzXtzpnYsDVCeko0/r7n2mLzzWs31WbT7DNyK3/dJEqctQ3iuTlmAdPeF 0IOnV4gACSXvVLbHP/CBTNdhIwNt0IWRj2KFAKw5o86lZqjCgJve9jbMI4+tckXgoiOn CxG7J6sRrwi2cfzJNi12TedxJHQfmY2oi1IyOz90oo5PpTb6uNHIGYkonh65CtGTnYvi Z2oQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:date:message-id:subject:from:to; bh=Agn4kympWri9uH9FtZ/SsP4H2ENdk8eQOhpFesoV2W0=; b=koM/Dd6grgTznR8teAconziAAnhX2V8lbouV/r0TnNsG/x2OdDVqEWutF9xa7STlYr qpdW41NTZXWCUj6BQhucgOf3N/Cccvtz/AEXZkgRZWAvPzbK0ysa2O9SMQ92FHSDE+Fn T9DGFZRqPwZUJwtiBHF0JGN+UYClj1eLUcI1Jv6y0MbPCB+ivqYUUjWVAgvZTnnBkPBJ BCdSvvilzxsZSKQD4Q3rqMSE0LQs4bhnAnGbMEdVzmda+IgZyEJRDDLdAvT4ugwHDpu/ GoXFbWdl+oI5FVIWcLOfLfqyY70Q3+lVzyce5XAwfJcXNOWXXaYzaz1unsuqq1mdLCvv vnVQ== X-Gm-Message-State: AD7BkJK8F2BOiAOmkqb+ciFp5VLuoHr5jh7POOMpd77mJ/qppHFPwR/EyQFpLoIi9ExDSZxqqs9dz40lm4/Wvw== MIME-Version: 1.0 X-Received: by 10.129.27.6 with SMTP id b6mr9271279ywb.205.1458359233788; Fri, 18 Mar 2016 20:47:13 -0700 (PDT) Received: by 10.13.233.69 with HTTP; Fri, 18 Mar 2016 20:47:13 -0700 (PDT) Date: Fri, 18 Mar 2016 22:47:13 -0500 Message-ID: From: Tianxiang Xiong Content-Type: multipart/alternative; boundary=001a1142947815c1b1052e5eb831 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Mailman-Approved-At: Sat, 19 Mar 2016 02:13:29 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) --001a1142947815c1b1052e5eb831 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable From: Tianxiang Xiong To: bug-gnu-emacs@gnu.org Subject: 24.5.50; Elisp Manual: Appendix D.7, comment tips Date: Fri, 18 Mar 2016 22:46:01 -0500 Message-ID: <87egb7yvt2.fsf@asus.eau.wi.charter.com> --text follows this line-- --------------------------------------------------------------------------- =3D=3D Problem =3D=3D The Emacs Lisp Reference Manual's Appendix D.7 does not give a good description of what triple and quadruple semicolon comments should be used for. For triple semicolons, the manual says: Comments that start with three semicolons, =E2=80=98;;;=E2=80=99, shoul= d start at the left margin. We use them for comments which should be considered a =E2=80=9Cheading=E2=80=9D by Outline minor mode. For quadruple semicolons, the manual says: Comments that start with four semicolons, =E2=80=98;;;;=E2=80=99, shoul= d be aligned to the left margin and are used for headings of major sections of a program. For example: ;;;; The kill ring This does not make clear what the difference between the two are. As it turns out, 3-and-more semi-colons stand for headings, where the more semi-colons you put the deeper the nesting of the heading. E.g. ;;; Main heading ;;;; Sub heading ;;;;; Sub sub heading ;;;; Another sub heading ;;; Next main heading See this Emacs StackExchange answer by Stefan for more information: http://emacs.stackexchange.com/a/21061/10269 =3D=3D Solution =3D=3D I suggest that the description for three semicolons be changed to: Comments that start with three semicolons, =E2=80=98;;;=E2=80=99, are c= onsidered top-level headings by Outline minor mode. Four or more semicolons can be used as subheadings in hierarchical fashion. E.g. ;;; Main heading ;;;; Sub heading ;;;;; Sub sub heading ;;;; Another sub heading ;;; Next main heading These comments should be used to break Emacs Lisp code into sections. A link to "Outline minor mode" in the Emacs manual would be useful: https://www.gnu.org/software/emacs/manual/html_node/emacs/Outline-Mode.html The section for four semicolons can be elided. --------------------------------------------------------------------------- In GNU Emacs 24.5.50.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.14.6) of 2015-12-02 on asus Repository revision: a27ae9d7650a1230d4359eaf0a949f827315a6d2 Windowing system distributor `Fedora Project', version 11.0.11602901 System Description: Fedora release 21 (Twenty One) Important settings: value of $LANG: en_US.utf8 value of $XMODIFIERS: @im=3Dibus locale-coding-system: utf-8-unix Major mode: Org Minor modes in effect: flyspell-mode: t recentf-mode: t yas-global-mode: t yas-minor-mode: t show-smartparens-global-mode: t show-smartparens-mode: t smartparens-global-mode: t smartparens-mode: t projectile-global-mode: t projectile-mode: t popwin-mode: t pdf-occur-global-minor-mode: t global-page-break-lines-mode: t page-break-lines-mode: t display-battery-mode: t display-time-mode: t global-linum-mode: t linum-mode: t helm-descbinds-mode: t helm-mode: t shell-dirtrack-mode: t async-bytecomp-package-mode: t global-edit-server-edit-mode: t company-quickhelp-mode: t global-company-mode: t company-mode: t tooltip-mode: t electric-indent-mode: t mouse-wheel-mode: t global-prettify-symbols-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t visual-line-mode: t transient-mark-mode: t Recent messages: [yas] Loading for `html-mode', just-in-time: (lambda nil (yas--load-directory-1 (quote /home/txx/.emacs.d/elpa/yasnippet-20160226.1359/snippets/html-mode) (quote html-mode)))! [yas] Loading snippet files from /home/txx/.emacs.d/elpa/yasnippet-20160226.1359/snippets/html-mode [yas] Loading for `html-mode', just-in-time: (lambda nil (yas--load-directory-1 (quote /home/txx/.emacs.d/snippets/html-mode) (quote html-mode)))! [yas] Loading snippet files from /home/txx/.emacs.d/snippets/html-mode [yas] Loading for `nxml-mode', just-in-time: (lambda nil (yas--load-directory-1 (quote /home/txx/.emacs.d/elpa/yasnippet-20160226.1359/snippets/nxml-mode) (quote nxml-mode)))! [yas] Loading snippet files from /home/txx/.emacs.d/elpa/yasnippet-20160226.1359/snippets/nxml-mode is undefined byte-code: Beginning of buffer [11 times] Search failed. No matching tag found. [4 times] (No changes need to be saved) Quit Load-path shadows: /home/txx/.emacs.d/elpa/helm-20160303.1125/helm-multi-match hides /home/txx/.emacs.d/elpa/helm-core-20160303.1321/helm-multi-match Features: (shadow sort emacsbug message rfc822 mml mml-sec mm-decode mm-bodies mm-encode mailabbrev gmm-utils mailheader sendmail mail-utils semantic/find helm-semantic helm-imenu smartparens-html sgml-mode emmet-mode rainbow-mode color css-mode smie whitespace helm-command mail-extr macrostep-c subr-x cmacexp cc-langs cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs ido helm-pages eieio-opt speedbar sb-image ezimage dframe helm-elisp helm-eval edebug tabify vc-git flyspell ispell org-element org-rmail org-mhe org-irc org-info org-gnus org-docview doc-view org-bibtex bibtex org-bbdb org-w3m recentf tree-widget network-stream starttls image-file winner server disp-table company-oddmuse company-keywords company-etags company-gtags company-dabbrev-code company-dabbrev company-files company-capf company-cmake company-xcode company-clang company-semantic company-eclim company-template company-css company-nxml company-bbdb company-tern s ucs-normalize dash-functional tern url-http tls url-auth mail-parse rfc2231 rfc2047 rfc2045 ietf-drums url-gw json yasnippet help-mode cl zenburn-theme smartparens-config smartparens helm-projectile projectile grep dash popwin pdf-occur ibuf-ext ibuffer tablist tablist-filter semantic/wisent/comp semantic/wisent semantic/wisent/wisent semantic/util-modes semantic/util semantic semantic/tag semantic/lex semantic/fw mode-local cedet pdf-isearch let-alist pdf-misc imenu pdf-tools pdf-view mule-util jka-compr pdf-cache pdf-info tq pdf-util image-mode page-break-lines toc-org ert ewoc debug ob-scheme ob-lisp ob-clojure org org-macro org-footnote org-pcomplete org-list org-faces org-entities org-version ob-emacs-lisp ob ob-tangle ob-ref ob-lob ob-table ob-exp org-src ob-keys ob-comint ob-core ob-eval org-compat org-macs org-loaddefs find-func cal-menu calendar cal-loaddefs battery time linum helm-descbinds helm-mode helm-files rx image-dired tramp tramp-compat tramp-loaddefs trampver shell pcomplete format-spec dired-x dired-aux ffap helm-buffers helm-elscreen helm-tags helm-bookmark helm-adaptive helm-info bookmark helm-locate helm-grep helm-regexp helm-plugin helm-external helm-net xml url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse auth-source gnus-util time-date mm-util mail-prsvr password-cache url-vars mailcap helm-utils helm-help helm-types helm helm-source eieio eieio-core helm-multi-match helm-lib dired helm-config helm-easymenu cl-macs gv async-bytecomp async edit-server company-quickhelp pos-tip slime-company company pcase byte-opt slime-fancy slime-trace-dialog slime-fontifying-fu slime-package-fu slime-references slime-compiler-notes-tree advice slime-scratch slime-presentations bridge slime-macrostep macrostep slime-mdot-fu slime-enclosing-context slime-fuzzy slime-fancy-trace slime-fancy-inspector slime-c-p-c slime-editing-commands slime-autodoc eldoc help-fns slime-repl slime-parse bytecomp byte-compile cconv slime compile etags arc-mode archive-mode noutline outline easy-mmode pp comint ansi-color hyperspec thingatpt browse-url cus-edit cus-start cus-load wid-edit cl-extra edmacro kmacro hydra ring lv cl-loaddefs cl-lib tex-site slime-autoloads info easymenu package epg-config tooltip electric uniquify ediff-hook vc-hooks lisp-float-type mwheel x-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote make-network-process dbusbind gfilenotify dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty emacs) Memory information: ((conses 16 644748 319085) (symbols 48 56931 22) (miscs 40 9000 8309) (strings 32 145376 110188) (string-bytes 1 4061887) (vectors 16 80290) (vector-slots 8 2066368 392321) (floats 8 1407 2076) (intervals 56 10892 5139) (buffers 960 68) (heap 1024 161313 182332)) --=20 Tianxiang Xiong --001a1142947815c1b1052e5eb831 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
From: Tianxiang Xiong <tianxiang.xiong@gmail.com>
Subje= ct: 24.5.50; Elisp Manual: Appendix D.7, comment tips
Date: Fri, = 18 Mar 2016 22:46:01 -0500

<= div>


=C2=A0 =C2=A0=C2=A0
=C2=A0 =C2=A0 ;;; Main heading
=C2= =A0 =C2=A0 ;;;; Sub heading

=C2=A0 =C2=A0 Comments that start with three semicolons, = =E2=80=98;;;=E2=80=99, are considered
=C2=A0 =C2=A0 top-level hea= dings by Outline minor mode.

=C2=A0 =C2=A0 Four or= more semicolons can be used as subheadings in hierarchical
=C2= =A0 =C2=A0 fashion. E.g.

=C2=A0 =C2=A0 ;;; Main he= ading
=C2=A0 =C2=A0 ;;;; Sub heading
=C2=A0 =C2=A0 ;;;;= ; Sub sub heading
=C2=A0 =C2=A0 ;;;; Another sub heading
=C2=A0 =C2=A0 ;;; Next main heading


In GNU Emacs 24.5.50.1 (x86_64-unknown-linux-gn= u, GTK+ Version 3.14.6)
=C2=A0of 2015-12-02 on asus
Rep= ository revision: a27ae9d7650a1230d4359eaf0a949f827315a6d2
Window= ing system distributor `Fedora Project', version 11.0.11602901
System Description: Fed= ora release 21 (Twenty One)

Important settings:
=C2=A0 value of $LANG: en_US.utf8
=C2=A0 value of $XMODIF= IERS: @im=3Dibus
=C2=A0 locale-coding-system: utf-8-unix

Major mode: Org

Minor modes in ef= fect:
=C2=A0 flyspell-mode: t
=C2=A0 recentf-mode: t
=C2=A0 yas-global-mode: t
=C2=A0 yas-minor-mode: t
<= div>=C2=A0 show-smartparens-global-mode: t
=C2=A0 show-smartparen= s-mode: t
=C2=A0 smartparens-global-mode: t
=C2=A0 smar= tparens-mode: t
=C2=A0 projectile-global-mode: t
=C2=A0= projectile-mode: t
=C2=A0 popwin-mode: t
=C2=A0 pdf-oc= cur-global-minor-mode: t
=C2=A0 global-page-break-lines-mode: t
=C2=A0 page-break-lines-mode: t
=C2=A0 display-battery-m= ode: t
=C2=A0 display-time-mode: t
=C2=A0 global-linum-= mode: t
=C2=A0 linum-mode: t
=C2=A0 helm-descbinds-mode= : t
=C2=A0 helm-mode: t
=C2=A0 shell-dirtrack-mode: t
=C2=A0 async-bytecomp-package-mode: t
=C2=A0 global-edit= -server-edit-mode: t
=C2=A0 company-quickhelp-mode: t
= =C2=A0 global-company-mode: t
=C2=A0 company-mode: t
= =C2=A0 tooltip-mode: t
=C2=A0 electric-indent-mode: t
= =C2=A0 mouse-wheel-mode: t
=C2=A0 global-prettify-symbols-mode: t=
=C2=A0 menu-bar-mode: t
=C2=A0 file-name-shadow-mode: = t
=C2=A0 global-font-lock-mode: t
=C2=A0 font-lock-mode= : t
=C2=A0 auto-composition-mode: t
=C2=A0 auto-encrypt= ion-mode: t
=C2=A0 auto-compression-mode: t
=C2=A0 colu= mn-number-mode: t
=C2=A0 line-number-mode: t
=C2=A0 vis= ual-line-mode: t
=C2=A0 transient-mark-mode: t

Recent messages:
[yas] Loading for `html-mode', just-i= n-time: (lambda nil (yas--load-directory-1 (quote /home/txx/.emacs.d/elpa/y= asnippet-20160226.1359/snippets/html-mode) (quote html-mode)))!
[= yas] Loading snippet files from /home/txx/.emacs.d/elpa/yasnippet-20160226.= 1359/snippets/html-mode
[yas] Loading for `html-mode', just-i= n-time: (lambda nil (yas--load-directory-1 (quote /home/txx/.emacs.d/snippe= ts/html-mode) (quote html-mode)))!
[yas] Loading snippet files fr= om /home/txx/.emacs.d/snippets/html-mode
[yas] Loading for `nxml-= mode', just-in-time: (lambda nil (yas--load-directory-1 (quote /home/tx= x/.emacs.d/elpa/yasnippet-20160226.1359/snippets/nxml-mode) (quote nxml-mod= e)))!
[yas] Loading snippet files from /home/txx/.emacs.d/elpa/ya= snippet-20160226.1359/snippets/nxml-mode
<mouse-7> is undef= ined
byte-code: Beginning of buffer [11 times]
Search f= ailed. No matching tag found. [4 times]
(No changes need to be sa= ved)
Quit

Load-path shadows:
/= home/txx/.emacs.d/elpa/helm-20160303.1125/helm-multi-match hides /home/txx/= .emacs.d/elpa/helm-core-20160303.1321/helm-multi-match

=
Features:
(shadow sort emacsbug message rfc822 mml mml-sec m= m-decode mm-bodies
mm-encode mailabbrev gmm-utils mailheader send= mail mail-utils
semantic/find helm-semantic helm-imenu smartparen= s-html sgml-mode
emmet-mode rainbow-mode color css-mode smie whit= espace helm-command
mail-extr macrostep-c subr-x cmacexp cc-langs= cc-mode cc-fonts cc-guess
cc-menus cc-cmds cc-styles cc-align cc= -engine cc-vars cc-defs ido
helm-pages eieio-opt speedbar sb-imag= e ezimage dframe helm-elisp
helm-eval edebug tabify vc-git flyspe= ll ispell org-element org-rmail
org-mhe org-irc org-info org-gnus= org-docview doc-view org-bibtex bibtex
org-bbdb org-w3m recentf = tree-widget network-stream starttls image-file
winner server disp= -table company-oddmuse company-keywords company-etags
company-gta= gs company-dabbrev-code company-dabbrev company-files
company-cap= f company-cmake company-xcode company-clang company-semantic
comp= any-eclim company-template company-css company-nxml company-bbdb
= company-tern s ucs-normalize dash-functional tern url-http tls url-auth
mail-parse rfc2231 rfc2047 rfc2045 ietf-drums url-gw json yasnippet<= /div>
help-mode cl zenburn-theme smartparens-config smartparens
helm-projectile projectile grep dash popwin pdf-occur ibuf-ext ibuffer
tablist tablist-filter semantic/wisent/comp semantic/wisent
<= div>semantic/wisent/wisent semantic/util-modes semantic/util semantic
=
semantic/tag semantic/lex semantic/fw mode-local cedet pdf-isearch
let-alist pdf-misc imenu pdf-tools pdf-view mule-util jka-compr
pdf-cache pdf-info tq pdf-util image-mode page-break-lines toc-org er= t
ewoc debug ob-scheme ob-lisp ob-clojure org org-macro org-footn= ote
org-pcomplete org-list org-faces org-entities org-version ob-= emacs-lisp
ob ob-tangle ob-ref ob-lob ob-table ob-exp org-src ob-= keys ob-comint
ob-core ob-eval org-compat org-macs org-loaddefs f= ind-func cal-menu
calendar cal-loaddefs battery time linum helm-d= escbinds helm-mode
helm-files rx image-dired tramp tramp-compat t= ramp-loaddefs trampver
shell pcomplete format-spec dired-x dired-= aux ffap helm-buffers
helm-elscreen helm-tags helm-bookmark helm-= adaptive helm-info bookmark
helm-locate helm-grep helm-regexp hel= m-plugin helm-external helm-net xml
url url-proxy url-privacy url= -expand url-methods url-history url-cookie
url-domsuf url-util ur= l-parse auth-source gnus-util time-date mm-util
mail-prsvr passwo= rd-cache url-vars mailcap helm-utils helm-help
helm-types helm he= lm-source eieio eieio-core helm-multi-match helm-lib
dired helm-c= onfig helm-easymenu cl-macs gv async-bytecomp async
edit-server c= ompany-quickhelp pos-tip slime-company company pcase
byte-opt sli= me-fancy slime-trace-dialog slime-fontifying-fu
slime-package-fu = slime-references slime-compiler-notes-tree advice
slime-scratch s= lime-presentations bridge slime-macrostep macrostep
slime-mdot-fu= slime-enclosing-context slime-fuzzy slime-fancy-trace
slime-fanc= y-inspector slime-c-p-c slime-editing-commands slime-autodoc
eldo= c help-fns slime-repl slime-parse bytecomp byte-compile cconv slime
compile etags arc-mode archive-mode noutline outline easy-mmode pp
=
comint ansi-color hyperspec thingatpt browse-url cus-edit cus-start
cus-load wid-edit cl-extra edmacro kmacro hydra ring lv cl-loaddefs=
cl-lib tex-site slime-autoloads info easymenu package epg-config= tooltip
electric uniquify ediff-hook vc-hooks lisp-float-type mw= heel x-win x-dnd
tool-bar dnd fontset image regexp-opt fringe tab= ulated-list newcomment
lisp-mode prog-mode register page menu-bar= rfn-eshadow timer select
scroll-bar mouse jit-lock font-lock syn= tax facemenu font-core frame cham
georgian utf-8-lang misc-lang v= ietnamese tibetan thai tai-viet lao
korean japanese hebrew greek = romanian slovak czech european ethiopic
indian cyrillic chinese c= ase-table epa-hook jka-cmpr-hook help simple
abbrev minibuffer na= dvice loaddefs button faces cus-face macroexp files
text-properti= es overlay sha1 md5 base64 format env code-pages mule
custom widg= et hashtable-print-readable backquote make-network-process
dbusbi= nd gfilenotify dynamic-setting system-font-setting
font-render-se= tting move-toolbar gtk x-toolkit x multi-tty emacs)

Memory information:
((conses 16 644748 319085)
=C2=A0= (symbols 48 56931 22)
=C2=A0(miscs 40 9000 8309)
=C2=A0= (strings 32 145376 110188)
=C2=A0(string-bytes 1 4061887)
=C2=A0(vectors 16 80290)
=C2=A0(vector-slots 8 2066368 392321)=
=C2=A0(floats 8 1407 2076)
=C2=A0(intervals 56 10892 5= 139)
=C2=A0(buffers 960 68)
=C2=A0(heap 1024 161313 182= 332))

--=C2=A0
Tianxiang Xiong

--001a1142947815c1b1052e5eb831-- From unknown Thu Aug 21 12:12:12 2025 X-Loop: help-debbugs@gnu.org Subject: bug#23060: Elisp Manual: Appendix D.7, comment tips Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 29 Jul 2019 12:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 23060 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Tianxiang Xiong Cc: 23060@debbugs.gnu.org Received: via spool by 23060-submit@debbugs.gnu.org id=B23060.156440445419954 (code B ref 23060); Mon, 29 Jul 2019 12:48:02 +0000 Received: (at 23060) by debbugs.gnu.org; 29 Jul 2019 12:47:34 +0000 Received: from localhost ([127.0.0.1]:47788 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs53t-0005Bm-MA for submit@debbugs.gnu.org; Mon, 29 Jul 2019 08:47:33 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42796) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs53r-0005Ba-C5 for 23060@debbugs.gnu.org; Mon, 29 Jul 2019 08:47:32 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hs53n-00020F-GP; Mon, 29 Jul 2019 14:47:29 +0200 From: Lars Ingebrigtsen References: Date: Mon, 29 Jul 2019 14:47:27 +0200 In-Reply-To: (Tianxiang Xiong's message of "Fri, 18 Mar 2016 22:47:13 -0500") Message-ID: <87sgqp80tc.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Tianxiang Xiong writes: > For triple semicolons, the manual says: > > Comments that start with three semicolons, =?UTF-8?Q?=E2=80=98;;;=E2=80=99,?= should start at > the left margin. We use them for comments which should be considered > a =?UTF-8?Q?=E2=80=9Cheadin?= [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Tianxiang Xiong writes: > For triple semicolons, the manual says: > > Comments that start with three semicolons, =E2=80=98;;;=E2=80=99, sho= uld start at > the left margin. We use them for comments which should be considered > a =E2=80=9Cheading=E2=80=9D by Outline minor mode. > > For quadruple semicolons, the manual says: > > Comments that start with four semicolons, =E2=80=98;;;;=E2=80=99, sho= uld be aligned > to the left margin and are used for headings of major sections of a > program. For example: >=20=20=20=20=20 > ;;;; The kill ring > > This does not make clear what the difference between the two are. (I'm going through old Emacs bug reports that haven't received any response.) I've now added some clarification to the manual in Emacs 27 on this point. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 29 08:47:38 2019 Received: (at control) by debbugs.gnu.org; 29 Jul 2019 12:47:38 +0000 Received: from localhost ([127.0.0.1]:47791 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs53x-0005C3-W7 for submit@debbugs.gnu.org; Mon, 29 Jul 2019 08:47:38 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42810) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs53v-0005Bv-SW for control@debbugs.gnu.org; Mon, 29 Jul 2019 08:47:36 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hs53t-00020M-7x for control@debbugs.gnu.org; Mon, 29 Jul 2019 14:47:35 +0200 Date: Mon, 29 Jul 2019 14:47:32 +0200 Message-Id: <87r26980t7.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #23060 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 23060 fixed close 23060 27.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 23060 fixed close 23060 27.1 quit