From f3f8570ca5d32a49182d0e1f320f8e3c889c9ed1 Mon Sep 17 00:00:00 2001 From: Eshel Yaron Date: Sat, 15 Feb 2025 17:47:04 +0100 Subject: [PATCH] Remove some stale Texinfo references --- doc/emacs/building.texi | 6 ------ doc/emacs/custom.texi | 7 +------ doc/emacs/emacs.texi | 10 ---------- doc/emacs/glossary.texi | 2 +- doc/emacs/maintaining.texi | 3 +-- doc/emacs/programs.texi | 2 +- doc/emacs/text.texi | 3 +-- doc/emacs/trouble.texi | 3 +-- doc/lispref/elisp.texi | 11 ----------- doc/lispref/loading.texi | 2 +- doc/lispref/os.texi | 9 --------- doc/lispref/tips.texi | 10 +++++----- 12 files changed, 12 insertions(+), 56 deletions(-) diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index 4a485fe9451..489b912da71 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -1700,12 +1700,6 @@ command or function is invoked. For example: @end group @end smalllisp - Note that installing a package using @code{package-install} -(@pxref{Package Installation}) takes care of placing the package's -Lisp files in a directory where Emacs will find it, and also extends -@code{load-path} as needed, making the above manual customizations -unnecessary for such packages. - @node Lisp Eval @section Evaluating Emacs Lisp Expressions @cindex Emacs Lisp mode diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 3b1f2c69d0e..ebe796ae5ea 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -3008,12 +3008,7 @@ to have customizations take effect during Emacs startup earlier than the normal init file is processed. Such customizations can be put in the early init file, @file{~/.config/emacs/early-init.el} or @file{~/.emacs.d/early-init.el}. This file is loaded before the package system and GUI is initialized, so in it you can customize variables -that affect the package initialization process, -such as @code{package-enable-at-startup}, @code{package-load-list}, and -@code{package-user-dir}. Note that variables like @code{package-archives} -which only affect the installation of new packages, and not the process of -making already-installed packages available, may be customized in the regular -init file. @xref{Package Installation}. +that affect the package initialization process. We do not recommend that you move into @file{early-init.el} customizations that can be left in the normal init files. That is diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index 76a25affe39..47b6be189aa 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -203,7 +203,6 @@ Advanced Features * Recursive Edit:: Performing edits while within another command. * Hyperlinking:: Following links in buffers. * Amusements:: Various games and hacks. -* Packages:: Installing additional features. * Customization:: Modifying the behavior of Emacs. Recovery from Problems @@ -304,7 +303,6 @@ Help * Key Help:: Asking what a key does in Emacs. * Name Help:: Asking about a command, variable or function name. * Help Mode:: Special features of Help mode and Help buffers. -* Package Keywords:: Finding Lisp libraries by keywords (topics). * Language Help:: Help relating to international language support. * Misc Help:: Other help commands. * Help Files:: Commands to display auxiliary help files. @@ -1119,13 +1117,6 @@ Hyperlinking and Navigation Features * Browse-URL:: Following URLs. * Goto Address mode:: Activating URLs. -Emacs Lisp Packages - -* Package Menu:: Buffer for viewing and managing packages. -* Package Statuses:: Which statuses a package can have. -* Package Installation:: Options for package installation. -* Package Files:: Where packages are installed. - Customization * Easy Customization:: Convenient way to browse and change settings. @@ -1631,7 +1622,6 @@ Lisp programming. @include rmail.texi @c Includes picture-xtra.texi @include misc.texi -@include package.texi @include custom.texi @include trouble.texi diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi index a5e5b4577fc..f3dd8e67497 100644 --- a/doc/emacs/glossary.texi +++ b/doc/emacs/glossary.texi @@ -1055,7 +1055,7 @@ it to one side. @xref{Minor Modes}. @item Package A package is a collection of Lisp code that you download and automatically install from within Emacs. Packages provide a -convenient way to add new features. @xref{Packages}. +convenient way to add new features. @anchor{Glossary---Page} @item Page diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index e89d510ae19..7d8f0c03edf 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi @@ -3543,8 +3543,7 @@ they are applicable, e.g., by checking the value of @code{major-mode}. @findex debbugs-browse-mode If your project's issues are tracked on the server @url{https://debbugs.gnu.org}, you can browse and reply to reports -directly in Emacs using the @code{debbugs} package, which can be -downloaded via the Package Menu (@pxref{Packages}). This package adds +directly in Emacs using the @code{debbugs} package. This package adds the minor mode @code{debbugs-browse-mode}, which can be activated on top of @code{bug-reference-mode} and @code{bug-reference-prog-mode} as follows: diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index 4341c441a37..dbc7f84c13b 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -105,7 +105,7 @@ various sorts of configuration files. Ideally, Emacs should have a major mode for each programming language that you might want to edit. If it doesn't have a mode for your favorite language, the mode might be implemented in a package not -distributed with Emacs (@pxref{Packages}); or you can contribute one. +distributed with Emacs; or you can contribute one. @cindex tree-sitter library, supported major modes If Emacs has been compiled with the @samp{tree-sitter} library, it diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 5635171f5cf..392d10cb4cb 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -1673,8 +1673,7 @@ The AUC@TeX{} package provides more advanced features for editing @TeX{} and its related formats, including the ability to preview @TeX{} equations within Emacs buffers. Unlike Bib@TeX{} mode and the Ref@TeX{} package, AUC@TeX{} is not distributed with Emacs by default. -It can be downloaded via the Package Menu (@pxref{Packages}); once -installed, see +Once installed, see @ifinfo @ref{Top,The AUC@TeX{} Manual,,auctex}. @end ifinfo diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index 2211369b121..cc5817a68d4 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi @@ -604,8 +604,7 @@ complex search criteria, use @cindex debbugs package Instead of browsing the bug tracker as a web page, you can browse it -from Emacs using the @code{debbugs} package, which can be downloaded -via the Package Menu (@pxref{Packages}). This package provides the +from Emacs using the @code{debbugs} package. This package provides the command @kbd{M-x debbugs-gnu} to list bugs, and @kbd{M-x debbugs-gnu-search} to search for a specific bug. User tags, applied by the Emacs maintainers, are shown by @kbd{M-x debbugs-gnu-usertags}. diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index 18489206ee0..0a30ed26f2b 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -232,8 +232,6 @@ To view this manual in other formats, click * System Interface:: Getting the user id, system type, environment variables, and other such things. -* Packaging:: Preparing Lisp code for distribution. - Appendices * Antinews:: Info for users downgrading to Emacs 29. @@ -1632,13 +1630,6 @@ Terminal Input * Input Modes:: Options for how input is processed. * Recording Input:: Saving histories of recent or all input events. -Preparing Lisp code for distribution - -* Packaging Basics:: The basic concepts of Emacs Lisp packages. -* Simple Packages:: How to package a single .el file. -* Multi-file Packages:: How to package multiple files. -* Package Archives:: Maintaining package archives. - Tips and Conventions * Coding Conventions:: Conventions for clean and robust programs. @@ -1738,8 +1729,6 @@ Object Internals @include display.texi @include os.texi -@include package.texi - @c appendices @include anti.texi diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index 43954245a35..5466ed2796e 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -391,7 +391,7 @@ containing a file named @file{.nosearch}. Next, Emacs adds any extra load directories that you specify using the @option{-L} command-line option (@pxref{Action Arguments,,,emacs, The GNU Emacs Manual}). It also adds the directories where optional -packages are installed, if any (@pxref{Packaging Basics}). +packages are installed, if any. It is common to add code to one's init file (@pxref{Init File}) to add one or more directories to @code{load-path}. For example: diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 6f1bb000a6b..21f92706a4c 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -100,15 +100,6 @@ GNU Emacs Manual}). This is not done if the options @samp{-q}, was specified, Emacs looks for the init file in that user's home directory instead. -@item -It calls the function @code{package-activate-all} to activate any -optional Emacs Lisp package that has been installed. @xref{Packaging -Basics}. However, Emacs doesn't activate the packages when -@code{package-enable-at-startup} is @code{nil} or when it's started -with one of the options @samp{-q}, @samp{-Q}, or @samp{--batch}. To -activate the packages in the latter case, @code{package-activate-all} -should be called explicitly (e.g., via the @samp{--funcall} option). - @vindex initial-window-system@r{, and startup} @findex window-system-initialization @item diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index d48921a0bf8..ed9a6feb305 100644 --- a/doc/lispref/tips.texi +++ b/doc/lispref/tips.texi @@ -1165,14 +1165,14 @@ deprecated alternative to @samp{URL}. If @samp{Version} is not suitable for use by the package manager, then a package can define @samp{Package-Version}; it will be used instead. This is handy if @samp{Version} is an RCS id or something else that -cannot be parsed by @code{version-to-list}. @xref{Packaging Basics}. +cannot be parsed by @code{version-to-list}. @item Package-Requires If this exists, it names packages on which the current package depends -for proper operation. @xref{Packaging Basics}. This is used by the -package manager both at download time (to ensure that a complete set -of packages is downloaded) and at activation time (to ensure that a -package is only activated if all its dependencies have been). +for proper operation. This is used by the package manager both at +download time (to ensure that a complete set of packages is downloaded) +and at activation time (to ensure that a package is only activated if +all its dependencies have been). Its format is a list of lists on a single line. The @code{car} of each sub-list is the name of a package, as a symbol. The @code{cadr} -- 2.39.5