all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual
@ 2023-08-03  4:56 Jim Porter
  2023-08-03  9:02 ` Eli Zaretskii
  2024-01-10 21:49 ` Stefan Kangas
  0 siblings, 2 replies; 31+ messages in thread
From: Jim Porter @ 2023-08-03  4:56 UTC (permalink / raw)
  To: 65027; +Cc: philipk

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

X-Debbugs-Cc: philipk@posteo.net

 From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't 
documented. (It turns out it's mentioned briefly in the GNU ELPA README, 
but that's the only place I could find.) Here's a small patch to 
document this in the Package section of the Emacs Lisp manual.

This is just a first pass at documenting this feature, so I'm happy to 
add further details if anyone thinks it's warranted.

[-- Attachment #2: 0001-doc-lispref-package.texi-Multi-file-Packages-Documen.patch --]
[-- Type: text/plain, Size: 1062 bytes --]

From a5dc5f63003aea4bda4f382ec46c0556edb14f1a Mon Sep 17 00:00:00 2001
From: Jim Porter <jporterbugs@gmail.com>
Date: Wed, 2 Aug 2023 21:51:18 -0700
Subject: [PATCH] * doc/lispref/package.texi (Multi-file Packages): Document
 ".elpaignore".

---
 doc/lispref/package.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi
index 2952e7dfcfc..ce29b4be72a 100644
--- a/doc/lispref/package.texi
+++ b/doc/lispref/package.texi
@@ -284,6 +284,13 @@ Multi-file Packages
   (expand-file-name file superfrobnicator-base))
 @end smallexample
 
+  If your project contains files that you don't wish to distribute to
+users (e.g.@: regression tests), you can add them to an
+@file{.elpaignore} file.  In this file, each line lists a file or
+wildcard matching files to ignore when producing your package's tar
+file on ELPA.  (ELPA will pass this file to @command{tar} with the
+@code{-X} option.)
+
 @node Package Archives
 @section Creating and Maintaining Package Archives
 @cindex package archive
-- 
2.25.1


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

end of thread, other threads:[~2024-01-28  7:08 UTC | newest]

Thread overview: 31+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-08-03  4:56 bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Jim Porter
2023-08-03  9:02 ` Eli Zaretskii
2023-08-03 13:36   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-08-03 17:24     ` Jim Porter
2023-08-03 19:09       ` Philip Kaludercic
2023-08-03 21:21       ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-08-03 22:02         ` Jim Porter
2023-08-03 22:41           ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-08-04  3:11             ` Jim Porter
2023-09-03 11:18               ` Stefan Kangas
2023-09-06  1:56                 ` Jim Porter
2023-09-06  2:22                   ` Corwin Brust
2023-09-19 13:29                     ` Corwin Brust
2023-09-19 13:53                       ` Protesilaos Stavrou
2023-09-20 10:35                   ` Protesilaos Stavrou
2023-09-21  1:37                     ` Stefan Kangas
2023-08-04  5:42           ` Eli Zaretskii
2023-08-05  1:58       ` Richard Stallman
2023-08-05  2:36         ` Corwin Brust
2023-08-05  6:03           ` Jim Porter
2023-08-05  6:45           ` Eli Zaretskii
2023-08-05 13:17           ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-08-05  6:43         ` Eli Zaretskii
2024-01-10 21:49 ` Stefan Kangas
2024-01-11 19:35   ` Jim Porter
2024-01-27 20:34     ` Jim Porter
2024-01-28  2:42       ` Stefan Kangas
2024-01-28  5:46       ` Eli Zaretskii
2024-01-28  5:49         ` Stefan Kangas
2024-01-28  7:08           ` Eli Zaretskii
     [not found]   ` <87v8802yrp.fsf@protesilaos.com>
2024-01-11 19:38     ` Stefan Kangas

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.