Subject: bug#73487: [PATCH] ; * src/cm.c (cmgoto): Add function documentation

From: Jeremy Bryant <[email-masked]>
Date: Thu, 26 Sep 2024 22:54:36 +0100

Eli Zaretskii <[email-masked]> writes:

>> Date: Wed, 25 Sep 2024 22:32:56 +0100
>> From:  Jeremy Bryant via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <[email-masked]>
>> 
>> This proposed patch adds a function documentation where there was none.
>> 
>> Please install on master or provide feedback for further work.
>
> We usually prefer non-block comments, certainly when the comment is
> short.  Can you use that in this case?
>
> Thanks.

Yes, sure.  Revised patch attached with the comment in a single line,
rather than a block.

(I tried to match the style of the surrounding areas of the file but now
realise this was from 1992)

Please install on master or provide feedback for further work.

>From afc9916447528682d72a6bd9429b2a6e91d4d28a Mon Sep 17 00:00:00 2001
From: Jeremy Bryant <[email-masked]>
Date: Wed, 25 Sep 2024 22:28:04 +0100
Subject: [PATCH] ; * src/cm.c (cmgoto): Add function documentation

---
 src/cm.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/cm.c b/src/cm.c
index ad419ce0af1..e1014af5298 100644
--- a/src/cm.c
+++ b/src/cm.c
@@ -317,6 +317,8 @@ #define	USEHOME	1
 #define	USELL	2
 #define	USECR	3
 
+/* Move the cursor to (row, col), by computing the optimal way. */
+
 void
 cmgoto (struct tty_display_info *tty, int row, int col)
 {
-- 
2.45.2