GNU logs - #54128, boring messages

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#54128: 27.2; c-paragraph-* variables not sufficiently documented
Resent-From: John Hagerman <John.Hagerman@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Wed, 23 Feb 2022 16:03:02 +0000
Resent-Message-ID: <handler.54128.B.16456321349191 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 54128 <at> debbugs.gnu.org
From: John Hagerman <John.Hagerman@HIDDEN>
Thread-Topic: 27.2; c-paragraph-* variables not sufficiently documented
Thread-Index: AdgozgF+D1XIH0QCSP6QspnkYjnuVg==
Date: Wed, 23 Feb 2022 16:01:59 +0000
Message-ID: <DM6PR12MB55504D5C2C67466B1351A0BAAC3C9@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: okDfsqZ1QWS+OEggKLs5ah0IQbyeIXNGCjaHjiZENSqdP3eWzVyXh2plSZfSRK+DWoXvUhjWRtWgrGL4oVb7jq0CIAobvH0gC2VChXBUMYZp1NuHTYeIDD6xFN902z+An0tTx/2pvqua4JHcsLbq9CT+L1knBWCUM5ZHrg5C67t5Tq9vddqWw86nBT1GqtnNASSRYwOnNvt4SSO1X/l/iw9tQQZ2w6/BefK6MMXjJpjTi4U4SZ/mANyOs+UNO4Z0lERLNmLVQiwCJwl6I7Frn+YJhSqAoEa3fsaWPuYmsh1opQWOBRiqppy/XoQJOLRh2603ZdD2LmgFJ3QWICTKDcTwCgY72dVfzURuxhXibauW0m0aCQY9rDj1ZaOlP5K4JOIXIWGd7Ioc7uJKX7ipSBXHUmsDIY7VsUfl0NvFkP4n0pla/TnW1N+Sp7G4azv1W7IUZr4dsaW6SLfhBGVgBpjaAJAhTCBB+VK7KwMkrjfOZzC3gqk/OTmyDJSr7xL3VbawG4oTO4MMwsGSCNTTQv/6YCMOflmbYXcr4CNgNwTSInfYdmSlmy2/t2KS4ToAjvFDFOOt5sUhwLyvm1BerY+9msUzHBdALpdjlnP1NEXbi+d9smClqvVh0QapY6DXzehYP2pbALIimlC3LTgghE1iPXZalYz2EITPwxGYxYRBeZN+43RS3LiWu9H2XX3Ccw+Tvw/OlItqa/B5mdv4c2u9MibHb7p9B3JlrFTWaT3Rvz9TBmu5ys6EldORKbcspz7YnDiJUp91QTX/oznCTG1UHb7TU/2ycqH3A553YsnCmkUN1cKSewE7iT/A/NZNoegGAZrhBRupiSRikDNI9GSXQ5y7QtrWm6Io4XVE0i2vZBJ9OF7sghhnzjkKlW1+NSDddPT3oxoZMo5waiC2ShH7fP6gg+6lC0bPCLkncPT648BA3OxoeuiIBoz/qQKr4s21BaXWXPxYP3PS33ztk93u5P4vRqZuOms78CJQMh4pUFihUte59zV+YsVY33xiXtPsMWVBqTn07+rlYkc1cZUMXwjAREQOv62eKBvO4ergTeiKnK2GfQRnjSU1bznGw0n5HBPH9lwjiwcR/UxpC94dTUntwneknVdkXcNoTwRfnVk4jt/4BfTB/DRlou/lml3susZXE1AvOeO6oNttJlBaLqB3pKtpftvBJkWySvw7nO1mGyPe+kGCJLdedFX9/BI+5OCmjGQK7UpGlFg9GBcRLmHPj6iRU2THvFxc6jaXyOiQC1nqHVbFBTyGiesWPhDY0t4eVgWw20XfTj3jJNYpU5GvuCWYFS7pnx2gRUhWJIe3UL4iHq1hNbovAnsd6TDWEQBRbDXw/m502MMJDIC8TYc//Xv5moIhZu8X9LUC4hVLCbITHWZNgQDvOilZE2fW0iykJLxrqxRLhg6adqmdOaViTcloPFU3VUxAISiVmtDqf7/o8KEzUJeghV5+x822LAE9w1RGpviSk0nl/pwERDVRaCHc24F3VtW28SoLhbgTcJ1qyYAYwigDfK7Kt0BfeJiNCH4WZ+VN2KI9AaXDz8h5LN4Qe3TRF0rskcO8TpPT4DWwn48uX76wNO7itF+jF7UaXbggDBQiWv71lEfnhB/mwhXGyxo8jUAzjsI=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: synopsys.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DM6PR12MB5550.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 68104949-3249-4ec1-6482-08d9f6e5d2ae
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Feb 2022 16:01:59.1130 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: c33c9f88-1eb7-4099-9700-16013fd9e8aa
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: JmECCi6dE5iyn4FKQsrXm149llgk7Va1qf8joPDSljfedlVQkYeJW6TexPaBimfUPbrnyvOiktXoYKSkf5dcSw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL0PR12MB2580
Received-SPF: pass client-ip=149.117.73.133;
 envelope-from=John.Hagerman@HIDDEN; helo=smtprelay-out1.synopsys.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, 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.3 (-)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)

