GNU bug report logs - #31655
no obvious link to the Lisp Reference Manual

Previous Next

Package: emacs;

Reported by: Van L <van <at> scratch.space>

Date: Wed, 30 May 2018 10:23:01 UTC

Severity: wishlist

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Wed, 30 May 2018 10:23:01 GMT) Full text and rfc822 format available.

Acknowledgement sent to Van L <van <at> scratch.space>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Wed, 30 May 2018 10:23:01 GMT) Full text and rfc822 format available.

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

From: Van L <van <at> scratch.space>
To: bug-gnu-emacs <at> gnu.org
Subject: no obvious link to the Lisp Reference Manual
Date: Wed, 30 May 2018 20:21:56 +1000
> John Darrington writes:
> 
> You need to report this to the emacs maintainers.

The page should not say to contact: maintainers <at> gnu.org

> Van L writes:
>> Hello.
>> 
>> From the following locations I am unable to see the link to the Lisp Reference Manual, which is expected close to the Lisp Intro.
>> 
>> https://www.gnu.org/software/emacs/
>> https://www.gnu.org/manual/manual.html





Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Wed, 30 May 2018 17:09:01 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Wed, 30 May 2018 20:08:38 +0300
> From: Van L <van <at> scratch.space>
> Date: Wed, 30 May 2018 20:21:56 +1000
> 
> 
> > John Darrington writes:
> > 
> > You need to report this to the emacs maintainers.
> 
> The page should not say to contact: maintainers <at> gnu.org
> 
> > Van L writes:
> >> Hello.
> >> 
> >> From the following locations I am unable to see the link to the Lisp Reference Manual, which is expected close to the Lisp Intro.
> >> 
> >> https://www.gnu.org/software/emacs/
> >> https://www.gnu.org/manual/manual.html

I'm not sure I understand the problem.  Starting from

  https://www.gnu.org/software/emacs/

I can click "Documentation & Support", and I'm then presented with a
list which includes the Emacs Lisp Reference Manual.  Clicking on the
"Read On-line" link allows me to read the ELisp manual.

Which one of the above didn't work for you?




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Thu, 31 May 2018 02:52:02 GMT) Full text and rfc822 format available.

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

From: Van L <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Thu, 31 May 2018 12:50:54 +1000
> Eli Zaretskii writes:
> 
>>>> https://www.gnu.org/software/emacs/
>>>> https://www.gnu.org/manual/manual.html
> 
> I'm not sure I understand the problem.  Starting from
> 
>  https://www.gnu.org/software/emacs/
> 
> Which one of the above didn't work for you?

I found the two links, as above. 

There I located the lisp-intro on an index page but a keyword search for ``lisp reference'’ had nothing which was why I contacted the email mentioned which turned out to be inappropriate to contact. If you’ve located the lisp reference, having it on the same page as the index for lisp intro, in fact, on neighboring lines, will definitely be handy to have, and it would be consistent with how they are arranged on the infopage directory.





Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Thu, 31 May 2018 14:42:01 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Thu, 31 May 2018 17:40:53 +0300
> From: Van L <van <at> scratch.space>
> Date: Thu, 31 May 2018 12:50:54 +1000
> Cc: 31655 <at> debbugs.gnu.org
> 
> 
> > Eli Zaretskii writes:
> > 
> >>>> https://www.gnu.org/software/emacs/
> >>>> https://www.gnu.org/manual/manual.html
> > 
> > I'm not sure I understand the problem.  Starting from
> > 
> >  https://www.gnu.org/software/emacs/
> > 
> > Which one of the above didn't work for you?
> 
> I found the two links, as above. 
> 
> There I located the lisp-intro on an index page but a keyword search for ``lisp reference'’ had nothing which was why I contacted the email mentioned which turned out to be inappropriate to contact. If you’ve located the lisp reference, having it on the same page as the index for lisp intro, in fact, on neighboring lines, will definitely be handy to have, and it would be consistent with how they are arranged on the infopage directory.

Sorry, I'm afraid I'm still not following.  What is the "index page"
which you mention?  And what is "keyword search" in this case, and how
did you perform it?

Thanks.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Fri, 01 Jun 2018 04:30:02 GMT) Full text and rfc822 format available.

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

From: Van L <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Fri, 1 Jun 2018 14:29:06 +1000
> Eli Zaretskii writes:
> 
> Sorry, I'm afraid I'm still not following.  What is the "index page"
> which you mention?  And what is "keyword search" in this case, and how
> did you perform it?

The index page has a list of all the published manuals except the lisp reference. (I bug reported two links, one of them is it.)

The keyword search is the function in the web browser for finding a sequence of characters on the presented webpage. (Command-F does it on the web browser in front of me.)

On the following page,

  https://www.gnu.org/manual/manual.html

Command-F followed by ,lisp ref, results in 

  Phrase not found



Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Fri, 01 Jun 2018 07:41:02 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Fri, 01 Jun 2018 10:40:50 +0300
> From: Van L <van <at> scratch.space>
> Date: Fri, 1 Jun 2018 14:29:06 +1000
> Cc: 31655 <at> debbugs.gnu.org
> 
> On the following page,
> 
>   https://www.gnu.org/manual/manual.html
> 
> Command-F followed by ,lisp ref, results in 
> 
>   Phrase not found

