From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: "Emacs Lisp Packages" chapter in the Emacs manual Date: Tue, 12 May 2020 19:05:23 -0700 (PDT) Message-ID: <928a354d-e458-4221-b00b-419d52dce2f8@default> References: <11437E00-8970-4908-A900-0438A248428D@traduction-libre.org> <75254771-9303-4982-AB60-F92AF7AC6454@traduction-libre.org> <11AC1ECE-C120-4CBE-93C7-6FD82AF12299@traduction-libre.org> <18BA1545-091A-454E-B459-DEB96071D048@traduction-libre.org> <4f5da1c3-1311-44ca-80f7-942d9a0537b4@default> <0BBC80E8-7A74-4DB4-8C13-AF2AAFF04B4B@traduction-libre.org> <920E43F8-B65B-4802-97D3-F64BEBF5E8B8@traduction-libre.org> <0DE280CA-A785-4623-98B6-7C2C5EA99A86@traduction-libre.org> <12cea798-27b1-4ae1-8b87-ffaff5c2d130@default> <76D54CCC-2074-4A1B-9E87-18BC311618D1@traduction-libre.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="31264"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Stefan Monnier , Emacs developers To: Jean-Christophe Helary Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed May 13 04:06:07 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jYgmc-00081k-RY for ged-emacs-devel@m.gmane-mx.org; Wed, 13 May 2020 04:06:06 +0200 Original-Received: from localhost ([::1]:43018 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jYgmb-0000cj-U2 for ged-emacs-devel@m.gmane-mx.org; Tue, 12 May 2020 22:06:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45654) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jYgm2-000825-21 for emacs-devel@gnu.org; Tue, 12 May 2020 22:05:30 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:57168) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jYgm0-0006ME-HI for emacs-devel@gnu.org; Tue, 12 May 2020 22:05:29 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 04D2379Z052075; Wed, 13 May 2020 02:05:26 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=4qq7YH+b0LrwAvFqv2LGpuWYm46NEBgsoTJ9Fu06uNE=; b=WFvhS7/8S5GHdP+um6nRUzNPJL9yXgs9biXDae2Pz1WfQHC+I5wAxZ4ikRX+fHTI24dE 6az15l2jhA5XN7/Xe6qtLlZ45/nufeJE7wYyWA/ffJPYfKvNwZgXv2AGk/O156aQ9/31 u1C1gCXYPX6Oq9htWVUXPv/GQFEGd4InD+zAFoqPNg1Rhd3wC401rI6iJ6/6nTkVXFuM PeoD+yQsi+9l1xAgd2x15dQSSJi6mNAJ1e/8ppEuNitY3JT+Jl70+CL0MKxb7AA6Tiyp TU+fg/+6VW3GUJj0/rPIQFrKs7CA5yAfTov52RemthaMpgy/LabzSchK+bPavb2QksDT 2Q== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 3100xw9k5h-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 13 May 2020 02:05:26 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 04D23wNe080826; Wed, 13 May 2020 02:05:26 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3030.oracle.com with ESMTP id 3100ydht19-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 13 May 2020 02:05:26 +0000 Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 04D25O0l011137; Wed, 13 May 2020 02:05:25 GMT In-Reply-To: <76D54CCC-2074-4A1B-9E87-18BC311618D1@traduction-libre.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4993.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9619 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 malwarescore=0 bulkscore=0 phishscore=0 suspectscore=0 adultscore=0 mlxscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2005130016 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9619 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 lowpriorityscore=0 suspectscore=0 mlxlogscore=999 clxscore=1015 cotscore=-2147483648 mlxscore=0 phishscore=0 adultscore=0 impostorscore=0 bulkscore=0 malwarescore=0 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2005130016 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/12 22:05:27 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:250064 Archived-At: > > I don't quite understand this part of your diff: > > > > +The traditional way to install Emacs Lisp code is to either install it > > +in the Emacs Lisp @dfn{load path} or to add the path to the code to > > +the load path list. > > > > What does it mean to "install" code in `load-path'? > > And how does that differ from adding the directory or > > file of the code to `load-path' (IOW, why the "or")? >=20 > I'm just using the wording that's found in other parts of the manual. > Not trying to be fancy here :) >=20 > Emacs manual: > "If an Emacs Lisp file is installed in the Emacs Lisp load path > (defined below), you can load it by typing M-x load-library, instead of > using M-x load-file." OK, so my question is for whomever wrote that, I guess. > My understanding is that "install in the load path" means put the file > in a path that Emacs already knows vs "add the path to load path" means > make Emacs know about that new path. Maybe. Not for me to say. But if that's it then I think your text doesn't really say that, I think. I don't see anything in your text that suggests a path that Emacs already knows. > > Keep in mind that loading a library/file need not be > > something done systematically (e.g. by `require' in > > a file that gets loaded), or something done only by > > autoloading. `load-library' is a command, to let > > you load a library interactively. >=20 > Thank you. Reading the manual did not help much here. But that's ok for > now. I'm not interested in knowing all the subtelties of loading files. >=20 > > Is there some clear definition of "installing" a > > package in the doc? Probably, but I haven't checked. >=20 > Not that I can tell. I didn't see one either. But I see that the manual has more or less that same text you cited at least as far back as Emacs 20. So my bad. (I don't think of that as really "installing", but that's me.) > > [BTW, for GNU Emacs, "path" means something different. > > What you mean here is presumably the absolute file > > name (of the directory or the file itself).] >=20 > I'm pretty sure I don't know the difference. For Emacs (and GNU, I think), a "path" is the kind of thing you have as the value of your environment variable PATH: a list of directories.