GNU bug report logs - #71220
Missing hyperlink

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 71220 in the body.
You can then email your comments to 71220 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Dan Jacobson <jidanni <at> jidanni.org>
To: bug-gnu-emacs <at> gnu.org
Subject: Missing hyperlink
Date: Mon, 27 May 2024 16:17:00 +0800

(info "(emacs) Fixing Case") contains a hyperlink to
(info "(emacs) Case") but the latter is missing a vital hyperlink to the former!!
I'm saying if we are reading the latter, we would feel sad if we found out one day we didn't know about the former.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Dan Jacobson <jidanni <at> jidanni.org>
Cc: 71220 <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Mon, 27 May 2024 14:39:31 +0300

> From: Dan Jacobson <jidanni <at> jidanni.org>
> Date: Mon, 27 May 2024 16:17:00 +0800
> 
> (info "(emacs) Fixing Case") contains a hyperlink to
> (info "(emacs) Case") but the latter is missing a vital hyperlink to the former!!
> I'm saying if we are reading the latter, we would feel sad if we found out one day we didn't know about the former.

I don't understand: "Case" tells everything that "Fixing Case" tells,
and then some.  By contrast, "Fixing Case" describes only a small part
of what "Case" describes, and it does that to avoid the need for the
reader to read the entire large section in "Case" when all they are
interested in is how to fix letter-case typos.

If we added a cross-reference to "Case" to "Fixing Case", what would
that add to what "Case" already describes?  If it doesn't add
anything, then a reverse cross-reference would not be useful.

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

From: Dan Jacobson <jidanni <at> jidanni.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 71220 <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Mon, 27 May 2024 21:41:20 +0800

>>>>> "EZ" == Eli Zaretskii <eliz <at> gnu.org> writes:
EZ> I don't understand: "Case" tells everything that "Fixing Case" tells...

Here's the perfect spot for the link:

   When given a negative argument, the word case conversion commands
apply to the appropriate number of words before point, but do not move
point, see (info "(emacs) Fixing Case"). This is convenient when you have just typed a word in the wrong
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
case: you can give the case conversion command and continue typing.

That way users get to see much more detail !

If this were GitHub I would submit a PR.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Dan Jacobson <jidanni <at> jidanni.org>
Cc: 71220 <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Mon, 27 May 2024 16:59:10 +0300

> From: Dan Jacobson <jidanni <at> jidanni.org>
> Cc: 71220 <at> debbugs.gnu.org
> Date: Mon, 27 May 2024 21:41:20 +0800
> 
> >>>>> "EZ" == Eli Zaretskii <eliz <at> gnu.org> writes:
> EZ> I don't understand: "Case" tells everything that "Fixing Case" tells...
> 
> Here's the perfect spot for the link:
> 
>    When given a negative argument, the word case conversion commands
> apply to the appropriate number of words before point, but do not move
> point, see (info "(emacs) Fixing Case"). This is convenient when you have just typed a word in the wrong
>        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> case: you can give the case conversion command and continue typing.
> 
> That way users get to see much more detail !

The text in "Fixing Case", all of it, is this:

  ‘M-- M-l’
       Convert last word to lower case.  Note ‘Meta--’ is Meta-minus.
  ‘M-- M-u’
       Convert last word to all upper case.
  ‘M-- M-c’
       Convert last word to lower case with capital initial.

     A very common error is to type words in the wrong case.  Because of
  this, the word case-conversion commands ‘M-l’, ‘M-u’, and ‘M-c’ have a
  special feature when used with a negative argument: they do not move the
  cursor.  As soon as you see you have mistyped the last word, you can
  simply case-convert it and go on typing.  *Note Case::.

What does this say that "Case", and in particular the paragraph you
quote above, does not?  I'd rather add whatever is missing to "Case"
than send the reader to another place in the manual.

> If this were GitHub I would submit a PR.

A GitHub PR is not automatically accepted, either.

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

From: Dan Jacobson <jidanni <at> jidanni.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 71220 <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Mon, 27 May 2024 22:43:40 +0800

On Mon, May 27, 2024 at 04:59:10PM +0300, Eli Zaretskii wrote:
> The text in "Fixing Case", all of it, is this:
> 
>   ‘M-- M-l’
>        Convert last word to lower case.  Note ‘Meta--’ is Meta-minus.
>   ‘M-- M-u’
>        Convert last word to all upper case.
>   ‘M-- M-c’
>        Convert last word to lower case with capital initial.
> 
> What does this say that "Case", and in particular the paragraph you
> quote above, does not?  I'd rather add whatever is missing to "Case"
> than send the reader to another place in the manual.

One gets to see three commands, each with its own two lines. That
leaves a lasting impression, instead of requiring the user to need to
analyze the sentence and come up with them in their head.

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

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Dan Jacobson <jidanni <at> jidanni.org>, Eli Zaretskii <eliz <at> gnu.org>
Cc: 71220 <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Mon, 27 May 2024 14:04:39 -0700

Dan Jacobson <jidanni <at> jidanni.org> writes:

> If this were GitHub I would submit a PR.

Perhaps sending patches is an acceptable alternative; run
`git format-patch -1' and then attach the result to your email.

Message #25 received at 71220-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Dan Jacobson <jidanni <at> jidanni.org>
Cc: 71220-done <at> debbugs.gnu.org
Subject: Re: bug#71220: Missing hyperlink
Date: Tue, 28 May 2024 15:40:40 +0300

> Date: Mon, 27 May 2024 22:43:40 +0800
> From: Dan Jacobson <jidanni <at> jidanni.org>
> Cc: 71220 <at> debbugs.gnu.org
> 
> On Mon, May 27, 2024 at 04:59:10PM +0300, Eli Zaretskii wrote:
> > The text in "Fixing Case", all of it, is this:
> > 
> >   ‘M-- M-l’
> >        Convert last word to lower case.  Note ‘Meta--’ is Meta-minus.
> >   ‘M-- M-u’
> >        Convert last word to all upper case.
> >   ‘M-- M-c’
> >        Convert last word to lower case with capital initial.
> > 
> > What does this say that "Case", and in particular the paragraph you
> > quote above, does not?  I'd rather add whatever is missing to "Case"
> > than send the reader to another place in the manual.
> 
> One gets to see three commands, each with its own two lines. That
> leaves a lasting impression, instead of requiring the user to need to
> analyze the sentence and come up with them in their head.

OK, I added some stuff from "Fix Case" to "case", and I'm therefore
closing this bug.

Previous Next

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