From debbugs-submit-bounces@debbugs.gnu.org Wed Dec 13 19:11:03 2023 Received: (at submit) by debbugs.gnu.org; 14 Dec 2023 00:11:03 +0000 Received: from localhost ([127.0.0.1]:59873 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDZJd-0007Cf-Ta for submit@debbugs.gnu.org; Wed, 13 Dec 2023 19:11:03 -0500 Received: from lists.gnu.org ([2001:470:142::17]:49964) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDZJc-0007CK-CE for submit@debbugs.gnu.org; Wed, 13 Dec 2023 19:11:01 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rDZJE-00012x-Ic for bug-gnu-emacs@gnu.org; Wed, 13 Dec 2023 19:10:38 -0500 Received: from mail-pf1-x42b.google.com ([2607:f8b0:4864:20::42b]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rDZJB-00016c-2t for bug-gnu-emacs@gnu.org; Wed, 13 Dec 2023 19:10:36 -0500 Received: by mail-pf1-x42b.google.com with SMTP id d2e1a72fcca58-6ceb27ec331so5058393b3a.1 for ; Wed, 13 Dec 2023 16:10:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702512630; x=1703117430; darn=gnu.org; h=mime-version:message-id:date:subject:to:from:from:to:cc:subject :date:message-id:reply-to; bh=EN6OOeF8ZM6E4Vno5Y6Lx3k17pLVY29fyh3FF6i/vPU=; b=NmSc0wYLJ7i2cj/5ia+IQ1By+HnhvUfizGfsNMRdga2B0JyXEpfsx9dYWXsTCiQGx7 gj5kkzynJprb5EOc0fG95os+wTPkeX2dlEi5dB4xMV826qXLbzfm9NqUx6yv38FmWFux shs2dmxceszY9ykrsmZNA9JKcgXuB9Icjld5Vo1+6+Rig7dSJ6TWQih6u8WRaOYvzUl+ 5Je7EV0qIgpvYDd08iVsihOJ0z8JDLxyJoxR1wt6+WTB3f/L3rfLVTUsBsnxKbQOolBU Xsj0mz7aVn7/x5dfIrVpL3VUV3BSQGWOWCIaGqj4DDHal2mzSIUxbesCBxo2AIz+ue6W Cfhg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702512630; x=1703117430; h=mime-version:message-id:date:subject:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=EN6OOeF8ZM6E4Vno5Y6Lx3k17pLVY29fyh3FF6i/vPU=; b=hIGGvx5QiqU+dG5d/6Rxcyi+nAmlTlV7UAz/hKHmn5ZKPUzBtjEAT3uX3Ef6oyGFno aZd8ybhqICGjSuRmxUkZeeZtHl1RsaOf5Qxz12g+k2/8gs8YBo0E2ZPPFSMAaSFC9aWg /DhbVMYe72BUBDwtwUjG4L8f2xmJeyeMVwtquRHl1GRln4OANuHaM/ysPlSBaBhvv29u b6gB18Awdqu+pgopr7KimZz+b40KeY/yAqGT5BGDMgA4HBki3OYCBkHF3ShrMAnvNJhu pZ4Imr6xwNAfl7mxAg0YY6eriYt6+IKclkjJbjULrKumhhzrvdFeI3Hq2l3YtMUixe1B hGJw== X-Gm-Message-State: AOJu0YwfaHdt1wytJ//DlGN4wcupzxoMdS3QUOI91FRWPpbGG9x4iSFI 7wSZPvC5J/79E/aXUK0CNVGqcxGUsd4= X-Google-Smtp-Source: AGHT+IF5t/ZJMA+VyQQ1C75WyjaPhWP68xN7fqnhAv1TM7bPFMPRhzwR5AnSlB0WdwS96XpaxBLzwg== X-Received: by 2002:a05:6a00:1304:b0:6d0:8595:ab0c with SMTP id j4-20020a056a00130400b006d08595ab0cmr3782530pfu.52.1702512629244; Wed, 13 Dec 2023 16:10:29 -0800 (PST) Received: from debian-hx90 (2603-8000-a400-0cdc-a140-91c8-a663-be4a.res6.spectrum.com. [2603:8000:a400:cdc:a140:91c8:a663:be4a]) by smtp.gmail.com with ESMTPSA id x3-20020a056a000bc300b006cea17d08ebsm10515392pfu.120.2023.12.13.16.10.28 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Dec 2023 16:10:28 -0800 (PST) From: Xiyue Deng To: bug-gnu-emacs@gnu.org Subject: 29.1; The "let*" subsection in "forward-paragraph" has no code sample Date: Wed, 13 Dec 2023 16:10:26 -0800 Message-ID: <87h6klabkd.fsf@debian-hx90.lan> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::42b; envelope-from=manphiz@gmail.com; helo=mail-pf1-x42b.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit 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: -0.0 (/) When reading "The `let*' expression" section of "forward-paragraph"[1], the text describes the whole inner work of the `let*' expression for each defined variable in details, only that there is no corresponding code to show what is actually written. It feels kinda like a presenter is pointing to an empty slide that seems to have something only the presenter can see. Looking at the source code, the source of the whole forward-paragraph function was included in the beginning of the section but ignored[2]. For other subsections excerpts of the corresponding parts of the source code being discussed were included. Of course, at the end of the chapter the author gave instructions to navigate to the whole source code, but I wonder whether sample code should be included in this section so that the readers can have something to look at immediately. I'll include a tentative patch next. [1] https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/lispintro/emacs-lisp-intro.texi#n12877 [2] https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/lispintro/emacs-lisp-intro.texi#n12657 In GNU Emacs 29.1 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.37, cairo version 1.16.0) of 2023-09-19, modified by Debian built on debian-hx90 System Description: Debian GNU/Linux 12 (bookworm) Configured using: 'configure --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/libexec --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-libsystemd --with-pop=yes --enable-locallisppath=/etc/emacs:/usr/local/share/emacs/29.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/29.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --without-gconf --with-mailutils --with-native-compilation --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/libexec --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-libsystemd --with-pop=yes --enable-locallisppath=/etc/emacs:/usr/local/share/emacs/29.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/29.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --without-gconf --with-mailutils --with-native-compilation --with-cairo --with-x=yes --with-x-toolkit=gtk3 --with-toolkit-scroll-bars 'CFLAGS=-g -O2 -ffile-prefix-map=/build/emacs-bYKTEl/emacs-29.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG JSON LCMS2 LIBOTF LIBSELINUX LIBSYSTEMD LIBXML2 M17N_FLT MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS TREE_SITTER WEBP X11 XDBE XIM XINPUT2 XPM GTK3 ZLIB Important settings: value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: VTerm Minor modes in effect: TeX-PDF-mode: t global-git-commit-mode: t magit-auto-revert-mode: t shell-dirtrack-mode: t windmove-mode: t rcirc-track-minor-mode: t server-mode: t global-company-mode: t company-mode: t icomplete-mode: t fido-mode: t override-global-mode: t global-display-line-numbers-mode: t display-line-numbers-mode: t global-auto-revert-mode: t tooltip-mode: t global-eldoc-mode: t show-paren-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t tab-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t buffer-read-only: t column-number-mode: t line-number-mode: t transient-mark-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t Load-path shadows: /usr/share/emacs/site-lisp/elpa/debian-el-37.11/debian-el-autoloads hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/debian-el-autoloads /usr/share/emacs/site-lisp/elpa/debian-el-37.11/apt-sources hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/apt-sources /usr/share/emacs/site-lisp/elpa/debian-el-37.11/debian-bug hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/debian-bug /usr/share/emacs/site-lisp/elpa/debian-el-37.11/apt-utils hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/apt-utils /usr/share/emacs/site-lisp/elpa/debian-el-37.11/debian-el-pkg hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/debian-el-pkg /usr/share/emacs/site-lisp/elpa/debian-el-37.11/gnus-BTS hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/gnus-BTS /usr/share/emacs/site-lisp/elpa/debian-el-37.11/deb-view hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/deb-view /usr/share/emacs/site-lisp/elpa/debian-el-37.11/debian-el hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/debian-el /usr/share/emacs/site-lisp/elpa/debian-el-37.11/preseed hides /usr/share/emacs/site-lisp/elpa-src/debian-el-37.11/preseed /usr/share/emacs/site-lisp/elpa/devscripts-40/devscripts hides /usr/share/emacs/site-lisp/elpa-src/devscripts-40/devscripts /usr/share/emacs/site-lisp/elpa/devscripts-40/devscripts-autoloads hides /usr/share/emacs/site-lisp/elpa-src/devscripts-40/devscripts-autoloads /usr/share/emacs/site-lisp/elpa/devscripts-40/pbuilder-mode hides /usr/share/emacs/site-lisp/elpa-src/devscripts-40/pbuilder-mode /usr/share/emacs/site-lisp/elpa/devscripts-40/devscripts-pkg hides /usr/share/emacs/site-lisp/elpa-src/devscripts-40/devscripts-pkg /usr/share/emacs/site-lisp/elpa/devscripts-40/pbuilder-log-view-mode hides /usr/share/emacs/site-lisp/elpa-src/devscripts-40/pbuilder-log-view-mode /usr/share/emacs/site-lisp/elpa/dockerfile-mode-1.7/dockerfile-mode hides /usr/share/emacs/site-lisp/elpa-src/dockerfile-mode-1.7/dockerfile-mode /usr/share/emacs/site-lisp/elpa/dockerfile-mode-1.7/dockerfile-mode-autoloads hides /usr/share/emacs/site-lisp/elpa-src/dockerfile-mode-1.7/dockerfile-mode-autoloads /usr/share/emacs/site-lisp/elpa/dockerfile-mode-1.7/dockerfile-mode-pkg hides /usr/share/emacs/site-lisp/elpa-src/dockerfile-mode-1.7/dockerfile-mode-pkg /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/debian-bts-control hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/debian-bts-control /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/debian-changelog-mode hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/debian-changelog-mode /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/dpkg-dev-el-autoloads hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/dpkg-dev-el-autoloads /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/dpkg-dev-el-pkg hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/dpkg-dev-el-pkg /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/dpkg-dev-el hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/dpkg-dev-el /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/debian-control-mode hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/debian-control-mode /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/debian-copyright hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/debian-copyright /usr/share/emacs/site-lisp/elpa/dpkg-dev-el-37.10/readme-debian hides /usr/share/emacs/site-lisp/elpa-src/dpkg-dev-el-37.10/readme-debian /usr/share/emacs/site-lisp/elpa/lintian-0.1/lintian-pkg hides /usr/share/emacs/site-lisp/elpa-src/lintian-0.1/lintian-pkg /usr/share/emacs/site-lisp/elpa/lintian-0.1/lintian-autoloads hides /usr/share/emacs/site-lisp/elpa-src/lintian-0.1/lintian-autoloads /usr/share/emacs/site-lisp/elpa/lintian-0.1/lintian hides /usr/share/emacs/site-lisp/elpa-src/lintian-0.1/lintian /usr/share/emacs/site-lisp/elpa/po-mode-0.21/po-mode-pkg hides /usr/share/emacs/site-lisp/elpa-src/po-mode-0.21/po-mode-pkg /usr/share/emacs/site-lisp/elpa/po-mode-0.21/po-mode-autoloads hides /usr/share/emacs/site-lisp/elpa-src/po-mode-0.21/po-mode-autoloads /usr/share/emacs/site-lisp/elpa/po-mode-0.21/po-mode hides /usr/share/emacs/site-lisp/elpa-src/po-mode-0.21/po-mode /usr/share/emacs/site-lisp/elpa/py-isort-2016.1/py-isort hides /usr/share/emacs/site-lisp/elpa-src/py-isort-2016.1/py-isort /usr/share/emacs/site-lisp/elpa/py-isort-2016.1/py-isort-autoloads hides /usr/share/emacs/site-lisp/elpa-src/py-isort-2016.1/py-isort-autoloads /usr/share/emacs/site-lisp/elpa/py-isort-2016.1/py-isort-pkg hides /usr/share/emacs/site-lisp/elpa-src/py-isort-2016.1/py-isort-pkg /home/xiyueden/.config/emacs/elpa/transient-0.5.2/transient hides /usr/share/emacs/29.1/lisp/transient Features: (shadow git-rebase ediff ediff-merg ediff-mult ediff-wind ediff-diff ediff-help ediff-init ediff-util novice emacsbug vterm magit-bookmark bookmark tramp tramp-loaddefs trampver tramp-integration files-x tramp-compat term ehelp vterm-module rect goto-addr misearch multi-isearch tex-info tex texmathp texinfo texinfo-loaddefs dired-aux shortdoc help-fns radix-tree url-http url-gw url-auth url-queue url-cache magit-extras face-remap magit-submodule magit-obsolete magit-blame magit-stash magit-reflog magit-bisect magit-push magit-pull magit-fetch magit-clone magit-remote magit-commit magit-sequence magit-notes magit-worktree magit-tag magit-merge magit-branch magit-reset magit-files magit-refs magit-status magit magit-repos magit-apply magit-wip magit-log which-func magit-diff git-commit log-edit add-log magit-core magit-autorevert magit-margin magit-transient magit-process with-editor shell pcomplete magit-mode transient edmacro kmacro compat format-spec magit-git magit-section eglot external-completion array jsonrpc ert ewoc debug backtrace find-func imenu smerge-mode diff magit-utils crm dash mule-util jka-compr shr-color qp sort gnus-cite flow-fill matlab matlab-scan matlab-syntax matlab-compat pulse color mm-archive mail-extr textsec uni-scripts idna-mapping ucs-normalize uni-confusable textsec-check gnus-async gnus-bcklg gnus-ml gnus-topic cursor-sensor utf-7 nnfolder gnus-demon nnml ezgnus gnus-delay gnus-draft gnus-agent gnus-srvr gnus-score score-mode nnvirtual nntp gnus-cache gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig gnus-sum shr pixel-fill kinsoku url-file svg dom nndraft nnmh gnus-group gnus-undo smtpmail gnus-start gnus-dbus dbus xml gnus-cloud nnimap nnmail mail-source utf7 nnoo gnus-spec gnus-int gnus-range message sendmail yank-media dired dired-loaddefs rfc822 mml mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mailabbrev gmm-utils mailheader gnus-win gnus nnheader gnus-util mail-utils range mm-util mail-prsvr windmove flyspell ispell gnutls network-stream puny nsm epa-file epa derived epg rfc6068 epg-config rcirc parse-time iso8601 time-date term/xterm xterm comp comp-cstr rx server cap-words superword subword vc-hg vc-git diff-mode vc-bzr vc-src vc-sccs vc-svn vc-cvs vc-rcs log-view pcvs-util vc vc-dispatcher bug-reference disp-table whitespace yasnippet cus-edit pp cus-start wid-edit company-oddmuse company-keywords company-etags etags fileloop generator xref company-gtags company-dabbrev-code company-dabbrev company-files company-clang company-capf company-cmake company-semantic company-template company-bbdb company pcase init zenburn-theme keychain-environment exec-path-from-shell icomplete cus-load flymake-proc flymake project compile text-property-search comint ansi-osc ansi-color ring warnings icons thingatpt advice cl-extra help-mode use-package use-package-ensure use-package-delight use-package-diminish use-package-bind-key bind-key easy-mmode use-package-core display-line-numbers autorevert filenotify apache-mode-autoloads auctex-autoloads tex-site bison-mode-autoloads boxquote-autoloads cargo-autoloads cmake-mode-autoloads company-autoloads csv-mode-autoloads dart-mode-autoloads exec-path-from-shell-autoloads flutter-autoloads format-all-autoloads git-modes-autoloads gnuplot-autoloads go-mode-autoloads graphviz-dot-mode-autoloads inheritenv-autoloads keychain-environment-autoloads language-id-autoloads magit-autoloads git-commit-autoloads magit-section-autoloads dash-autoloads matlab-mode-autoloads meson-mode-autoloads nginx-mode-autoloads pyvenv-autoloads rust-mode-autoloads scala-mode-autoloads transient-autoloads vterm-autoloads with-editor-autoloads compat-autoloads xclip-autoloads yaml-mode-autoloads yasnippet-autoloads zenburn-theme-autoloads info debian-el-autoloads dpkg-dev-el-autoloads package browse-url url url-proxy url-privacy url-expand url-methods url-history url-cookie generate-lisp-file url-domsuf url-util mailcap url-handlers url-parse auth-source cl-seq eieio eieio-core cl-macs password-cache json subr-x map byte-opt gv bytecomp byte-compile url-vars cl-loaddefs cl-lib rmc iso-transl tooltip cconv eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type elisp-mode mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax font-core term/tty-colors frame minibuffer nadvice seq simple cl-generic indonesian philippine cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite emoji-zwj charscript charprop case-table epa-hook jka-cmpr-hook help abbrev obarray oclosure cl-preloaded button loaddefs theme-loaddefs faces cus-face macroexp files window text-properties overlay sha1 md5 base64 format env code-pages mule custom widget keymap hashtable-print-readable backquote threads dbusbind inotify lcms2 dynamic-setting system-font-setting font-render-setting cairo move-toolbar gtk x-toolkit xinput2 x multi-tty make-network-process native-compile emacs) Memory information: ((conses 16 1563482 586564) (symbols 48 36376 3) (strings 32 154684 18513) (string-bytes 1 4577790) (vectors 16 93290) (vector-slots 8 2017433 97833) (floats 8 656 2922) (intervals 56 63424 6342) (buffers 984 71)) From debbugs-submit-bounces@debbugs.gnu.org Wed Dec 13 19:19:47 2023 Received: (at 67817) by debbugs.gnu.org; 14 Dec 2023 00:19:47 +0000 Received: from localhost ([127.0.0.1]:59879 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDZS7-0007Q1-1b for submit@debbugs.gnu.org; Wed, 13 Dec 2023 19:19:47 -0500 Received: from mail-pf1-x42f.google.com ([2607:f8b0:4864:20::42f]:42061) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDZS1-0007Pk-6y for 67817@debbugs.gnu.org; Wed, 13 Dec 2023 19:19:45 -0500 Received: by mail-pf1-x42f.google.com with SMTP id d2e1a72fcca58-6ceb93fb381so82668b3a.0 for <67817@debbugs.gnu.org>; Wed, 13 Dec 2023 16:19:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702513159; x=1703117959; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:to:from:from:to:cc:subject:date:message-id:reply-to; bh=QDoIM7OuxYgXRM3X1nI+3aATcvctCn0QRl19bSkd7hs=; b=KYYxco9EJs2VLdSsy8hiQDedjqaKqGbmJRO3yKAfa5Ld5MKTPI2uwG+Y+62glTWmdI S3wjJk3Ir+jx9CsGOd8UoTDBiK37esmC+1uq3HqE/IjtBYP17XSHXPVTz4Cn0+IQteGb dq9+dBZy/ZEUb47N6bLsKWcE9lEPaYw6VoI4ft98PaAVAsfK98McqseTcIJ4ms94ifxg jnaeS1L0y/CRwvN+cuSIjC8VOxen4XbW0kYrYXh/qzf4CxU9O6OLVOh4yX9zWsRzq7Ei wAEHUUgE9/RhffDUxDc09dyoL0B1dwzYleIEFDWez1NSKqdScJY+uw7bjzGXmrDz5TUe vFBg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702513159; x=1703117959; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=QDoIM7OuxYgXRM3X1nI+3aATcvctCn0QRl19bSkd7hs=; b=Ts24r16sZts31dEO/YBYYQHyeY6av4/v9C5kmIss99pgnoa0iOo6fOxenxEPAR+n/8 TSYvuw19LTqo193lo/0bfAJxd/Os60NDNRTqE57ryeNtdMQ46FS7H8GIJloq2zk/eLIp iPOH9FZEFyORnISjwRJQfOCZ9vtiKdhRdWigAxy/45DlLUymN2/WLsxPH1U5M94ih+aQ 3gds/hPHzjvEb3UB6eE4xpmCdkScQ852F5GZbJXdlkpdJBvIXZfsazHwS47RXWSc2Ks6 QyTX6EgJBt9ho5IG3wtTTSlkRVEv2OXnzDBNN3jaECDD7m8/PkJXs0XutrxpyAWyPN8/ wImw== X-Gm-Message-State: AOJu0YwF0K2rhep7iDFUfmVhR7guY2MOQbgpGy8A/mz0Bs+EOw+gmNZS UndRP8xYC4pwh6FRlF4BwBXy1Z6OzSs= X-Google-Smtp-Source: AGHT+IG6yWcF1O6GeE7D/2GiHIq/6sFFq0UD6yRmapgVqcDbqtD77MO1B/OgW4C8h7f/ktWe0lR6wA== X-Received: by 2002:a05:6a00:464b:b0:68f:a92a:8509 with SMTP id kp11-20020a056a00464b00b0068fa92a8509mr13228697pfb.7.1702513158522; Wed, 13 Dec 2023 16:19:18 -0800 (PST) Received: from debian-hx90 (2603-8000-a400-0cdc-a140-91c8-a663-be4a.res6.spectrum.com. [2603:8000:a400:cdc:a140:91c8:a663:be4a]) by smtp.gmail.com with ESMTPSA id v10-20020a65568a000000b005bd3f34b10dsm9028983pgs.24.2023.12.13.16.19.17 for <67817@debbugs.gnu.org> (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Dec 2023 16:19:18 -0800 (PST) From: Xiyue Deng To: 67817@debbugs.gnu.org Subject: Re: bug#67817: Acknowledgement (29.1; The "let*" subsection in "forward-paragraph" has no code sample) In-Reply-To: (GNU bug Tracking System's message of "Thu, 14 Dec 2023 00:12:02 +0000") References: <87h6klabkd.fsf@debian-hx90.lan> Date: Wed, 13 Dec 2023 16:19:17 -0800 Message-ID: <87a5qdab5m.fsf@debian-hx90.lan> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 67817 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 (-) --=-=-= Content-Type: text/plain Tentative patch to add sample code attached. --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Add-sample-code-to-the-let-section-in-forward-paragr.patch >From 11f6cc8d1caac44cdda9588617cbd302d2ab35b5 Mon Sep 17 00:00:00 2001 From: Xiyue Deng Date: Wed, 13 Dec 2023 13:38:55 -0800 Subject: [PATCH] Add sample code to the "let*" section in "forward-paragraph" (bug#67817) * doc/lispintro/emacs-lisp-intro.texi (fwd-para let): add code sample. --- doc/lispintro/emacs-lisp-intro.texi | 35 ++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index eb8ff413b79..29309502c90 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -12882,7 +12882,40 @@ The next line of the @code{forward-paragraph} function begins a introduced}), in which Emacs binds a total of seven variables: @code{opoint}, @code{fill-prefix-regexp}, @code{parstart}, @code{parsep}, @code{sp-parstart}, @code{start}, and -@code{found-start}. +@code{found-start}. The first part of the @code{let*} expression +looks like below: + +@smallexample +@group +(let* ((opoint (point)) + (fill-prefix-regexp + (and fill-prefix (not (equal fill-prefix "")) + (not paragraph-ignore-fill-prefix) + (regexp-quote fill-prefix))) + ;; Remove ^ from paragraph-start and paragraph-sep if they are there. + ;; These regexps shouldn't be anchored, because we look for them + ;; starting at the left-margin. This allows paragraph commands to + ;; work normally with indented text. + ;; This hack will not find problem cases like "whatever\\|^something". + (parstart (if (and (not (equal "" paragraph-start)) + (equal ?^ (aref paragraph-start 0))) + (substring paragraph-start 1) + paragraph-start)) + (parsep (if (and (not (equal "" paragraph-separate)) + (equal ?^ (aref paragraph-separate 0))) + (substring paragraph-separate 1) + paragraph-separate)) + (parsep + (if fill-prefix-regexp + (concat parsep "\\|" + fill-prefix-regexp "[ \t]*$") + parsep)) + ;; This is used for searching. + (sp-parstart (concat "^[ \t]*\\(?:" parstart "\\|" parsep "\\)")) + start found-start) + ...) +@end group +@end smallexample The variable @code{parsep} appears twice, first, to remove instances of @samp{^}, and second, to handle fill prefixes. -- 2.39.2 --=-=-= Content-Type: text/plain -- Xiyue Deng --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Thu Dec 14 15:39:50 2023 Received: (at control) by debbugs.gnu.org; 14 Dec 2023 20:39:50 +0000 Received: from localhost ([127.0.0.1]:51033 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDsUo-0007PB-Gq for submit@debbugs.gnu.org; Thu, 14 Dec 2023 15:39:50 -0500 Received: from mail-lj1-x232.google.com ([2a00:1450:4864:20::232]:49290) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rDsUn-0007Oy-Cv for control@debbugs.gnu.org; Thu, 14 Dec 2023 15:39:49 -0500 Received: by mail-lj1-x232.google.com with SMTP id 38308e7fff4ca-2cc3f5e7451so22251941fa.2 for ; Thu, 14 Dec 2023 12:39:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702586384; x=1703191184; darn=debbugs.gnu.org; h=to:subject:message-id:date:mime-version:from:from:to:cc:subject :date:message-id:reply-to; bh=zyi5kocZjiUxjGkf8MEMX91hTpU91lA/yYKG7eheBG8=; b=ZsccFcNtw9uXXoCUrJmHq5RjzvHVtTK7zBqBvBrQiQuMYnAnGC1TpmFjZsr9kwtPTr tmSCjxqtx/EY4wF5aOkQPpq/Mmk75FREYOQa+8Wm6eE2tmkjyFfh5rBPS925MpiUzLJJ ivokBf/GVx8NGBKXTTiKcFep+tD037q6PDKyP7Fh7Cin31FtUlHcGdZOh9f4BGgll3ZP 4Fh53YQhC0nSOv9fWxytftjYrDFdeROJB3zxPibXE9EhgzJ+vmb25suO7sRnu6iCDkGr Iw5l2edu43zaSvvMtR7RLZGDX87n9ELaS38y0fvIt7cFv8A710DBOgn1MyRF7tlJ61wI MmQg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702586384; x=1703191184; h=to:subject:message-id:date:mime-version:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=zyi5kocZjiUxjGkf8MEMX91hTpU91lA/yYKG7eheBG8=; b=G7A6Xzfg7rOGwbui+W9qTbOwqPyFu81QRr8vQ584lf9jUuaMK2K9ewfj9gPPkHytM1 uGrZkcIcRLWAKTah60lp0tL14MwaKUU3UbuKRBpsjS1r9u9k4WRc/ysYr9W/OuES1uMs Iy5+n3U8JKXBIDGft/+inUrA4PnliF7x52XojIPhuiUXcLa6aXN9chMWpithmK//oVJj iwhDNVZGHtHk5reexULsgTJw2jlkR1U1FFp/KrULCiC3kBGMM1Q414Pg+qJkVEMABX5t D1TliFeZXfcCX3uQ5q1EKO5Twnlc2h7oxQKG+Mur19sjKbHv3OmLrZ1fRE57xZu1a9Nc WCCg== X-Gm-Message-State: AOJu0YyO+xSS5uw7SD8Dt1sgK0WzOQVZAG+laXQ+pDlD/GdjRa6IJ1IC PLiYq3YTSKDyOjZmrVh3LRvH3JGc5w3R8GJ1O2XxeQ4knTQpzw== X-Google-Smtp-Source: AGHT+IHr86PRML7QSN5aK9q6IBO3euNKI2iho1EU27FQTQL99NLBDMLo9Eai0Gqkmwo469ZdMNy99X37Y+nCSdZ4Gt8= X-Received: by 2002:a05:6512:2342:b0:50b:e47f:e96f with SMTP id p2-20020a056512234200b0050be47fe96fmr6387385lfu.57.1702586383593; Thu, 14 Dec 2023 12:39:43 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 14 Dec 2023 12:39:42 -0800 From: Stefan Kangas MIME-Version: 1.0 Date: Thu, 14 Dec 2023 12:39:42 -0800 Message-ID: Subject: To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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 the administrator of that system for details. Content preview: tags 67817 + patch thanks Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (stefankangas[at]gmail.com) 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [2a00:1450:4864:20:0:0:0:232 listed in] [list.dnswl.org] 0.0 UNPARSEABLE_RELAY Informational: message has unparseable relay lines 2.0 BLANK_SUBJECT Subject is present but empty -0.0 T_SCC_BODY_TEXT_LINE No description available. 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 67817 + patch thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Dec 15 08:49:08 2023 Received: (at 67817) by debbugs.gnu.org; 15 Dec 2023 13:49:08 +0000 Received: from localhost ([127.0.0.1]:51773 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rE8Yu-00018a-0w for submit@debbugs.gnu.org; Fri, 15 Dec 2023 08:49:08 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:44506) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rE8Ys-000187-6f for 67817@debbugs.gnu.org; Fri, 15 Dec 2023 08:49:06 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rE8Yl-0008Tw-NC; Fri, 15 Dec 2023 08:49:00 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Ai42QDICHdFjQuxlaNVHTHMCks1bqDsxM/iE01C6pgA=; b=pNejpaijhsyS FgMyZCZMTZ43AqVAdaUX2OV/qn5p9urL2JeCEd/7odDJU70liX19boixLe5udZ2yteoUGVxvsuU9v BaSio9AMnQV0qb3FPHCnlLdI/RmgH205FGHa2kIquzXJELQX/r9s2rdYPGHYLTO4bviRvcFWsitLv bSpb14L3eFZlxvZAi93ax/yBIYvzkYo3Vzowu6V8W9i19REgx+ydTeGL4mi2Wo2NMJsWXFQRVjtSu 2yOyuWTQPt9ddVHS9cGOOoeip2FGJaEviyUx4LNbIosx+OrSzy5/0oxRsPTLmEH5Ng5tWUEOrmgA0 C13ZSvO/VzMcphm6i8BGsQ==; Date: Fri, 15 Dec 2023 15:48:59 +0200 Message-Id: <83v88zo9tg.fsf@gnu.org> From: Eli Zaretskii To: Xiyue Deng In-Reply-To: <87a5qdab5m.fsf@debian-hx90.lan> (message from Xiyue Deng on Wed, 13 Dec 2023 16:19:17 -0800) Subject: Re: bug#67817: Acknowledgement (29.1; The "let*" subsection in "forward-paragraph" has no code sample) References: <87h6klabkd.fsf@debian-hx90.lan> <87a5qdab5m.fsf@debian-hx90.lan> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 67817 Cc: 67817@debbugs.gnu.org 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: -3.3 (---) > From: Xiyue Deng > Date: Wed, 13 Dec 2023 16:19:17 -0800 > > Tentative patch to add sample code attached. Thanks. We need to wait for the completion of your legal paperwork before we can install this. From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 23 03:49:38 2023 Received: (at 67817-done) by debbugs.gnu.org; 23 Dec 2023 08:49:38 +0000 Received: from localhost ([127.0.0.1]:48508 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rGxhS-0002Ar-BW for submit@debbugs.gnu.org; Sat, 23 Dec 2023 03:49:38 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39766) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rGxhQ-0002Aa-N3 for 67817-done@debbugs.gnu.org; Sat, 23 Dec 2023 03:49:37 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rGxhG-0003RN-9N; Sat, 23 Dec 2023 03:49:26 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=IVk9y2gJDLLXh/rzHbt3JZC4oD9n+gN7gIgo4v0C1Uk=; b=IQJz52dXxJOD iyFXIxDZGiZEKgfrG5TR2qXkm3wB0/2XT0/hCliPEfio5vaDJNJNOWyZTBPq3n2WROM+1Z1/mBYzS 54Plc7g9ywb573jRqcT/U+U2PThtpHyMSsE6ooSWzBnYJRX4Ceq2Kqks8qAnjes2gSqfz+XPvcuDb ipwrRWraX7/BkjQq3JLc3mCoPpYx7PyV7MaLnCJRlTeCMLCPCcHawhgmg3/lr5e2xtojRgJcUlAYz HlNDn3Xu2196K/2gY2OT3qc13VKgZXOWTLCO1pDxzCRwxCg1slOeN8iC7kdD98JVYMtj0a5gMtdxR /DeZYrt+SXaUSdfrkWYW8w==; Date: Sat, 23 Dec 2023 10:49:17 +0200 Message-Id: <83y1dle22a.fsf@gnu.org> From: Eli Zaretskii To: manphiz@gmail.com In-Reply-To: <83v88zo9tg.fsf@gnu.org> (message from Eli Zaretskii on Fri, 15 Dec 2023 15:48:59 +0200) Subject: Re: bug#67817: Acknowledgement (29.1; The "let*" subsection in "forward-paragraph" has no code sample) References: <87h6klabkd.fsf@debian-hx90.lan> <87a5qdab5m.fsf@debian-hx90.lan> <83v88zo9tg.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 67817-done Cc: 67817-done@debbugs.gnu.org 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: -3.3 (---) > Cc: 67817@debbugs.gnu.org > Date: Fri, 15 Dec 2023 15:48:59 +0200 > From: Eli Zaretskii > > > From: Xiyue Deng > > Date: Wed, 13 Dec 2023 16:19:17 -0800 > > > > Tentative patch to add sample code attached. > > Thanks. We need to wait for the completion of your legal paperwork > before we can install this. Now installed on the emacs-29 branch, and closing the bug. From unknown Thu Sep 11 21:35:46 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 20 Jan 2024 12:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator