From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 23 11:02:14 2022 Received: (at submit) by debbugs.gnu.org; 23 Feb 2022 16:02:14 +0000 Received: from localhost ([127.0.0.1]:46052 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMu5m-0002OB-4q for submit@debbugs.gnu.org; Wed, 23 Feb 2022 11:02:14 -0500 Received: from lists.gnu.org ([209.51.188.17]:48686) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMu5k-0002O3-FT for submit@debbugs.gnu.org; Wed, 23 Feb 2022 11:02:12 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45792) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nMu5k-0001Qz-1E for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2022 11:02:12 -0500 Received: from smtprelay-out1.synopsys.com ([149.117.73.133]:46498) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nMu5g-0003rV-4m for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2022 11:02:11 -0500 Received: from mailhost.synopsys.com (sv1-mailhost1.synopsys.com [10.205.2.131]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (Client CN "mailhost.synopsys.com", Issuer "SNPSica2" (verified OK)) by smtprelay-out1.synopsys.com (Postfix) with ESMTPS id 7631A4267A for ; Wed, 23 Feb 2022 16:02:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=synopsys.com; s=mail; t=1645632123; bh=dl3iOLSex9SY0GeHHlfJEY3NvR0DnFzHJhgNKOvBC40=; h=From:To:Subject:Date:From; b=fKwAhUUIDFyDOdkremeukuJ1MXEx/rjzD3arkZL0rJprSmCfHP+retoQ8H+sq8iYg 2Cick5WZ+Ch3Egtsel4gDl71sBieTX+cLEnk9TeRKeNs52RMi3IExbo93Su8p+j4qy yPuUfm6BH2mlXvIjYwmF/Bqf9kCgLl8Q49t5PzIBxVgxqlhTvq8raTBsZbYBzzFWqc fz3DlbGWOfWLyJ3koBIbRfKMG4/QLw9fQzQFg8Lkp0LoGeZ8AF6Pp1NtHTHqsjOlhB w5PNH4OnaGeC2K8t6SPJTMAGdKUCGIdbQyWhuY82wrWpCLhSGlHkf1Kkf5zVEhf+Cb QeCZfT0aK9OwA== Received: from o365relay-in.synopsys.com (us03-o365relay1.synopsys.com [10.4.161.137]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (Client CN "o365relay-in.synopsys.com", Issuer "Entrust Certification Authority - L1K" (verified OK)) by mailhost.synopsys.com (Postfix) with ESMTPS id DF2EEA006A for ; Wed, 23 Feb 2022 16:02:02 +0000 (UTC) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2170.outbound.protection.outlook.com [104.47.55.170]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.protection.outlook.com", Issuer "DigiCert Cloud Services CA-1" (verified OK)) by o365relay-in.synopsys.com (Postfix) with ESMTPS id EE0B6801D7 for ; Wed, 23 Feb 2022 16:02:01 +0000 (UTC) Authentication-Results: o365relay-in.synopsys.com; dmarc=pass (p=reject dis=none) header.from=synopsys.com Authentication-Results: o365relay-in.synopsys.com; spf=pass smtp.mailfrom=hagerman@synopsys.com Authentication-Results: o365relay-in.synopsys.com; dkim=pass (1024-bit key; unprotected) header.d=synopsys.com header.i=@synopsys.com header.b="gUW8011C"; dkim-atps=neutral ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=juVklYFRPKY1OhaYZ/LIC8zIXl9IEfcavoqRxYxoc6C5GUEt8MlOj5o0t/9zSw9Hspq8KSqFKeLrbPQ79gvdJOqVRmFQ49DYr6Eh5gi04azTFv9X32L2+vdXwYgiOsRJjf175YbocQ/Vty3e0I0lsBiADgw2PXbEcldqISZ81KGIr0UwlfvEypacTzmOF7iGHT2KrdqwxEO0El8FDPeNPJWfBTzSMGNHyp0MbAFUX3xJvkSDrq0yPEpkuJO+FrNN1qwj+m9Y/UwN7JrB8IDIA8y8Mm9j9SOCZ+fdPeduiTeZsNWgubN6OQAJIphT2jJKBODIX677R6KNjvVJo0deuA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Mnk1HovY7Zb1kpOxSZeMNyNlT2jB32t2a/g6CWcVUxw=; b=KjbYD9zp3XbbjTP39Jr7As08k1kwoawDVCEXnDzyiRivbu3NOZy3zBERl/lL3fJ0kE5G/F/qaI3WU903TbZNVCpNm9AzPyTspTrwOepUzSpP30A06ywXbxVHccd0J/yk94C2t0idjqUaxplAIkOD5utVo0q0MYubmGiTefGzlKrwcLXNEsEeTx55KDRWbT70ybeyg2rldPWbysoBXc+Yd3bn0RLlY9s39NX5zTsLS/GHEBclAIqgpF9GGCFlVmv2oJqUQvGnpQ1sRF5tqtoGrOc/lihZ22+kC3jQA7CTq5gk+ZXt4/UGAnSh5+OPze/02Aba7nSncTgN4R9qoNMRVg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=synopsys.com; dmarc=pass action=none header.from=synopsys.com; dkim=pass header.d=synopsys.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=synopsys.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Mnk1HovY7Zb1kpOxSZeMNyNlT2jB32t2a/g6CWcVUxw=; b=gUW8011C/+lXkTJLk6Y5IBcK334jy730cTi1t4aV+3WNTHze2T4NexvYyXn0Tp0Gv4gGgaxh5NnT6iycYN4YHaX651XDtjvpFC38OLm7nBqxAuTlKS9GeIUex4++gAmEhnxmxHA+miPR0orxsxUNs+z48w0cT60jkN0NESd9qUU= Received: from DM6PR12MB5550.namprd12.prod.outlook.com (2603:10b6:5:1b6::17) by BL0PR12MB2580.namprd12.prod.outlook.com (2603:10b6:207:3e::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5017.22; Wed, 23 Feb 2022 16:01:59 +0000 Received: from DM6PR12MB5550.namprd12.prod.outlook.com ([fe80::ec92:9965:872f:34e7]) by DM6PR12MB5550.namprd12.prod.outlook.com ([fe80::ec92:9965:872f:34e7%3]) with mapi id 15.20.5017.022; Wed, 23 Feb 2022 16:01:59 +0000 X-SNPS-Relay: synopsys.com From: John Hagerman To: "bug-gnu-emacs@gnu.org" Subject: 27.2; c-paragraph-* variables not sufficiently documented 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: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=synopsys.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 68104949-3249-4ec1-6482-08d9f6e5d2ae x-ms-traffictypediagnostic: BL0PR12MB2580:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Uxw6l8wPCdeXRitRtCxQLCWimY2g8+E6g+NA+/L3i917A9pkqVQCxmVf6HuqhqlMfYpwlwODYS9uh7zXBqYr+wZwAscAyfPThGQTq3UxNcE3zmbQFUZfJQf4IpdVmvrUkSZ7Q6n9uKRhJvbEueUgu7QhLrciswJsrluu5S188CABV7IieZnQsPaknZkSXkMlHM+8pVDwEoku0MbzlF2Gcv6sC6n4fZR9NPCOi48hNcm3l26FAGnB1wiM/3izm8xdl0HP2bY4PN3CstLX72Yp/SsCV371kg4ONBbFmBvDQr5mVw7oysMQupit2TRq2i90z246xyvOFd4dnWRdF0+xjsrvJTbPILIx+QSbTmGkUjptiIn6+h+CARUdMVhmLd2yOBKGSyjtkb6KRi2J7rYxqpycMSWzip5NoPzlqDTh//HzvkRU8q2M+PqMWr5EA1W/WwdtfzOJ77fo82Qf9tqIoKUyBTTXsnq8cAixdtRB7fp/6zydWEbw6pJ4FiBmA77EV/oEp8zzoOpFyIa4zufqrfkh3ERVCLhkvgpksc5+qkVgGHj0FBDA22ateNPXTofwlyv1tWmVZX8Pu2cv7qihLWRuRR6MKaRC+4iqbFUrd4iRlWc9pWm09FgzId+fJAapj8fh2nkri5Q6IKjKEI6VLukLYjKuQx70hkD1Y9yPQbTUB7prTKgq3ey47cpVvhnhaDLon88XJc3EM2FVQE5cgA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR12MB5550.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(55016003)(83380400001)(9686003)(26005)(186003)(7696005)(6506007)(122000001)(71200400001)(38070700005)(33656002)(64756008)(66446008)(8676002)(86362001)(316002)(6916009)(508600001)(66946007)(76116006)(66476007)(2906002)(38100700002)(8936002)(66556008)(5660300002)(52536014); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?okDfsqZ1QWS+OEggKLs5ah0IQbyeIXNGCjaHjiZENSqdP3eWzVyXh2plSZfS?= =?us-ascii?Q?RK+DWoXvUhjWRtWgrGL4oVb7jq0CIAobvH0gC2VChXBUMYZp1NuHTYeIDD6x?= =?us-ascii?Q?FN902z+An0tTx/2pvqua4JHcsLbq9CT+L1knBWCUM5ZHrg5C67t5Tq9vddqW?= =?us-ascii?Q?w86nBT1GqtnNASSRYwOnNvt4SSO1X/l/iw9tQQZ2w6/BefK6MMXjJpjTi4U4?= =?us-ascii?Q?SZ/mANyOs+UNO4Z0lERLNmLVQiwCJwl6I7Frn+YJhSqAoEa3fsaWPuYmsh1o?= =?us-ascii?Q?pQWOBRiqppy/XoQJOLRh2603ZdD2LmgFJ3QWICTKDcTwCgY72dVfzURuxhXi?= =?us-ascii?Q?bauW0m0aCQY9rDj1ZaOlP5K4JOIXIWGd7Ioc7uJKX7ipSBXHUmsDIY7VsUfl?= =?us-ascii?Q?0NvFkP4n0pla/TnW1N+Sp7G4azv1W7IUZr4dsaW6SLfhBGVgBpjaAJAhTCBB?= =?us-ascii?Q?+VK7KwMkrjfOZzC3gqk/OTmyDJSr7xL3VbawG4oTO4MMwsGSCNTTQv/6YCMO?= =?us-ascii?Q?flmbYXcr4CNgNwTSInfYdmSlmy2/t2KS4ToAjvFDFOOt5sUhwLyvm1BerY+9?= =?us-ascii?Q?msUzHBdALpdjlnP1NEXbi+d9smClqvVh0QapY6DXzehYP2pbALIimlC3LTgg?= =?us-ascii?Q?hE1iPXZalYz2EITPwxGYxYRBeZN+43RS3LiWu9H2XX3Ccw+Tvw/OlItqa/B5?= =?us-ascii?Q?mdv4c2u9MibHb7p9B3JlrFTWaT3Rvz9TBmu5ys6EldORKbcspz7YnDiJUp91?= =?us-ascii?Q?QTX/oznCTG1UHb7TU/2ycqH3A553YsnCmkUN1cKSewE7iT/A/NZNoegGAZrh?= =?us-ascii?Q?BRupiSRikDNI9GSXQ5y7QtrWm6Io4XVE0i2vZBJ9OF7sghhnzjkKlW1+NSDd?= =?us-ascii?Q?dPT3oxoZMo5waiC2ShH7fP6gg+6lC0bPCLkncPT648BA3OxoeuiIBoz/qQKr?= =?us-ascii?Q?4s21BaXWXPxYP3PS33ztk93u5P4vRqZuOms78CJQMh4pUFihUte59zV+YsVY?= =?us-ascii?Q?33xiXtPsMWVBqTn07+rlYkc1cZUMXwjAREQOv62eKBvO4ergTeiKnK2GfQRn?= =?us-ascii?Q?jSU1bznGw0n5HBPH9lwjiwcR/UxpC94dTUntwneknVdkXcNoTwRfnVk4jt/4?= =?us-ascii?Q?BfTB/DRlou/lml3susZXE1AvOeO6oNttJlBaLqB3pKtpftvBJkWySvw7nO1m?= =?us-ascii?Q?GyPe+kGCJLdedFX9/BI+5OCmjGQK7UpGlFg9GBcRLmHPj6iRU2THvFxc6jaX?= =?us-ascii?Q?yOiQC1nqHVbFBTyGiesWPhDY0t4eVgWw20XfTj3jJNYpU5GvuCWYFS7pnx2g?= =?us-ascii?Q?RUhWJIe3UL4iHq1hNbovAnsd6TDWEQBRbDXw/m502MMJDIC8TYc//Xv5moIh?= =?us-ascii?Q?Zu8X9LUC4hVLCbITHWZNgQDvOilZE2fW0iykJLxrqxRLhg6adqmdOaViTclo?= =?us-ascii?Q?PFU3VUxAISiVmtDqf7/o8KEzUJeghV5+x822LAE9w1RGpviSk0nl/pwERDVR?= =?us-ascii?Q?aCHc24F3VtW28SoLhbgTcJ1qyYAYwigDfK7Kt0BfeJiNCH4WZ+VN2KI9AaXD?= =?us-ascii?Q?z8h5LN4Qe3TRF0rskcO8TpPT4DWwn48uX76wNO7itF+jF7UaXbggDBQiWv71?= =?us-ascii?Q?lEfnhB/mwhXGyxo8jUAzjsI=3D?= 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@synopsys.com; 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-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: -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.cq:(setq c-paragraph-separate "$\\|// \\= \\[a-z]+$"):(c-setup-paragraph-variables)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)) From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 23 15:04:33 2022 Received: (at 54128) by debbugs.gnu.org; 23 Feb 2022 20:04:33 +0000 Received: from localhost ([127.0.0.1]:46608 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMxsH-0000LZ-AV for submit@debbugs.gnu.org; Wed, 23 Feb 2022 15:04:33 -0500 Received: from quimby.gnus.org ([95.216.78.240]:37764) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMxsF-0000LK-Pa for 54128@debbugs.gnu.org; Wed, 23 Feb 2022 15:04:32 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=idM/hqBEMHNbevpe4J8RTUgFSIJg8A+m6urykHHfcoc=; b=mJ3Q8OF53AI/eFUan6Gjrqi176 K3kJLwOM4qaETFIw7onwXmHEOhlyHjDu+vgbpYJmCwNNODv8/diSPROOkCNyjbtuxV7K2B2xPICXZ Nyhm5VE8BNxapXu2h7d/opp0J8MfIWzdUVb4MlwZgtpYZwgkb89msA+rRwTF5PGlNQ2o=; Received: from [84.212.220.105] (helo=giant) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nMxs5-000583-Q4; Wed, 23 Feb 2022 21:04:24 +0100 From: Lars Ingebrigtsen To: John Hagerman Subject: Re: bug#54128: 27.2; c-paragraph-* variables not sufficiently documented References: X-Now-Playing: Richard And Linda Thompson's _Pour Down Like Silver_: "Night Comes In" Date: Wed, 23 Feb 2022 21:04:19 +0100 In-Reply-To: (John Hagerman's message of "Wed, 23 Feb 2022 16:01:59 +0000") Message-ID: <87h78p5ozg.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain 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: John Hagerman 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. 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: -2.3 (--) X-Debbugs-Envelope-To: 54128 Cc: 54128@debbugs.gnu.org, Alan Mackenzie 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 (---) John Hagerman 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 From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 26 11:59:54 2022 Received: (at 54128) by debbugs.gnu.org; 26 Feb 2022 16:59:54 +0000 Received: from localhost ([127.0.0.1]:56250 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nO0QE-0002IA-BN for submit@debbugs.gnu.org; Sat, 26 Feb 2022 11:59:54 -0500 Received: from colin.muc.de ([193.149.48.1]:14162 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1nO0QC-0002Hx-H3 for 54128@debbugs.gnu.org; Sat, 26 Feb 2022 11:59:53 -0500 Received: (qmail 11888 invoked by uid 3782); 26 Feb 2022 16:59:45 -0000 Received: from acm.muc.de (p2e5d50e3.dip0.t-ipconnect.de [46.93.80.227]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Sat, 26 Feb 2022 17:59:45 +0100 Received: (qmail 8323 invoked by uid 1000); 26 Feb 2022 16:59:45 -0000 Date: Sat, 26 Feb 2022 16:59:45 +0000 To: John Hagerman , Lars Ingebrigtsen Subject: Re: bug#54128: 27.2; c-paragraph-* variables not sufficiently documented Message-ID: References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable In-Reply-To: X-Submission-Agent: TMDA/1.3.x (Ph3nix) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54128 Cc: 54128@debbugs.gnu.org, acm@muc.de 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 (-) Hello, John and Lars. On Wed, Feb 23, 2022 at 16:01:59 +0000, John Hagerman wrote: > [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.cq:(setq c-paragraph-separate "$\\|// = \\\\[a-z]+$"):(c-setup-paragraph-variables)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. Forgive me, it is nearly 20 years since I constructed these variables; why is the "$\\|" necessary? What happened when you tried to construct a regular expression without it? > 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, ca= iro 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) --=20 Alan Mackenzie (Nuremberg, Germany).