bug#71220: Missing hyperlink

bug#71220: Missing hyperlink

[Dan Jacobson]

(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.

bug#71220: Missing hyperlink

[Eli Zaretskii]

> From: Dan Jacobson <jidanni@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.

bug#71220: Missing hyperlink

[Dan Jacobson]

>>>>> "EZ" == Eli Zaretskii <eliz@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.

bug#71220: Missing hyperlink

[Eli Zaretskii]

> From: Dan Jacobson <jidanni@jidanni.org>
> Cc: 71220@debbugs.gnu.org
> Date: Mon, 27 May 2024 21:41:20 +0800
> 
> >>>>> "EZ" == Eli Zaretskii <eliz@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.

bug#71220: Missing hyperlink

[Dan Jacobson]

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.

bug#71220: Missing hyperlink

[Eli Zaretskii]

> Date: Mon, 27 May 2024 22:43:40 +0800
> From: Dan Jacobson <jidanni@jidanni.org>
> Cc: 71220@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.

bug#71220: Missing hyperlink

[Stefan Kangas]

Dan Jacobson <jidanni@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.