dot/stow
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Rebuild based on upstream Stow 2.4.0

Browse source
This commit is contained in:
Danielle McLean 2024-06-03 13:08:10 +10:00
parent be6413057e
commit 91c35521c9
Signed by: 00dani
GPG key ID: 6854781A0488421C
39 changed files with 1968 additions and 1231 deletions
Download patch file Download diff file Expand all files Collapse all files

62
dot-local/share/doc/stow/README.md
View file

@ -60,6 +60,56 @@ You can get the latest information about Stow from the home page:
http://www.gnu.org/software/stow/
Installation
------------
See [`INSTALL.md`](INSTALL.md) for installation instructions.
Documentation
-------------
Documentation for Stow is available
[online](https://www.gnu.org/software/stow/manual/), as is
[documentation for most GNU
software](https://www.gnu.org/software/manual/). Once you have Stow
installed, you may also find more information about Stow by running
`info stow` or `man stow`, or by looking at `/usr/share/doc/stow/`,
`/usr/local/doc/stow/`, or similar directories on your system. A
brief summary is available by running `stow --help`.
Mailing lists
-------------
Stow has the following mailing lists:
- [help-stow](https://lists.gnu.org/mailman/listinfo/help-stow) is for
general user help and discussion.
- [stow-devel](https://lists.gnu.org/mailman/listinfo/stow-devel) is
used to discuss most aspects of Stow, including development and
enhancement requests.
- [bug-stow](https://lists.gnu.org/mailman/listinfo/bug-stow) is for
bug reports.
Announcements about Stow are posted to
[info-stow](http://lists.gnu.org/mailman/listinfo/info-stow) and also,
as with most other GNU software, to
[info-gnu](http://lists.gnu.org/mailman/listinfo/info-gnu)
([archive](http://lists.gnu.org/archive/html/info-gnu/)).
Security reports that should not be made immediately public can be
sent directly to the maintainer. If there is no response to an urgent
issue, you can escalate to the general
[security](http://lists.gnu.org/mailman/listinfo/security) mailing
list for advice.
The Savannah project also has a [mailing
lists](https://savannah.gnu.org/mail/?group=stow) page.
Getting involved
----------------
Please see the [`CONTRIBUTING.md` file](CONTRIBUTING.md).
License
-------
@ -71,18 +121,6 @@ are permitted in any medium without royalty provided the copyright
notice and this notice are preserved. This file is offered as-is,
without any warranty.
Installation
------------
See [`INSTALL.md`](INSTALL.md) for installation instructions.
Feedback
--------
Please do send comments, questions, and constructive criticism. The
mailing lists and any other communication channels are detailed on the
above home page.
Brief history and authorship
----------------------------

172
dot-local/share/doc/stow/manual-single.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -84,7 +84,7 @@ ul.toc-numbered-mark {list-style: none}
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a class="top" id="SEC_Top"></a>
<p>This manual describes GNU Stow 2.3.2-fixbug56727 (2 November 2023), a
<p>This manual describes GNU Stow 2.4.0 (3 June 2024), a
symlink farm manager which takes distinct sets of software and/or data
located in separate directories on the filesystem, and makes them
appear to be installed in a single directory tree.
@ -124,7 +124,7 @@ appear to be installed in a single directory tree.
<li><a id="toc-Multiple-Stow-Directories-1" href="#Multiple-Stow-Directories">9 Multiple Stow Directories</a></li>
<li><a id="toc-Target-Maintenance-1" href="#Target-Maintenance">10 Target Maintenance</a></li>
<li><a id="toc-Resource-Files-1" href="#Resource-Files">11 Resource Files</a></li>
<li><a id="toc-Compile_002dtime-vs-Install_002dtime-1" href="#Compile_002dtime-vs-Install_002dtime">12 Compile-time vs Install-time</a>
<li><a id="toc-Compile_002dtime-vs_002e-Install_002dtime-1" href="#Compile_002dtime-vs_002e-Install_002dtime">12 Compile-time vs. Install-time</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Advice-on-changing-compilation-and-installation-parameters" href="#Advice-on-changing-compilation-and-installation-parameters">12.1 Advice on changing compilation and installation parameters</a></li>
<li><a id="toc-GNU-Emacs-1" href="#GNU-Emacs">12.2 GNU Emacs</a></li>
@ -240,9 +240,12 @@ to be installed in a particular directory structure &mdash; e.g., with
</p>
<a class="index-entry-id" id="index-target-directory"></a>
<p>A <em class="dfn">target directory</em> is the root of a tree in which one or more
packages wish to <em class="emph">appear</em> to be installed. A common, but by no
means the only such location is <samp class="file">/usr/local</samp>. The examples in this
manual will use <samp class="file">/usr/local</samp> as the target directory.
packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
common choice for this, but by no means the only such location. Another
common choice is <samp class="file">~</samp> (i.e. the user&rsquo;s <code class="code">$HOME</code> directory) in
the case where Stow is being used to manage the user&rsquo;s configuration
(&ldquo;dotfiles&rdquo;) and other files in their <code class="code">$HOME</code>. The examples in
this manual will use <samp class="file">/usr/local</samp> as the target directory.
</p>
<a class="index-entry-id" id="index-stow-directory"></a>
<p>A <em class="dfn">stow directory</em> is the root of a tree containing separate
@ -260,6 +263,11 @@ installation image for Perl includes: a <samp class="file">bin</samp> directory
containing Texinfo documentation; a <samp class="file">lib/perl</samp> directory containing
Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> This is a <em class="emph">pre-</em>installation image which exists even before Stow
has installed any symlinks into the target directory which point to it.
</p></blockquote>
<a class="index-entry-id" id="index-package-directory"></a>
<a class="index-entry-id" id="index-package-name"></a>
<p>A <em class="dfn">package directory</em> is the root of a tree containing the
@ -275,16 +283,62 @@ target directory, <samp class="file">/usr/local/stow</samp> is the stow director
<samp class="file">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image.
</p>
<a class="index-entry-id" id="index-symlink"></a>
<a class="anchor" id="symlink"></a><a class="index-entry-id" id="index-symlink"></a>
<a class="index-entry-id" id="index-symlink-source"></a>
<a class="index-entry-id" id="index-symlink-destination"></a>
<a class="index-entry-id" id="index-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-symlink"></a>
<p>A <em class="dfn">symlink</em> is a symbolic link. A symlink can be <em class="dfn">relative</em> or
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
<p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
another location on the filesystem called the <em class="dfn">symlink destination</em>.
There is no guarantee that the destination actually exists.
</p>
<p>In general, symlinks can be <em class="dfn">relative</em> or <em class="dfn">absolute</em>. A symlink
is absolute when the destination names a full path; that is, one
starting from <samp class="file">/</samp>. A symlink is relative when the destination
names a relative path; that is, one not starting from <samp class="file">/</samp>. The
destination of a relative symlink is computed starting from the
symlink&rsquo;s own directory, i.e. the directory containing the symlink
source.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> Stow only creates symlinks within the target directory which point to
locations <em class="emph">outside</em> the target directory and inside the stow
directory.
</p>
<p>Consequently, we avoid referring to symlink destinations as symlink
<em class="emph">targets</em>, since this would result in the word &ldquo;target&rdquo; having
two different meanings:
</p>
<ol class="enumerate">
<li> the target directory, i.e. the directory into which Stow targets
installation, where symlinks are managed by Stow, and
</li><li> the destinations of those symlinks.
</li></ol>
<p>If we did not avoid the second meaning of &ldquo;target&rdquo;, then it would lead
to confusing language, such as describing Stow as installing symlinks
into the target directory which point to targets <em class="emph">outside</em> the
target directory.
</p>
<p>Similarly, the word &ldquo;source&rdquo; can have two different meanings in this
context:
</p>
<ol class="enumerate">
<li> the installation image, or some of its contents, and
</li><li> the location of symlinks (the &ldquo;source&rdquo; of the link, vs. its
destination).
</li></ol>
<p>Therefore it should also be avoided, or at least care taken to ensure
that the meaning is not ambiguous.
</p>
</blockquote>
<hr>
</div>
<div class="chapter-level-extent" id="Invoking-Stow">
@ -453,13 +507,15 @@ doing. Verbosity levels are from 0 to 5; 0 is the default. Using
</dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only
directories specified in the <em class="dfn">installation image</em> are scanned
during an unstow operation. Scanning the whole tree can be
prohibitive if your target tree is very large. This option restores
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the
<code class="command">chkstow</code> utility may be a better way of ensuring that your
installation does not have any dangling symlinks (see <a class="pxref" href="#Target-Maintenance">Target Maintenance</a>).
<dd><p>Scan the whole target tree when unstowing. By default, only directories
specified in the <em class="dfn">installation image</em> are scanned during an unstow
operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large, but on the other hand has
the advantage of unstowing previously stowed links which are no longer
present in the installation image and therefore orphaned. This option
restores the legacy behaviour; however, the <samp class="option">--badlinks</samp> option
to the <code class="command">chkstow</code> utility may be a better way of ensuring that
your installation does not have any dangling symlinks (see <a class="pxref" href="#Target-Maintenance">Target Maintenance</a>).
</p>
</dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>
@ -587,6 +643,7 @@ _darcs
\.git
\.gitignore
\.gitmodules
.+~ # emacs backup files
\#.*\# # emacs autosave files
@ -903,7 +960,7 @@ version 21.3 to 21.4a you can now do the following:
invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated
and merged before being executed (see <a class="pxref" href="#Deferred-Operation">Deferred Operation</a>), so the
amount of of time in which GNU Emacs is unavailable is minimised.
amount of time in which GNU Emacs is unavailable is minimised.
</p>
<p>You can mix and match any number of actions, for example,
</p>
@ -997,7 +1054,7 @@ directory.
<div class="chapter-level-extent" id="Resource-Files">
<div class="nav-panel">
<p>
Next: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="n" rel="next">Compile-time vs Install-time</a>, Previous: <a href="#Target-Maintenance" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="n" rel="next">Compile-time vs. Install-time</a>, Previous: <a href="#Target-Maintenance" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2>
<a class="index-entry-id" id="index-resource-files"></a>
@ -1066,12 +1123,12 @@ resource file.
</p>
<hr>
</div>
<div class="chapter-level-extent" id="Compile_002dtime-vs-Install_002dtime">
<div class="chapter-level-extent" id="Compile_002dtime-vs_002e-Install_002dtime">
<div class="nav-panel">
<p>
Next: <a href="#Bootstrapping" accesskey="n" rel="next">Bootstrapping</a>, Previous: <a href="#Resource-Files" accesskey="p" rel="prev">Resource Files</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Compile_002dtime-vs-Install_002dtime-1"><span>12 Compile-time vs Install-time<a class="copiable-link" href="#Compile_002dtime-vs-Install_002dtime-1"> &para;</a></span></h2>
<h2 class="chapter" id="Compile_002dtime-vs_002e-Install_002dtime-1"><span>12 Compile-time vs. Install-time<a class="copiable-link" href="#Compile_002dtime-vs_002e-Install_002dtime-1"> &para;</a></span></h2>
<p>Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. <samp class="file">/usr/local/stow/perl</samp>)
@ -1155,7 +1212,7 @@ following sections.
<div class="section-level-extent" id="GNU-Emacs">
<div class="nav-panel">
<p>
Next: <a href="#Other-FSF-Software" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="p" rel="prev">Compile-time vs Install-time</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Other-FSF-Software" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="p" rel="prev">Compile-time vs. Install-time</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="GNU-Emacs-1"><span>12.2 GNU Emacs<a class="copiable-link" href="#GNU-Emacs-1"> &para;</a></span></h3>
@ -1191,7 +1248,7 @@ make do-install prefix=/usr/local/stow/emacs
<div class="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel">
<p>
Next: <a href="#Cygnus-Software" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="#GNU-Emacs" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Cygnus-Software" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="#GNU-Emacs" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Other-FSF-Software-1"><span>12.3 Other FSF Software<a class="copiable-link" href="#Other-FSF-Software-1"> &para;</a></span></h3>
@ -1217,7 +1274,7 @@ and &lsquo;<samp class="samp">make install</samp>&rsquo; steps to work correctly
<div class="section-level-extent" id="Cygnus-Software">
<div class="nav-panel">
<p>
Next: <a href="#Perl-and-Perl-5-Modules" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="#Other-FSF-Software" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Perl-and-Perl-5-Modules" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="#Other-FSF-Software" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Cygnus-Software-1"><span>12.4 Cygnus Software<a class="copiable-link" href="#Cygnus-Software-1"> &para;</a></span></h3>
@ -1251,7 +1308,7 @@ install manually.
<div class="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel">
<p>
Previous: <a href="#Cygnus-Software" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Previous: <a href="#Cygnus-Software" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Perl-and-Perl-5-Modules-1"><span>12.5 Perl and Perl 5 Modules<a class="copiable-link" href="#Perl-and-Perl-5-Modules-1"> &para;</a></span></h3>
@ -1356,7 +1413,7 @@ find cpan.* \( -name .exists -o -name perllocal.pod \) -print | \
<div class="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel">
<p>
Next: <a href="#Reporting-Bugs" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="p" rel="prev">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Reporting-Bugs" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="p" rel="prev">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2>
@ -1395,9 +1452,27 @@ Next: <a href="#Known-Bugs" accesskey="n" rel="next">Known Bugs</a>, Previous: <
</div>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2>
<p>Please send bug reports to the current maintainers by electronic
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please
include:
<p>You can report bugs to the current maintainers in one of three ways:
</p>
<ol class="enumerate">
<li> Send e-mail to <a class="email" href="mailto:bug-stow@gnu.org">bug-stow@gnu.org</a>.
</li><li> File an issue in <a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug tracker</a>.
</li><li> File an issue in
<a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub project</a>.
</li></ol>
<p>While GitHub is arguably the most convenient of these three options, it
<a class="uref" href="https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub">is not the most ethical or freedom-preserving way to host software
projects</a>. Therefore the GitHub project may be
<a class="uref" href="https://github.com/aspiers/stow/issues/43">moved to a more ethical
hosting service</a> in the future.
</p>
<p>Before reporting a bug, it is recommended to check whether it is already
known, so please first see <a class="pxref" href="#Known-Bugs">Known Bugs</a>.
</p>
<p>When reporting a new bug, please include:
</p>
<ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;);
@ -1412,12 +1487,13 @@ include:
</li><li>the precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by
adding &lsquo;<samp class="samp">--verbose=3</samp>&rsquo; to the Stow command line).
adding &lsquo;<samp class="samp">--verbose=5</samp>&rsquo; to the Stow command line).
</li></ul>
<p>If you are really keen, consider developing a minimal test case and
creating a new test. See the <samp class="file">t/</samp> directory in the source for
lots of examples.
creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p>
<p>Before reporting a bug, please read the manual carefully, especially
<a class="ref" href="#Known-Bugs">Known Bugs</a>, to see whether you&rsquo;re encountering
@ -1433,10 +1509,20 @@ Next: <a href="#GNU-General-Public-License" accesskey="n" rel="next">GNU General
</div>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2>
<p>There are no known bugs in Stow version 2.3.2-fixbug56727!
If you think you have found one, please see <a class="pxref" href="#Reporting-Bugs">Reporting Bugs</a>.
<p>Known bugs can be found in the following locations:
</p>
<ul class="itemize mark-bullet">
<li><a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub issue tracker</a>
</li><li><a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug
tracker</a>
</li><li>the <a class="uref" href="https://lists.gnu.org/archive/html/bug-stow/">bug-stow list
archives</a>
</li></ul>
<p>If you think you have found a new bug, please see <a class="pxref" href="#Reporting-Bugs">Reporting Bugs</a>.
</p>
<hr>
</div>
<div class="unnumbered-level-extent" id="GNU-General-Public-License">
@ -2236,6 +2322,8 @@ Previous: <a href="#GNU-General-Public-License" accesskey="p" rel="prev">GNU Gen
<tr><td></td><td class="printindex-index-entry"><a href="#index-splitting-open-folded-trees">splitting open folded trees</a></td><td class="printindex-index-section"><a href="#Installing-Packages">Installing Packages</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-stow-directory">stow directory</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink">symlink</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink-destination">symlink destination</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink-source">symlink source</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-target-directory">target directory</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>

16
dot-local/share/doc/stow/manual-split/Bootstrapping.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -49,7 +49,7 @@ approved by the Free Software Foundation. -->
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Reporting-Bugs.html" rel="next" title="Reporting Bugs">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="prev" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="prev" title="Compile-time vs. Install-time">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel">
<p>
Next: <a href="Reporting-Bugs.html" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Reporting-Bugs.html" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2>

22
dot-local/share/doc/stow/manual-split/Compile_002dtime-vs-Install_002dtime.html → dot-local/share/doc/stow/manual-split/Compile_002dtime-vs_002e-Install_002dtime.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -35,10 +35,10 @@ Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the Free Software Foundation. -->
<title>Compile-time vs Install-time (Stow)</title>
<title>Compile-time vs. Install-time (Stow)</title>
<meta name="description" content="Compile-time vs Install-time (Stow)">
<meta name="keywords" content="Compile-time vs Install-time (Stow)">
<meta name="description" content="Compile-time vs. Install-time (Stow)">
<meta name="keywords" content="Compile-time vs. Install-time (Stow)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@ -63,13 +63,13 @@ span:hover a.copiable-link {visibility: visible}
</head>
<body lang="en">
<div class="chapter-level-extent" id="Compile_002dtime-vs-Install_002dtime">
<div class="chapter-level-extent" id="Compile_002dtime-vs_002e-Install_002dtime">
<div class="nav-panel">
<p>
Next: <a href="Bootstrapping.html" accesskey="n" rel="next">Bootstrapping</a>, Previous: <a href="Resource-Files.html" accesskey="p" rel="prev">Resource Files</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Compile_002dtime-vs-Install_002dtime-1"><span>12 Compile-time vs Install-time<a class="copiable-link" href="#Compile_002dtime-vs-Install_002dtime-1"> &para;</a></span></h2>
<h2 class="chapter" id="Compile_002dtime-vs_002e-Install_002dtime-1"><span>12 Compile-time vs. Install-time<a class="copiable-link" href="#Compile_002dtime-vs_002e-Install_002dtime-1"> &para;</a></span></h2>
<p>Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. <samp class="file">/usr/local/stow/perl</samp>)

12
dot-local/share/doc/stow/manual-split/Conflicts.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

16
dot-local/share/doc/stow/manual-split/Cygnus-Software.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Perl-and-Perl-5-Modules.html" rel="next" title="Perl and Perl 5 Modules">
<link href="Other-FSF-Software.html" rel="prev" title="Other FSF Software">
<style type="text/css">
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Cygnus-Software">
<div class="nav-panel">
<p>
Next: <a href="Perl-and-Perl-5-Modules.html" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="Other-FSF-Software.html" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Perl-and-Perl-5-Modules.html" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="Other-FSF-Software.html" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Cygnus-Software-1"><span>12.4 Cygnus Software<a class="copiable-link" href="#Cygnus-Software-1"> &para;</a></span></h3>

12
dot-local/share/doc/stow/manual-split/Deferred-Operation.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Deleting-Packages.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

18
dot-local/share/doc/stow/manual-split/GNU-Emacs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,9 +47,9 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Other-FSF-Software.html" rel="next" title="Other FSF Software">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="prev" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="prev" title="Compile-time vs. Install-time">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="GNU-Emacs">
<div class="nav-panel">
<p>
Next: <a href="Other-FSF-Software.html" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs Install-time</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Other-FSF-Software.html" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs. Install-time</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="GNU-Emacs-1"><span>12.2 GNU Emacs<a class="copiable-link" href="#GNU-Emacs-1"> &para;</a></span></h3>

12
dot-local/share/doc/stow/manual-split/GNU-General-Public-License.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Installing-Packages.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Introduction.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

28
dot-local/share/doc/stow/manual-split/Invoking-Stow.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -229,13 +229,15 @@ doing. Verbosity levels are from 0 to 5; 0 is the default. Using
</dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only
directories specified in the <em class="dfn">installation image</em> are scanned
during an unstow operation. Scanning the whole tree can be
prohibitive if your target tree is very large. This option restores
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the
<code class="command">chkstow</code> utility may be a better way of ensuring that your
installation does not have any dangling symlinks (see <a class="pxref" href="Target-Maintenance.html">Target Maintenance</a>).
<dd><p>Scan the whole target tree when unstowing. By default, only directories
specified in the <em class="dfn">installation image</em> are scanned during an unstow
operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large, but on the other hand has
the advantage of unstowing previously stowed links which are no longer
present in the installation image and therefore orphaned. This option
restores the legacy behaviour; however, the <samp class="option">--badlinks</samp> option
to the <code class="command">chkstow</code> utility may be a better way of ensuring that
your installation does not have any dangling symlinks (see <a class="pxref" href="Target-Maintenance.html">Target Maintenance</a>).
</p>
</dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>

12
dot-local/share/doc/stow/manual-split/Justification-For-Yet-Another-Set-Of-Ignore-Files.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

27
dot-local/share/doc/stow/manual-split/Known-Bugs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -54,6 +54,7 @@ approved by the Free Software Foundation. -->
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
span:hover a.copiable-link {visibility: visible}
ul.mark-bullet {list-style-type: disc}
-->
</style>
@ -69,10 +70,20 @@ Next: <a href="GNU-General-Public-License.html" accesskey="n" rel="next">GNU Gen
<hr>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2>
<p>There are no known bugs in Stow version 2.3.2-fixbug56727!
If you think you have found one, please see <a class="pxref" href="Reporting-Bugs.html">Reporting Bugs</a>.
<p>Known bugs can be found in the following locations:
</p>
<ul class="itemize mark-bullet">
<li><a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub issue tracker</a>
</li><li><a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug
tracker</a>
</li><li>the <a class="uref" href="https://lists.gnu.org/archive/html/bug-stow/">bug-stow list
archives</a>
</li></ul>
<p>If you think you have found a new bug, please see <a class="pxref" href="Reporting-Bugs.html">Reporting Bugs</a>.
</p>
</div>

14
dot-local/share/doc/stow/manual-split/Mixing-Operations.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -86,7 +86,7 @@ version 21.3 to 21.4a you can now do the following:
invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated
and merged before being executed (see <a class="pxref" href="Conflicts.html#Deferred-Operation">Deferred Operation</a>), so the
amount of of time in which GNU Emacs is unavailable is minimised.
amount of time in which GNU Emacs is unavailable is minimised.
</p>
<p>You can mix and match any number of actions, for example,
</p>

12
dot-local/share/doc/stow/manual-split/Motivation-For-Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Multiple-Stow-Directories.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

16
dot-local/share/doc/stow/manual-split/Other-FSF-Software.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Cygnus-Software.html" rel="next" title="Cygnus Software">
<link href="GNU-Emacs.html" rel="prev" title="GNU Emacs">
<style type="text/css">
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel">
<p>
Next: <a href="Cygnus-Software.html" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="GNU-Emacs.html" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Cygnus-Software.html" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="GNU-Emacs.html" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Other-FSF-Software-1"><span>12.3 Other FSF Software<a class="copiable-link" href="#Other-FSF-Software-1"> &para;</a></span></h3>

18
dot-local/share/doc/stow/manual-split/Perl-and-Perl-5-Modules.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Cygnus-Software.html" rel="prev" title="Cygnus Software">
<style type="text/css">
<!--
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel">
<p>
Previous: <a href="Cygnus-Software.html" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Previous: <a href="Cygnus-Software.html" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Perl-and-Perl-5-Modules-1"><span>12.5 Perl and Perl 5 Modules<a class="copiable-link" href="#Perl-and-Perl-5-Modules-1"> &para;</a></span></h3>
@ -169,7 +169,7 @@ find cpan.* \( -name .exists -o -name perllocal.pod \) -print | \
<hr>
<div class="nav-panel">
<p>
Previous: <a href="Cygnus-Software.html">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Previous: <a href="Cygnus-Software.html">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>

43
dot-local/share/doc/stow/manual-split/Reporting-Bugs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -70,9 +70,27 @@ Next: <a href="Known-Bugs.html" accesskey="n" rel="next">Known Bugs</a>, Previou
<hr>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2>
<p>Please send bug reports to the current maintainers by electronic
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please
include:
<p>You can report bugs to the current maintainers in one of three ways:
</p>
<ol class="enumerate">
<li> Send e-mail to <a class="email" href="mailto:bug-stow@gnu.org">bug-stow@gnu.org</a>.
</li><li> File an issue in <a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug tracker</a>.
</li><li> File an issue in
<a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub project</a>.
</li></ol>
<p>While GitHub is arguably the most convenient of these three options, it
<a class="uref" href="https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub">is not the most ethical or freedom-preserving way to host software
projects</a>. Therefore the GitHub project may be
<a class="uref" href="https://github.com/aspiers/stow/issues/43">moved to a more ethical
hosting service</a> in the future.
</p>
<p>Before reporting a bug, it is recommended to check whether it is already
known, so please first see <a class="pxref" href="Known-Bugs.html">Known Bugs</a>.
</p>
<p>When reporting a new bug, please include:
</p>
<ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;);
@ -87,12 +105,13 @@ include:
</li><li>the precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by
adding &lsquo;<samp class="samp">--verbose=3</samp>&rsquo; to the Stow command line).
adding &lsquo;<samp class="samp">--verbose=5</samp>&rsquo; to the Stow command line).
</li></ul>
<p>If you are really keen, consider developing a minimal test case and
creating a new test. See the <samp class="file">t/</samp> directory in the source for
lots of examples.
creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p>
<p>Before reporting a bug, please read the manual carefully, especially
<a class="ref" href="Known-Bugs.html">Known Bugs</a>, to see whether you&rsquo;re encountering

18
dot-local/share/doc/stow/manual-split/Resource-Files.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -48,7 +48,7 @@ approved by the Free Software Foundation. -->
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="next" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="next" title="Compile-time vs. Install-time">
<link href="Target-Maintenance.html" rel="prev" title="Target Maintenance">
<style type="text/css">
<!--
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="chapter-level-extent" id="Resource-Files">
<div class="nav-panel">
<p>
Next: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="n" rel="next">Compile-time vs Install-time</a>, Previous: <a href="Target-Maintenance.html" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="n" rel="next">Compile-time vs. Install-time</a>, Previous: <a href="Target-Maintenance.html" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2>
@ -137,7 +137,7 @@ resource file.
<hr>
<div class="nav-panel">
<p>
Next: <a href="Compile_002dtime-vs-Install_002dtime.html">Compile-time vs Install-time</a>, Previous: <a href="Target-Maintenance.html">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Compile_002dtime-vs_002e-Install_002dtime.html">Compile-time vs. Install-time</a>, Previous: <a href="Target-Maintenance.html">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>

12
dot-local/share/doc/stow/manual-split/Target-Maintenance.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

86
dot-local/share/doc/stow/manual-split/Terminology.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -77,9 +77,12 @@ to be installed in a particular directory structure &mdash; e.g., with
</p>
<a class="index-entry-id" id="index-target-directory"></a>
<p>A <em class="dfn">target directory</em> is the root of a tree in which one or more
packages wish to <em class="emph">appear</em> to be installed. A common, but by no
means the only such location is <samp class="file">/usr/local</samp>. The examples in this
manual will use <samp class="file">/usr/local</samp> as the target directory.
packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
common choice for this, but by no means the only such location. Another
common choice is <samp class="file">~</samp> (i.e. the user&rsquo;s <code class="code">$HOME</code> directory) in
the case where Stow is being used to manage the user&rsquo;s configuration
(&ldquo;dotfiles&rdquo;) and other files in their <code class="code">$HOME</code>. The examples in
this manual will use <samp class="file">/usr/local</samp> as the target directory.
</p>
<a class="index-entry-id" id="index-stow-directory"></a>
<p>A <em class="dfn">stow directory</em> is the root of a tree containing separate
@ -97,6 +100,11 @@ installation image for Perl includes: a <samp class="file">bin</samp> directory
containing Texinfo documentation; a <samp class="file">lib/perl</samp> directory containing
Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> This is a <em class="emph">pre-</em>installation image which exists even before Stow
has installed any symlinks into the target directory which point to it.
</p></blockquote>
<a class="index-entry-id" id="index-package-directory"></a>
<a class="index-entry-id" id="index-package-name"></a>
<p>A <em class="dfn">package directory</em> is the root of a tree containing the
@ -112,16 +120,62 @@ target directory, <samp class="file">/usr/local/stow</samp> is the stow director
<samp class="file">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image.
</p>
<a class="index-entry-id" id="index-symlink"></a>
<a class="anchor" id="symlink"></a><a class="index-entry-id" id="index-symlink"></a>
<a class="index-entry-id" id="index-symlink-source"></a>
<a class="index-entry-id" id="index-symlink-destination"></a>
<a class="index-entry-id" id="index-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-symlink"></a>
<p>A <em class="dfn">symlink</em> is a symbolic link. A symlink can be <em class="dfn">relative</em> or
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
<p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
another location on the filesystem called the <em class="dfn">symlink destination</em>.
There is no guarantee that the destination actually exists.
</p>
<p>In general, symlinks can be <em class="dfn">relative</em> or <em class="dfn">absolute</em>. A symlink
is absolute when the destination names a full path; that is, one
starting from <samp class="file">/</samp>. A symlink is relative when the destination
names a relative path; that is, one not starting from <samp class="file">/</samp>. The
destination of a relative symlink is computed starting from the
symlink&rsquo;s own directory, i.e. the directory containing the symlink
source.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> Stow only creates symlinks within the target directory which point to
locations <em class="emph">outside</em> the target directory and inside the stow
directory.
</p>
<p>Consequently, we avoid referring to symlink destinations as symlink
<em class="emph">targets</em>, since this would result in the word &ldquo;target&rdquo; having
two different meanings:
</p>
<ol class="enumerate">
<li> the target directory, i.e. the directory into which Stow targets
installation, where symlinks are managed by Stow, and
</li><li> the destinations of those symlinks.
</li></ol>
<p>If we did not avoid the second meaning of &ldquo;target&rdquo;, then it would lead
to confusing language, such as describing Stow as installing symlinks
into the target directory which point to targets <em class="emph">outside</em> the
target directory.
</p>
<p>Similarly, the word &ldquo;source&rdquo; can have two different meanings in this
context:
</p>
<ol class="enumerate">
<li> the installation image, or some of its contents, and
</li><li> the location of symlinks (the &ldquo;source&rdquo; of the link, vs. its
destination).
</li></ol>
<p>Therefore it should also be avoided, or at least care taken to ensure
that the meaning is not ambiguous.
</p>
</blockquote>
</div>
<hr>
<div class="nav-panel">

12
dot-local/share/doc/stow/manual-split/Tree-unfolding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

13
dot-local/share/doc/stow/manual-split/Types-And-Syntax-Of-Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -96,6 +96,7 @@ _darcs
\.git
\.gitignore
\.gitmodules
.+~ # emacs backup files
\#.*\# # emacs autosave files

14
dot-local/share/doc/stow/manual-split/index.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -154,6 +154,8 @@ Previous: <a href="GNU-General-Public-License.html" accesskey="p" rel="prev">GNU
<tr><td></td><td class="printindex-index-entry"><a href="Installing-Packages.html#index-splitting-open-folded-trees">splitting open folded trees</a></td><td class="printindex-index-section"><a href="Installing-Packages.html">Installing Packages</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-stow-directory">stow directory</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink">symlink</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink-destination">symlink destination</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink-source">symlink source</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-target-directory">target directory</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>

55
dot-local/share/doc/stow/manual-split/symlink.html Normal file
View file

@ -0,0 +1,55 @@
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that the
section entitled "GNU General Public License" is included with the
modified manual, and provided that the entire resulting derived work is
distributed under the terms of a permission notice identical to this
one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the Free Software Foundation. -->
<title>symlink (Stow)</title>
<meta name="description" content="symlink (Stow)">
<meta name="keywords" content="symlink (Stow)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Refresh" content="0; url=Terminology.html#symlink">
<meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body lang="en">
<p>The node you are looking for is at <a href="Terminology.html#symlink">symlink</a>.</p>
</body>

12
dot-local/share/doc/stow/manual-split/tree-folding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/tree-refolding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

BIN
dot-local/share/doc/stow/manual.pdf
View file

Binary file not shown.

8
dot-local/share/doc/stow/version.texi
View file

@ -1,4 +1,4 @@
@set UPDATED 2 November 2023
@set UPDATED-MONTH November 2023
@set EDITION 2.3.2-fixbug56727
@set VERSION 2.3.2-fixbug56727
@set UPDATED 3 June 2024
@set UPDATED-MONTH June 2024
@set EDITION 2.4.0
@set VERSION 2.4.0