From: pillule <pillule@riseup.net>
To: 15069@debbugs.gnu.org
Cc: Sian Mountbatten <poenikatu@fastmail.co.uk>,
Stefan Kangas <stefan@marxist.se>
Subject: bug#15069: [PATCH] Bug: 15069: Correct functioning in the *scratch* buffer
Date: Fri, 21 May 2021 19:39:37 +0000 [thread overview]
Message-ID: <87bl93anba.fsf@host.localdomain> (raw)
In-Reply-To: <52077652.1050901@fastmail.co.uk>
[-- Attachment #1: Type: text/plain, Size: 316 bytes --]
Hi,
Is that correct that it is a documentation bug (need to specify to
the user to evaluate `count-words-in-defun' in eg, a *scratch*
buffer) rather than an implementation bug (fixing the behavior of
beginning-of-defun in Info-mode) ?
If so I attached a small patch there, and verified it after a
`make docs`
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: patch for the emacs-lisp introduction manual --]
[-- Type: text/x-diff, Size: 1233 bytes --]
From 22e3722320bab1f8fbfef062afc0c7f889440c9a Mon Sep 17 00:00:00 2001
From: Trust me I am a doctor <pillule@riseup.net>
Date: Fri, 21 May 2021 18:34:58 +0000
Subject: [PATCH] Clarify page 14.3 of eintr manual (bug#15069)
It has been pointed the instructions for `count-words-in-defun` are
ambiguous : One can expect to evaluate the sexp in the Info manual but
that would not work, so this commit explicit that it must be done in a
clean buffer (= with a valid syntaxe tree).
Copyright-paperwork-exempt: yes
---
doc/lispintro/emacs-lisp-intro.texi | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index fade4096e3..ba5fae4ff0 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -14650,7 +14650,8 @@ Let's re-use @kbd{C-c =} as a convenient keybinding:
Now we can try out @code{count-words-defun}: install both
@code{count-words-in-defun} and @code{count-words-defun}, and set the
-keybinding, and then place the cursor within the following definition:
+keybinding, and then place the cursor within the following definition,
+in a clean scratch buffer:
@smallexample
@group
--
2.20.1
[-- Attachment #3: Type: text/plain, Size: 481 bytes --]
I remember I especially liked to be able to evaluate sexp in place
in the eintr manual, that is fitting so well the interpreted
nature of elisp, but here the situation is out of my mind :
- 1. the norm seems to *not* use the column 0 to declare top
level sexp in Info manuals even if
`open-paren-in-column-0-is-defun-start' is set to t.
- 2. there is many opened sexp given as exemple, which will
confuse the syntaxe tree.
Have a nice day, or, night, I don't know.
--
next prev parent reply other threads:[~2021-05-21 19:39 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-08-11 11:32 bug#15069: Introduction to Elisp 14.3: Function 'count-words-defun' does not work as described Sian Mountbatten
2013-08-11 11:47 ` bug#15069: Bug: 15069: Correct functioning in the *scratch* buffer Sian Mountbatten
2021-05-21 19:39 ` pillule [this message]
2021-05-22 6:34 ` bug#15069: [PATCH] " Eli Zaretskii
2021-05-24 15:48 ` pillule
2021-08-21 13:44 ` bug#15069: Introduction to Elisp 14.3: Function 'count-words-defun' does not work as described Lars Ingebrigtsen
2021-08-30 20:02 ` Trust me I am a Doctor
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87bl93anba.fsf@host.localdomain \
--to=pillule@riseup.net \
--cc=15069@debbugs.gnu.org \
--cc=poenikatu@fastmail.co.uk \
--cc=stefan@marxist.se \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.