GNU bug report logs - #75793
[PATCH] Remove leading '*' from docstrings in cc-vars.el

Previous Next

Package: emacs;

Reported by: Stefan Kangas <stefankangas <at> gmail.com>

Date: Thu, 23 Jan 2025 22:57:02 UTC

Severity: wishlist

Tags: patch

Fixed in version 31.1

Done: Stefan Kangas <stefankangas <at> gmail.com>

Bug is archived. No further changes may be made.

Full log


Message #8 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Alan Mackenzie <acm <at> muc.de>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: bug-gnu-emacs <at> gnu.org
Subject: Re: [PATCH] Remove leading '*' from docstrings in cc-vars.el
Date: Tue, 28 Jan 2025 12:28:06 +0000
Hello, Stefan.

On Thu, Jan 23, 2025 at 16:56:33 -0600, Stefan Kangas wrote:
> Severity: wishlist

> Hi Alan,

> Please find attached a minor cleanup that removes a leading '*'
> character from some docstrings in CC Mode.  AFAIU, this is the '*' that
> we used to have for user-variable docstrings.

Yes indeed.  Most of these have already been removed from CC Mode in
Emacs, just that last one had a line continuation to confound grep.

In stand alone CC Mode, there are still 47 such asterisks, which I'll
get rid of sometime.

> I'm not sure if this list is still the preferred way to send CC Mode bug
> reports, so please let me know if you prefer anything else.

Yes, bug-cc-mode <at> gnu.org is indeed my preferred list, though I will
still handle things sent to my personal address too.

> Thanks!

Thank you, too!

> From a170459b4a5a6531415efe1492474834b465c52c Mon Sep 17 00:00:00 2001
> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Thu, 23 Jan 2025 23:49:52 +0100
> Subject: [PATCH] Remove leading '*' from docstrings in cc-vars.el
> 
> * lisp/progmodes/cc-vars.el (c-make-font-lock-extra-types-blurb):
> Remove leading '*' from generated docstrings.
> ---
>  lisp/progmodes/cc-vars.el | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/lisp/progmodes/cc-vars.el b/lisp/progmodes/cc-vars.el
> index 3c386eb07e9..0687801d69f 100644
> --- a/lisp/progmodes/cc-vars.el
> +++ b/lisp/progmodes/cc-vars.el
> @@ -1566,7 +1566,7 @@ 'c-extra-types-widget
>  
>  (defun c-make-font-lock-extra-types-blurb (mode1 mode2 example)
>    (concat "\
> -*List of extra types (aside from the type keywords) to recognize in "
> +List of extra types (aside from the type keywords) to recognize in "
>  mode1 " mode.
>  Each list item should be a regexp matching a single identifier.
>  " example "
> -- 
> 2.48.1
> 

-- 
Alan Mackenzie (Nuremberg, Germany).




This bug report was last modified 137 days ago.

Previous Next


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