[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [bug-mailutils] offer more links to the definition of MSGLIST

From: 積丹尼 Dan Jacobson
Subject: Re: [bug-mailutils] offer more links to the definition of MSGLIST
Date: Wed, 16 Jan 2019 01:35:05 +0800

>>>>> "SP" == Sergey Poznyakoff <address@hidden> writes:
>> Pages like
>> (info "(mailutils) Displaying Messages")
>> should offer a link to the definition of MSGLIST.

SP> I tend to agree. But then any page ("Displaying Messages",
SP> "Marking Messages", etc) will start with the same link to
SP> MSGLIST. When using the manual as a reference, that would
SP> be convenient, indeed. But when reading it sequentially,
SP> this will be seen as unnecessary repetition. Any ideas how
SP> to avoid this?

The problem is users often land in the middle of the manual due to
searching for something. Few read the whole manual unless on an ocean
voyage or something.

(info "(mailutils) Specifying Messages") needs to have "MSGLIST"
embedded into it, so searching will find it. Do say "...message list (in this
manual referred to as MSGLIST)...".

Anyway, the user has say landed on
(info "(mailutils) Displaying Messages") Displaying Messages

He needs to climb up and then over to
(info "(mailutils) Displaying Messages")
3.5.2 How to Specify Message Sets

to finally find it.

There is little chance in this case that he will.

Same problem with all of 3.5.5.* .

He has got to be very lucky to climb back up the tree and then over into
a different branch to find it.

So in this case I think that it is just to far without a little link assistance.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]