From: Jim Porter <jporterbugs@gmail.com>
Date: Thu, 3 Aug 2023 04:51:18 +0000 (-0700)
Subject: * doc/lispref/package.texi (Multi-file Packages): Document ".elpaignore".
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=79db5bb62cbc8c3b6efb2eced58347b8bf450075;p=emacs.git

* doc/lispref/package.texi (Multi-file Packages): Document ".elpaignore".

(cherry picked from commit 744a10a4d722a361bc21561b4162045e4ec97ed6)
---

diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi
index 6f52a33d194..ebe578932bf 100644
--- a/doc/lispref/package.texi
+++ b/doc/lispref/package.texi
@@ -284,6 +284,13 @@ variable @code{load-file-name} (@pxref{Loading}).  Here is an example:
   (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