unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#53261: 26.3; Doc of `load-history' should say what the alist order is.
@ 2022-01-14 17:00 Drew Adams
  2022-01-15  8:33 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2022-01-14 17:00 UTC (permalink / raw)
  To: 53261

The doc of `load-history' describes the alist entries in detail.  But it
should also say that the list entries are in reverse chronological order
of loading, i.e., earliest loaded libraries at the end, most recently
loaded entries at the beginning.

This may be obvious if you assume the simplest construction of the
alist.  It's nevertheless important information to mention in the doc.

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.19043
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''






^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#53261: 26.3; Doc of `load-history' should say what the alist order is.
  2022-01-14 17:00 bug#53261: 26.3; Doc of `load-history' should say what the alist order is Drew Adams
@ 2022-01-15  8:33 ` Lars Ingebrigtsen
  2022-01-15 21:35   ` bug#53261: [External] : " Drew Adams
  0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2022-01-15  8:33 UTC (permalink / raw)
  To: Drew Adams; +Cc: 53261

Drew Adams <drew.adams@oracle.com> writes:

> The doc of `load-history' describes the alist entries in detail.  But it
> should also say that the list entries are in reverse chronological order
> of loading, i.e., earliest loaded libraries at the end, most recently
> loaded entries at the beginning.

I'm not sure whether that's something that we guarantee, or want to
guarantee?  Anybody have any opinions here?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#53261: [External] : Re: bug#53261: 26.3; Doc of `load-history' should say what the alist order is.
  2022-01-15  8:33 ` Lars Ingebrigtsen
@ 2022-01-15 21:35   ` Drew Adams
  0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2022-01-15 21:35 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 53261

> > The doc of `load-history' describes the alist entries in detail.  But it
> > should also say that the list entries are in reverse chronological order
> > of loading, i.e., earliest loaded libraries at the end, most recently
> > loaded entries at the beginning.
> 
> I'm not sure whether that's something that we guarantee, or want to
> guarantee?  Anybody have any opinions here?

1. I believe it's been in that order since Day One.
2. How could it be otherwise?  (Dunno.)
3. Users should have some understanding of the order,
   to make sense of `load-history'.  Examining this
   history is one way of figuring out something that
   didn't go as expected (e.g. the wrong definition
   of something shadowing another).

It's called `load-history'.  Users will expect it
to be similar to other `*-history' lists, unless
its doc says something different.  But it helps
to directly say what its order is.

It's true that the doc strings of the individual
_minibuffer_ history vars don't say that they are
"most recent first".  But at least the Elisp
manual (node `Minibuffer History') says it's true
of all minibuffer history vars.

The Emacs manual (node `Shell Ring') says that
shell histories are like minibuffer histories.
And node `Repetition' says that command history
is also "most recent first". 






^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2022-01-15 21:35 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-14 17:00 bug#53261: 26.3; Doc of `load-history' should say what the alist order is Drew Adams
2022-01-15  8:33 ` Lars Ingebrigtsen
2022-01-15 21:35   ` bug#53261: [External] : " Drew Adams

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).