[Sent manually because sending from Emacs didn't work.]


Save this as file "comment.c" (*.c as C-mode is important):
---8<---
// \details
// I want the previous line to be untouched by c-fill-paragraph.
--->8---

Dribble file:
=06comment.c<return><escape>q<escape>:(setq c-paragraph-separate "$\\|// \\=
\\[a-z]+$")<return><escape>:(c-setup-paragraph-variables)<return><escape>q

Summary of actions:
+ Read comment.c; C-mode is entered.
+ Move down one line and do c-fill-paragraph: the two lines are merged
+ Undo to revert to original two lines
+ Set c-paragraph-separate and update the C-mode variables
+ Do c-fill-paragraph again; this time the two lines are not merged

There is nothing wrong with these actions!  The bug is only about the
c-paragraph-* variable documentation.

The Bug:
The documentation for c-paragraph-separate and c-paragraph-start should
describe the fact that they must begin with "$\\|" to work properly.

Details:
// Upon entering C-mode, the value of c-paragraph-separate is "$".
//
// \details
// I want the previous line to be untouched by c-fill-paragraph.
// With c-paragraph-separate being "$", that line will be included
// in a paragraph fill.  So: I want lines matching "^// \\\\[a-z]+$"
// to stand alone.  I will modify c-paragraph-separate to get this.
//
// As always, fill-paragraph regexps do not start with "^".  After a
// fair amount of work I found that custom c-paragraph-separate (and
// c-paragraph-start) must begin with "$\\|" to work properly.  So I
// do this:
// (setq c-paragraph-separate "$\\|// \\\\[a-z]+$")
// (c-setup-paragraph-variables)
//
// This bug report is about the fact that c-paragraph-separate and
// c-paragraph-start must begin with "$\\|".  Ideally that would be
// fixed.  But at the least this fact should be described in the
// variables' documentation.


In GNU Emacs 27.2 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.30, cair=
o version 1.15.12)
 of 2021-06-11 built on depbldcs73
Windowing system distributor 'TigerVNC', version 11.0.11400000
System Description: CentOS Linux 7 (Core)

Recent messages:
For information about GNU Emacs and the GNU system, type C-h C-a.

Configured using:
 'configure --prefix=3D/depot/Emacs/emacs-27.2 --with-xpm=3Difavailable
 --with-gif=3Difavailable --with-gnutls=3Difavailable --with-mailutils
 --with-cairo'

Configured features:
JPEG TIFF PNG RSVG CAIRO SOUND DBUS GSETTINGS GLIB NOTIFY INOTIFY ACL
LIBSELINUX LIBXML2 FREETYPE HARFBUZZ LIBOTF ZLIB TOOLKIT_SCROLL_BARS
GTK3 X11 XDBE XIM MODULES THREADS PDUMPER GMP

Important settings:
  value of $LC_ALL: C
  value of $LC_COLLATE: en_US.UTF-8
  value of $LC_CTYPE: en_US.UTF-8
  value of $LC_MESSAGES: en_US.UTF-8
  value of $LC_MONETARY: en_US.UTF-8
  value of $LC_NUMERIC: en_US.UTF-8
  value of $LC_TIME: en_US.UTF-8
  value of $LANG: en_US.UTF-8
  locale-coding-system: nil

Major mode: C/*l

Minor modes in effect:
  tooltip-mode: t
  global-eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  line-number-mode: t
  transient-mark-mode: t
  abbrev-mode: t

Load-path shadows:
None found.

Features:
(shadow sort mail-extr emacsbug message rmc puny dired dired-loaddefs
format-spec rfc822 mml mml-sec password-cache epa derived epg epg-config
gnus-util rmail rmail-loaddefs text-property-search time-date subr-x seq
byte-opt gv bytecomp byte-compile cconv mm-decode mm-bodies mm-encode
mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047
rfc2045 ietf-drums mm-util mail-prsvr mail-utils cc-mode cc-fonts
easymenu cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars
cc-defs cl-loaddefs cl-lib tooltip eldoc electric uniquify ediff-hook
vc-hooks lisp-float-type 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 elisp-mode lisp-mode prog-mode register page
tab-bar menu-bar rfn-eshadow isearch timer select scroll-bar mouse
jit-lock font-lock syntax facemenu font-core term/tty-colors frame
minibuffer cl-generic 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 charscript charprop case-table epa-hook jka-cmpr-hook help
simple abbrev obarray cl-preloaded 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
threads dbusbind inotify dynamic-setting system-font-setting
font-render-setting cairo move-toolbar gtk x-toolkit x multi-tty
make-network-process emacs)

Memory information:
((conses 16 71165 12625)
 (symbols 48 8457 1)
 (strings 32 22858 3926)
 (string-bytes 1 841254)
 (vectors 16 12753)
 (vector-slots 8 163125 8052)
 (floats 8 20 35)
 (intervals 56 1470 2084)
 (buffers 1000 12)
 (heap 1024 13164 1341))

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: John Hagerman <John.Hagerman@HIDDEN>
Subject: bug#54128: Acknowledgement (27.2; c-paragraph-* variables not
 sufficiently documented)
Message-ID: <handler.54128.B.16456321349191.ack <at> debbugs.gnu.org>
References: <DM6PR12MB55504D5C2C67466B1351A0BAAC3C9@HIDDEN>
X-Gnu-PR-Message: ack 54128
X-Gnu-PR-Package: emacs
Reply-To: 54128 <at> debbugs.gnu.org
Date: Wed, 23 Feb 2022 16:03:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 54128 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
54128: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D54128
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#54128: 27.2; c-paragraph-* variables not sufficiently documented
Resent-From: Lars Ingebrigtsen <larsi@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Wed, 23 Feb 2022 20:05:02 +0000
Resent-Message-ID: <handler.54128.B54128.16456466731342 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: John Hagerman <John.Hagerman@HIDDEN>
Cc: 54128 <at> debbugs.gnu.org, Alan Mackenzie <acm@HIDDEN>
From: Lars Ingebrigtsen <larsi@HIDDEN>
References: <DM6PR12MB55504D5C2C67466B1351A0BAAC3C9@HIDDEN>
Date: Wed, 23 Feb 2022 21:04:19 +0100
In-Reply-To: <DM6PR12MB55504D5C2C67466B1351A0BAAC3C9@HIDDEN>
 (John Hagerman's message of "Wed, 23 Feb 2022 16:01:59 +0000")
Message-ID: <87h78p5ozg.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

John Hagerman <John.Hagerman@HIDDEN> writes:

> The Bug:
> The documentation for c-paragraph-separate and c-paragraph-start should
> describe the fact that they must begin with "$\\|" to work properly.

Alan added to the CCs; perhaps he has some comments.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Last modified: Wed, 23 Feb 2022 20:15:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.