Try "elisp" instead, and Bob's your uncle.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Fri, 01 Jun 2018 07:57:02 GMT) Full text and rfc822 format available.

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

From: Van L <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Fri, 1 Jun 2018 17:56:07 +1000
> Eli Zaretskii writes:
> 
> Try "elisp" instead, and Bob's your uncle.

That’s not obvious to a beginners’ mindset. The surrounding context is unhelpful.

  https://www.gnu.org/software/emacs/manual/html_node/elisp/

On the above page ,Emacs Lisp, has lost `Reference` as part of the title on the top line.

But the browser’s tab title is long enough for ,GNU Emacs Lisp Reference…,.

I don’t know about Bob but Barbra might want the lisp-intro and lisp-ref to be near each other on the virtual bookshelf.

Suggest helpful words to funnel towards elisp, which is near to eintr also.



Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sat, 30 Nov 2019 03:58:01 GMT) Full text and rfc822 format available.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Van L <van <at> scratch.space>, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sat, 30 Nov 2019 04:57:31 +0100
Eli Zaretskii <eliz <at> gnu.org> writes:

>> From: Van L <van <at> scratch.space>
>> Date: Fri, 1 Jun 2018 14:29:06 +1000
>> Cc: 31655 <at> debbugs.gnu.org
>> 
>> On the following page,
>> 
>>   https://www.gnu.org/manual/manual.html
>> 
>> Command-F followed by ,lisp ref, results in 
>> 
>>   Phrase not found
>
> Try "elisp" instead, and Bob's your uncle.

The request here is to have a separate link to the Emacs Lisp
Reference Manual from that page.  I think that request makes sense; in
any case it definitely can't hurt.

Does anyone else have an opinion here?  Otherwise, I'll go ahead and
contact webmasters <at> gnu.org to see if they can help add that.

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sat, 30 Nov 2019 07:15:02 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: van <at> scratch.space, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sat, 30 Nov 2019 09:14:06 +0200
> From: Stefan Kangas <stefan <at> marxist.se>
> Cc: Van L <van <at> scratch.space>,  31655 <at> debbugs.gnu.org
> Date: Sat, 30 Nov 2019 04:57:31 +0100
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >>   https://www.gnu.org/manual/manual.html
> >> 
> >> Command-F followed by ,lisp ref, results in 
> >> 
> >>   Phrase not found
> >
> > Try "elisp" instead, and Bob's your uncle.
> 
> The request here is to have a separate link to the Emacs Lisp
> Reference Manual from that page.  I think that request makes sense; in
> any case it definitely can't hurt.

My point was that there is such a link already there.  Search for
"elisp", and you will find it.  The OP searched for "lisp ref" for
some reason, and that substring is not present on the page.
Personally, I don't understand the motivation behind that search
string, but that's me.

> Does anyone else have an opinion here?  Otherwise, I'll go ahead and
> contact webmasters <at> gnu.org to see if they can help add that.

If we are going to add more links to the ELisp manuals (or Emacs
manuals in general), we might as well first come up with a list of
strings people might use while searching that page, because adding
just one random string might not be good enough for the next bug
report.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sat, 30 Nov 2019 08:49:01 GMT) Full text and rfc822 format available.

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

From: VanL <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Stefan Kangas <stefan <at> marxist.se>, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sat, 30 Nov 2019 19:48:17 +1100
Eli Zaretskii <eliz <at> gnu.org> writes:

> My point was that there is such a link already there.  Search for
> "elisp", and you will find it.  The OP searched for "lisp ref" for
> some reason, and that substring is not present on the page.
> Personally, I don't understand the motivation behind that search
> string, but that's me.

I don't recall the context when I spotted what I thought at the time
was a bug worth pursuing.  Generally, when typing in a text box for a
search engine, I expect to see word and phrase completion.  I
might've been after in full 'lisp reference manual' and expected that
to be the expansion from 'lisp ref'.  Not being familiar with the
word 'elisp', at that time, there would've been zero chance of typing
that in.  Yes, you want lots of search terms people use when what
they really want to find is elisp; and allow for missed spellings, etc.

-- 
LoL,
  əə0@ 一 二 三 言 語 𝔖
  'VLIW architecture?'
  G4 White 78 Black 79




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sat, 30 Nov 2019 10:32:02 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: VanL <van <at> scratch.space>
Cc: stefan <at> marxist.se, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sat, 30 Nov 2019 12:31:19 +0200
> From: VanL <van <at> scratch.space>
> Cc: Stefan Kangas <stefan <at> marxist.se>,  31655 <at> debbugs.gnu.org
> Date: Sat, 30 Nov 2019 19:48:17 +1100
> 
> I don't recall the context when I spotted what I thought at the time
> was a bug worth pursuing.  Generally, when typing in a text box for a
> search engine, I expect to see word and phrase completion.

