all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#3125: 23.0.92; doc of load-library
@ 2009-04-27  4:12 ` Drew Adams
  2009-04-28  3:12   ` Stefan Monnier
                     ` (2 more replies)
  0 siblings, 3 replies; 5+ messages in thread
From: Drew Adams @ 2009-04-27  4:12 UTC (permalink / raw)
  To: emacs-pretest-bug

The doc string and Elisp manual entry for `load-library' could be more
helpful.
 
Doc string:
 
 Load the library named LIBRARY.
 
 LIBRARY should be a relative file name of the library, a string.
 It can omit the suffix (a.k.a. file-name extension).
 
 This is an interface to the function `load'.
 
Elisp entry:
 
 Command: load-library library
     This command loads the library named LIBRARY.  It is equivalent to
     `load', except in how it reads its argument interactively.
 
The explanation in the Emacs manual is good. It should be
cross-referenced from the Elisp manual. The Elisp manual says nothing
helpful; in particular, it says nothing about _how_ its reading of the
arg is different from that of `load'.
 
The doc string is inadequate on its own. The best solution would be
for it to cross-reference the Emacs manual (click a link), but that
feature was refused.  An alternative is to add some more explanation
to the doc string - about .elc, .el etc. 
 

In GNU Emacs 23.0.92.1 (i386-mingw-nt5.1.2600)
 of 2009-03-30 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 







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

* bug#3125: 23.0.92; doc of load-library
  2009-04-27  4:12 ` bug#3125: 23.0.92; doc of load-library Drew Adams
@ 2009-04-28  3:12   ` Stefan Monnier
  2009-04-29 20:30   ` Stefan Monnier
  2009-08-15 18:05   ` bug#3125: marked as done (23.0.92; doc of load-library) Emacs bug Tracking System
  2 siblings, 0 replies; 5+ messages in thread
From: Stefan Monnier @ 2009-04-28  3:12 UTC (permalink / raw)
  To: Drew Adams; +Cc: emacs-pretest-bug, 3125

> The explanation in the Emacs manual is good. It should be
> cross-referenced from the Elisp manual. The Elisp manual says nothing
> helpful; in particular, it says nothing about _how_ its reading of the
> arg is different from that of `load'.

The Elisp manual should probably not bother talking about load-library,
actually.  It's just a user-level command, not a function to be called
from Elisp.
 
> The doc string is inadequate on its own.

Indeed, it's even somewhat misleading.  I'll try and rework it,
thank you.


        Stefan






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

* bug#3125: 23.0.92; doc of load-library
  2009-04-27  4:12 ` bug#3125: 23.0.92; doc of load-library Drew Adams
  2009-04-28  3:12   ` Stefan Monnier
@ 2009-04-29 20:30   ` Stefan Monnier
  2009-04-29 20:54     ` Drew Adams
  2009-08-15 18:05   ` bug#3125: marked as done (23.0.92; doc of load-library) Emacs bug Tracking System
  2 siblings, 1 reply; 5+ messages in thread
From: Stefan Monnier @ 2009-04-29 20:30 UTC (permalink / raw)
  To: Drew Adams; +Cc: 3125

> The doc string and Elisp manual entry for `load-library' could be more

Please check the new docstring (but not the elisp manual yet).


        Stefan






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

* bug#3125: 23.0.92; doc of load-library
  2009-04-29 20:30   ` Stefan Monnier
@ 2009-04-29 20:54     ` Drew Adams
  0 siblings, 0 replies; 5+ messages in thread
From: Drew Adams @ 2009-04-29 20:54 UTC (permalink / raw)
  To: 'Stefan Monnier'; +Cc: 3125

> > The doc string and Elisp manual entry for `load-library' 
> > could be more
> 
> Please check the new docstring (but not the elisp manual yet).

"actually loaded" -> "to be loaded"

"with or without" -> "with and without"

"the `load-suffixes' (as well as `load-file-rep-suffixes')" ->
"the suffixes from variables `load-suffixes' and `load-file-rep-suffixes'"

(Drop "variable", if that's too long.)

Do you really want to state here that there are two interfaces to `load'? If a
third is added later, then this will need to be updated. Why not just say that
`load-library' is an interface to `load'?

Or, better, just skip that altogether. The xref to the manual is sufficient. The
manual describes the relations among the various load functions. The doc string
need say only what `load-library' does/is.







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

* bug#3125: marked as done (23.0.92; doc of load-library)
  2009-04-27  4:12 ` bug#3125: 23.0.92; doc of load-library Drew Adams
  2009-04-28  3:12   ` Stefan Monnier
  2009-04-29 20:30   ` Stefan Monnier
@ 2009-08-15 18:05   ` Emacs bug Tracking System
  2 siblings, 0 replies; 5+ messages in thread
From: Emacs bug Tracking System @ 2009-08-15 18:05 UTC (permalink / raw)
  To: Chong Yidong

[-- Attachment #1: Type: text/plain, Size: 852 bytes --]


Your message dated Sat, 15 Aug 2009 14:00:16 -0400
with message-id <87zla10xfz.fsf@cyd.mit.edu>
and subject line Re: bug#3125: 23.0.92; doc of load-library
has caused the Emacs bug report #3125,
regarding 23.0.92; doc of load-library
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
3125: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3125
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 3859 bytes --]

From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: 23.0.92; doc of load-library
Date: Sun, 26 Apr 2009 21:12:58 -0700
Message-ID: <003a01c9c6ee$733d40c0$0200a8c0@us.oracle.com>

The doc string and Elisp manual entry for `load-library' could be more
helpful.
 
Doc string:
 
 Load the library named LIBRARY.
 
 LIBRARY should be a relative file name of the library, a string.
 It can omit the suffix (a.k.a. file-name extension).
 
 This is an interface to the function `load'.
 
Elisp entry:
 
 Command: load-library library
     This command loads the library named LIBRARY.  It is equivalent to
     `load', except in how it reads its argument interactively.
 
The explanation in the Emacs manual is good. It should be
cross-referenced from the Elisp manual. The Elisp manual says nothing
helpful; in particular, it says nothing about _how_ its reading of the
arg is different from that of `load'.
 
The doc string is inadequate on its own. The best solution would be
for it to cross-reference the Emacs manual (click a link), but that
feature was refused.  An alternative is to add some more explanation
to the doc string - about .elc, .el etc. 
 

In GNU Emacs 23.0.92.1 (i386-mingw-nt5.1.2600)
 of 2009-03-30 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 




[-- Attachment #3: Type: message/rfc822, Size: 1161 bytes --]

From: Chong Yidong <cyd@stupidchicken.com>
To: "Drew Adams" <drew.adams@oracle.com>
Cc: "'Stefan Monnier'" <monnier@IRO.UMontreal.CA>, <3125-done@emacsbugs.donarmstrong.com>
Subject: Re: bug#3125: 23.0.92; doc of load-library
Date: Sat, 15 Aug 2009 14:00:16 -0400
Message-ID: <87zla10xfz.fsf@cyd.mit.edu>

I've fixed the documentation accordingly.

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

end of thread, other threads:[~2009-08-15 18:05 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <87zla10xfz.fsf@cyd.mit.edu>
2009-04-27  4:12 ` bug#3125: 23.0.92; doc of load-library Drew Adams
2009-04-28  3:12   ` Stefan Monnier
2009-04-29 20:30   ` Stefan Monnier
2009-04-29 20:54     ` Drew Adams
2009-08-15 18:05   ` bug#3125: marked as done (23.0.92; doc of load-library) Emacs bug Tracking System

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.