all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
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.
-- 

  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.