That's the feature of a Web browser you used in this case, isn't it?




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sun, 01 Dec 2019 02:23:01 GMT) Full text and rfc822 format available.

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

From: VanL <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: stefan <at> marxist.se, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sun, 01 Dec 2019 13:21:50 +1100
Eli Zaretskii <eliz <at> gnu.org> writes:

>> Generally, when typing in a text box for a search engine, I expect to
>> see word and phrase completion.
>
> That's the feature of a Web browser you used in this case, isn't it?

I don't know.  I could guess you are suggesting JS is in on it.  Even
before the address-bar on the web browser functioned as the text input
to search engine, landing on search engine page and typing incomplete
text fragments did expand to a listing of results.

-- 
LoL,
  əə0@ 一 二 三 言 語 𝔖
  'VLIW architecture?'
  G4 White 78 Black 79




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sun, 01 Dec 2019 07:46:01 GMT) Full text and rfc822 format available.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: van <at> scratch.space, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sun, 01 Dec 2019 08:45:18 +0100
Eli Zaretskii <eliz <at> gnu.org> writes:

>> >>   https://www.gnu.org/manual/manual.html
>> >> 
>> >> Command-F followed by ,lisp ref, results in 
>> >> 
>> >>   Phrase not found
>> >
>> > Try "elisp" instead, and Bob's your uncle.
>> 
>> The request here is to have a separate link to the Emacs Lisp
>> Reference Manual from that page.  I think that request makes sense; in
>> any case it definitely can't hurt.
>
> My point was that there is such a link already there.  Search for
> "elisp", and you will find it.  The OP searched for "lisp ref" for
> some reason, and that substring is not present on the page.
> Personally, I don't understand the motivation behind that search
> string, but that's me.

Ah, I see now.  Indeed, the suggested search string was "lisp ref".  I
also wouldn't necessarily expect a beginner to search for that.

I was searching on the page for "emacs lisp", which is what I suspect
a beginner would go for.  I'm also guessing that "elisp" is a
shorthand that might be unknown to beginners.

> If we are going to add more links to the ELisp manuals (or Emacs
> manuals in general), we might as well first come up with a list of
> strings people might use while searching that page, because adding
> just one random string might not be good enough for the next bug
> report.

Personally, I think adding a link named "Emacs Lisp Reference Manual"
would be enough.

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#31655; Package emacs. (Sun, 01 Dec 2019 09:50:02 GMT) Full text and rfc822 format available.

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

From: VanL <van <at> scratch.space>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: Eli Zaretskii <eliz <at> gnu.org>, 31655 <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Sun, 01 Dec 2019 20:49:05 +1100
Stefan Kangas <stefan <at> marxist.se> writes:

>> strings people might use while searching that page, because adding
>> just one random string might not be good enough for the next bug
>> report.
>
> Personally, I think adding a link named "Emacs Lisp Reference Manual"
> would be enough.
>

All I know is there are two works on Emacs Lisp:

1. Emacs Lisp An Introduction to Programming in
2. Emacs Lisp Reference Manual

-- 
LoL,
  əə0@ 一 二 三 言 語 𝔖
  'VLIW architecture?'
  G4 White 78 Black 79




Reply sent to Stefan Kangas <stefan <at> marxist.se>:
You have taken responsibility. (Wed, 15 Jan 2020 01:44:01 GMT) Full text and rfc822 format available.

Notification sent to Van L <van <at> scratch.space>:
bug acknowledged by developer. (Wed, 15 Jan 2020 01:44:02 GMT) Full text and rfc822 format available.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: van <at> scratch.space, 31655-done <at> debbugs.gnu.org
Subject: Re: bug#31655: no obvious link to the Lisp Reference Manual
Date: Wed, 15 Jan 2020 02:43:33 +0100
Eli Zaretskii <eliz <at> gnu.org> writes:

>> >>   https://www.gnu.org/manual/manual.html
>> >> 
>> >> Command-F followed by ,lisp ref, results in 
>> >> 
>> >>   Phrase not found
>> >
>> > Try "elisp" instead, and Bob's your uncle.
>> 
>> The request here is to have a separate link to the Emacs Lisp
>> Reference Manual from that page.  I think that request makes sense; in
>> any case it definitely can't hurt.
>
> My point was that there is such a link already there.  Search for
> "elisp", and you will find it.  The OP searched for "lisp ref" for
> some reason, and that substring is not present on the page.
> Personally, I don't understand the motivation behind that search
> string, but that's me.

I had another look at this with fresh eyes, and I think I agree that
there is no need for further links on this page:

    https://www.gnu.org/manual/manual.html

That page seems to be about enumerating different pieces of GNU
software and linking their manuals.  It makes no sense to have two
entries for Emacs in that particular list.

I'm therefore closing this bug report.  If anyone disagrees with that,
feel free to reopen (or just reply to this email) and suggest a
different course of action.

Best regards,
Stefan Kangas




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Wed, 12 Feb 2020 12:24:05 GMT) Full text and rfc822 format available.

This bug report was last modified 4 years and 46 days ago.

Previous Next


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