Rebuild based on upstream Stow 2.4.0
This commit is contained in:
parent
be6413057e
commit
91c35521c9
GPG key ID:
6854781A0488421C
39 changed files with 1968 additions and 1231 deletions
|
|
@ -123,6 +123,5 @@ sub list {
|
|||
|
||||
# Local variables:
|
||||
# mode: perl
|
||||
# cperl-indent-level: 4
|
||||
# End:
|
||||
# vim: ft=perl
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@ stow [ options ] package ...
|
|||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
This manual page describes GNU Stow 2.3.2-fixbug56727. This is not the
|
||||
This manual page describes GNU Stow 2.4.0. This is not the
|
||||
definitive documentation for Stow; for that, see the accompanying info
|
||||
manual, e.g. by typing C<info stow>.
|
||||
|
||||
|
|
@ -474,7 +474,6 @@ sub main {
|
|||
my ($options, $pkgs_to_unstow, $pkgs_to_stow) = process_options();
|
||||
|
||||
my $stow = new Stow(%$options);
|
||||
# current dir is now the target directory
|
||||
|
||||
$stow->plan_unstow(@$pkgs_to_unstow);
|
||||
$stow->plan_stow (@$pkgs_to_stow);
|
||||
|
|
@ -849,6 +848,5 @@ sub version {
|
|||
|
||||
# Local variables:
|
||||
# mode: perl
|
||||
# cperl-indent-level: 4
|
||||
# end:
|
||||
# vim: ft=perl
|
||||
|
|
|
|||
File diff suppressed because it is too large
Load diff
|
|
@ -32,16 +32,18 @@ Supporting utility routines for L<Stow>.
|
|||
use strict;
|
||||
use warnings;
|
||||
|
||||
use File::Spec;
|
||||
use POSIX qw(getcwd);
|
||||
|
||||
use base qw(Exporter);
|
||||
our @EXPORT_OK = qw(
|
||||
error debug set_debug_level set_test_mode
|
||||
join_paths parent canon_path restore_cwd adjust_dotfile
|
||||
join_paths parent canon_path restore_cwd
|
||||
adjust_dotfile unadjust_dotfile
|
||||
);
|
||||
|
||||
our $ProgramName = 'stow';
|
||||
our $VERSION = '2.3.2-fixbug56727';
|
||||
our $VERSION = '2.4.0';
|
||||
|
||||
#############################################################################
|
||||
#
|
||||
|
|
@ -93,7 +95,7 @@ sub set_test_mode {
|
|||
}
|
||||
}
|
||||
|
||||
=head2 debug($level, $msg)
|
||||
=head2 debug($level[, $indent_level], $msg)
|
||||
|
||||
Logs to STDERR based on C<$debug_level> setting. C<$level> is the
|
||||
minimum verbosity level required to output C<$msg>. All output is to
|
||||
|
|
@ -125,13 +127,18 @@ overriding, fixing invalid links
|
|||
=cut
|
||||
|
||||
sub debug {
|
||||
my ($level, $msg) = @_;
|
||||
my $level = shift;
|
||||
my $indent_level;
|
||||
# Maintain backwards-compatibility in case anyone's relying on this.
|
||||
$indent_level = $_[0] =~ /^\d+$/ ? shift : 0;
|
||||
my $msg = shift;
|
||||
if ($debug_level >= $level) {
|
||||
my $indent = ' ' x $indent_level;
|
||||
if ($test_mode) {
|
||||
print "# $msg\n";
|
||||
print "# $indent$msg\n";
|
||||
}
|
||||
else {
|
||||
warn "$msg\n";
|
||||
warn "$indent$msg\n";
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -142,29 +149,53 @@ sub debug {
|
|||
# Parameters: path1, path2, ... => paths
|
||||
# Returns : concatenation of given paths
|
||||
# Throws : n/a
|
||||
# Comments : factors out redundant path elements:
|
||||
# : '//' => '/' and 'a/b/../c' => 'a/c'
|
||||
# Comments : Factors out some redundant path elements:
|
||||
# : '//' => '/', and 'a/b/../c' => 'a/c'. We need this function
|
||||
# : with this behaviour, even though b could be a symlink to
|
||||
# : elsewhere, as noted in the perldoc for File::Spec->canonpath().
|
||||
# : This behaviour is deliberately different to
|
||||
# : Stow::Util::canon_path(), because the way join_paths() is used
|
||||
# : relies on this. Firstly, there is no guarantee that the paths
|
||||
# : exist, so a filesystem check is inappropriate.
|
||||
# :
|
||||
# : For example, it's used to determine the path from the target
|
||||
# : directory to a symlink destination. So if a symlink
|
||||
# : path/to/target/a/b/c points to ../../../stow/pkg/a/b/c,
|
||||
# : then joining path/to/target/a/b with ../../../stow/pkg/a/b/c
|
||||
# : yields path/to/stow/pkg/a/b/c, and it's crucial that the
|
||||
# : path/to/stow prefix matches a recognisable stow directory.
|
||||
#============================================================================
|
||||
sub join_paths {
|
||||
my @paths = @_;
|
||||
|
||||
# weed out empty components and concatenate
|
||||
my $result = join '/', grep {! /\A\z/} @paths;
|
||||
debug(5, 5, "| Joining: @paths");
|
||||
my $result = '';
|
||||
for my $part (@paths) {
|
||||
next if ! length $part; # probably shouldn't happen?
|
||||
$part = File::Spec->canonpath($part);
|
||||
|
||||
# factor out back references and remove redundant /'s)
|
||||
my @result = ();
|
||||
PART:
|
||||
for my $part (split m{/+}, $result) {
|
||||
next PART if $part eq '.';
|
||||
if (@result && $part eq '..' && $result[-1] ne '..') {
|
||||
pop @result;
|
||||
if (substr($part, 0, 1) eq '/') {
|
||||
$result = $part; # absolute path, so ignore all previous parts
|
||||
}
|
||||
else {
|
||||
push @result, $part;
|
||||
$result .= '/' if length $result && $result ne '/';
|
||||
$result .= $part;
|
||||
}
|
||||
debug(7, 6, "| Join now: $result");
|
||||
}
|
||||
debug(6, 5, "| Joined: $result");
|
||||
|
||||
return join '/', @result;
|
||||
# Need this to remove any initial ./
|
||||
$result = File::Spec->canonpath($result);
|
||||
|
||||
# remove foo/..
|
||||
1 while $result =~ s,(^|/)(?!\.\.)[^/]+/\.\.(/|$),$1,;
|
||||
debug(6, 5, "| After .. removal: $result");
|
||||
|
||||
$result = File::Spec->canonpath($result);
|
||||
debug(5, 5, "| Final join: $result");
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
#===== METHOD ===============================================================
|
||||
|
|
@ -209,17 +240,17 @@ sub restore_cwd {
|
|||
}
|
||||
|
||||
sub adjust_dotfile {
|
||||
my ($target) = @_;
|
||||
my ($pkg_node) = @_;
|
||||
(my $adjusted = $pkg_node) =~ s/^dot-([^.])/.$1/;
|
||||
return $adjusted;
|
||||
}
|
||||
|
||||
my @result = ();
|
||||
for my $part (split m{/+}, $target) {
|
||||
if (($part ne "dot-") && ($part ne "dot-.")) {
|
||||
$part =~ s/^dot-/./;
|
||||
}
|
||||
push @result, $part;
|
||||
}
|
||||
|
||||
return join '/', @result;
|
||||
# Needed when unstowing with --compat and --dotfiles
|
||||
sub unadjust_dotfile {
|
||||
my ($target_node) = @_;
|
||||
return $target_node if $target_node =~ /^\.\.?$/;
|
||||
(my $adjusted = $target_node) =~ s/^\./dot-/;
|
||||
return $adjusted;
|
||||
}
|
||||
|
||||
=head1 BUGS
|
||||
|
|
@ -232,6 +263,5 @@ sub adjust_dotfile {
|
|||
|
||||
# Local variables:
|
||||
# mode: perl
|
||||
# cperl-indent-level: 4
|
||||
# end:
|
||||
# vim: ft=perl
|
||||
|
|
|
|||
|
|
@ -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
|
||||
----------------------------
|
||||
|
||||
|
|
|
|||
|
|
@ -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> [<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 — 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’s <code class="code">$HOME</code> directory) in
|
||||
the case where Stow is being used to manage the user’s configuration
|
||||
(“dotfiles”) 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’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’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 “target” 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 “target”, 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 “source” 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 “source” 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>‘<samp class="samp">-p</samp>’</dt>
|
||||
<dt>‘<samp class="samp">--compat</samp>’</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>‘<samp class="samp">-V</samp>’</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> [<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> [<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"> ¶</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> [<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"> ¶</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"> ¶</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> [<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> [<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"> ¶</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> [<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> [<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"> ¶</a></span></h3>
|
||||
|
||||
|
|
@ -1217,7 +1274,7 @@ and ‘<samp class="samp">make install</samp>’ 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> [<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> [<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"> ¶</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> [<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> [<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"> ¶</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> [<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> [<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"> ¶</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"> ¶</a></span></h2>
|
||||
|
||||
<p>Please send bug reports to the current maintainers by electronic
|
||||
mail. The address to use is ‘<samp class="samp"><bug-stow@gnu.org></samp>’. 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 (‘<samp class="samp">stow --version</samp>’);
|
||||
|
|
@ -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 ‘<samp class="samp">--verbose=3</samp>’ to the Stow command line).
|
||||
adding ‘<samp class="samp">--verbose=5</samp>’ 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’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"> ¶</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>
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</a></span></h2>
|
||||
|
|
|
|||
|
|
@ -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> [<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"> ¶</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"> ¶</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>)
|
||||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</a></span></h3>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</a></span></h3>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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>‘<samp class="samp">-p</samp>’</dt>
|
||||
<dt>‘<samp class="samp">--compat</samp>’</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>‘<samp class="samp">-V</samp>’</dt>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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"> ¶</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>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</a></span></h3>
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</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> [<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> [<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>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -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"> ¶</a></span></h2>
|
||||
|
||||
<p>Please send bug reports to the current maintainers by electronic
|
||||
mail. The address to use is ‘<samp class="samp"><bug-stow@gnu.org></samp>’. 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 (‘<samp class="samp">stow --version</samp>’);
|
||||
|
|
@ -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 ‘<samp class="samp">--verbose=3</samp>’ to the Stow command line).
|
||||
adding ‘<samp class="samp">--verbose=5</samp>’ 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’re encountering
|
||||
|
|
|
|||
|
|
@ -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> [<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> [<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"> ¶</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> [<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> [<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>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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 — 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’s <code class="code">$HOME</code> directory) in
|
||||
the case where Stow is being used to manage the user’s configuration
|
||||
(“dotfiles”) 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’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’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 “target” 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 “target”, 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 “source” 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 “source” 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">
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
55
dot-local/share/doc/stow/manual-split/symlink.html
Normal 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>
|
||||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Binary file not shown.
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
This is stow.info, produced by makeinfo version 7.1 from stow.texi.
|
||||
|
||||
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:
|
||||
|
||||
|
|
@ -36,10 +36,10 @@ File: stow.info, Node: Top, Next: Introduction, Up: (dir)
|
|||
Stow
|
||||
****
|
||||
|
||||
This manual describes GNU Stow 2.3.2-fixbug56727 (2 November 2023), 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.
|
||||
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.
|
||||
|
||||
* Menu:
|
||||
|
||||
|
|
@ -54,7 +54,7 @@ to be installed in a single directory tree.
|
|||
* Multiple Stow Directories:: Further segregating software.
|
||||
* Target Maintenance:: Cleaning up mistakes.
|
||||
* Resource Files:: Setting default command line options.
|
||||
* Compile-time vs Install-time:: Faking out 'make install'.
|
||||
* Compile-time vs. Install-time:: Faking out 'make install'.
|
||||
* Bootstrapping:: When stow and perl are not yet stowed.
|
||||
* Reporting Bugs:: How, what, where, and when to report.
|
||||
* Known Bugs:: Don't report any of these.
|
||||
|
|
@ -174,9 +174,12 @@ be installed in a particular directory structure -- e.g., with ‘bin’,
|
|||
‘lib’, and ‘man’ subdirectories.
|
||||
|
||||
A “target directory” is the root of a tree in which one or more
|
||||
packages wish to _appear_ to be installed. A common, but by no means
|
||||
the only such location is ‘/usr/local’. The examples in this manual
|
||||
will use ‘/usr/local’ as the target directory.
|
||||
packages wish to _appear_ to be installed. ‘/usr/local’ is a common
|
||||
choice for this, but by no means the only such location. Another common
|
||||
choice is ‘~’ (i.e. the user's ‘$HOME’ directory) in the case where Stow
|
||||
is being used to manage the user's configuration ("dotfiles") and other
|
||||
files in their ‘$HOME’. The examples in this manual will use
|
||||
‘/usr/local’ as the target directory.
|
||||
|
||||
A “stow directory” is the root of a tree containing separate packages
|
||||
in private subtrees. When Stow runs, it uses the current directory as
|
||||
|
|
@ -192,6 +195,10 @@ installation image for Perl includes: a ‘bin’ directory containing
|
|||
documentation; a ‘lib/perl’ directory containing Perl libraries; and a
|
||||
‘man/man1’ directory containing man pages.
|
||||
|
||||
Note: This is a _pre-_installation image which exists even before
|
||||
Stow has installed any symlinks into the target directory which
|
||||
point to it.
|
||||
|
||||
A “package directory” is the root of a tree containing the
|
||||
installation image for a particular package. Each package directory
|
||||
must reside in a stow directory -- e.g., the package directory
|
||||
|
|
@ -205,12 +212,46 @@ directory, ‘/usr/local/stow’ is the stow directory,
|
|||
‘/usr/local/stow/perl’ is the package directory, and ‘bin/perl’ within
|
||||
is part of the installation image.
|
||||
|
||||
A “symlink” is a symbolic link. A symlink can be “relative” or
|
||||
“absolute”. An absolute symlink names a full path; that is, one
|
||||
starting from ‘/’. A relative symlink names a relative path; that is,
|
||||
one not starting from ‘/’. The target of a relative symlink is computed
|
||||
starting from the symlink's own directory. Stow only creates relative
|
||||
symlinks.
|
||||
A “symlink” is a symbolic link, i.e. an entry on the filesystem whose
|
||||
path is sometimes called the “symlink source”, which points to another
|
||||
location on the filesystem called the “symlink destination”. There is
|
||||
no guarantee that the destination actually exists.
|
||||
|
||||
In general, symlinks can be “relative” or “absolute”. A symlink is
|
||||
absolute when the destination names a full path; that is, one starting
|
||||
from ‘/’. A symlink is relative when the destination names a relative
|
||||
path; that is, one not starting from ‘/’. The destination of a relative
|
||||
symlink is computed starting from the symlink's own directory, i.e. the
|
||||
directory containing the symlink source.
|
||||
|
||||
Note: Stow only creates symlinks within the target directory which
|
||||
point to locations _outside_ the target directory and inside the
|
||||
stow directory.
|
||||
|
||||
Consequently, we avoid referring to symlink destinations as symlink
|
||||
_targets_, since this would result in the word "target" having two
|
||||
different meanings:
|
||||
|
||||
1. the target directory, i.e. the directory into which Stow
|
||||
targets installation, where symlinks are managed by Stow, and
|
||||
|
||||
2. the destinations of those symlinks.
|
||||
|
||||
If we did not avoid the second meaning of "target", then it would
|
||||
lead to confusing language, such as describing Stow as installing
|
||||
symlinks into the target directory which point to targets _outside_
|
||||
the target directory.
|
||||
|
||||
Similarly, the word "source" can have two different meanings in
|
||||
this context:
|
||||
|
||||
1. the installation image, or some of its contents, and
|
||||
|
||||
2. the location of symlinks (the "source" of the link, vs. its
|
||||
destination).
|
||||
|
||||
Therefore it should also be avoided, or at least care taken to
|
||||
ensure that the meaning is not ambiguous.
|
||||
|
||||
|
||||
File: stow.info, Node: Invoking Stow, Next: Ignore Lists, Prev: Terminology, Up: Top
|
||||
|
|
@ -324,7 +365,7 @@ The following options are supported:
|
|||
created within the target, and its contents are symlinked, rather
|
||||
than just creating a symlink for the directory. If removal of
|
||||
symlinks whilst unstowing a package causes a subtree to be foldable
|
||||
(i.e. only containing symlinks to a single package), that subtree
|
||||
(i.e. only containing symlinks to a single package), that subtree
|
||||
will not be removed and replaced with a symlink.
|
||||
|
||||
‘--adopt’
|
||||
|
|
@ -366,12 +407,14 @@ The following options are supported:
|
|||
‘--compat’
|
||||
Scan the whole target tree when unstowing. By default, only
|
||||
directories specified in the “installation image” 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 ‘--badlinks’ option to
|
||||
the ‘chkstow’ utility may be a better way of ensuring that your
|
||||
installation does not have any dangling symlinks (*note Target
|
||||
Maintenance::).
|
||||
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 ‘--badlinks’ option to the ‘chkstow’ utility may be a
|
||||
better way of ensuring that your installation does not have any
|
||||
dangling symlinks (*note Target Maintenance::).
|
||||
|
||||
‘-V’
|
||||
‘--version’
|
||||
|
|
@ -475,6 +518,7 @@ list files:
|
|||
|
||||
\.git
|
||||
\.gitignore
|
||||
\.gitmodules
|
||||
|
||||
.+~ # emacs backup files
|
||||
\#.*\# # emacs autosave files
|
||||
|
|
@ -755,7 +799,7 @@ invocation.
|
|||
invocations of stow, because redundant folding/unfolding operations can
|
||||
be factored out. In addition, all the operations are calculated and
|
||||
merged before being executed (*note Deferred Operation::), so the amount
|
||||
of of time in which GNU Emacs is unavailable is minimised.
|
||||
of time in which GNU Emacs is unavailable is minimised.
|
||||
|
||||
You can mix and match any number of actions, for example,
|
||||
|
||||
|
|
@ -825,7 +869,7 @@ The following options are supported:
|
|||
target directory.
|
||||
|
||||
|
||||
File: stow.info, Node: Resource Files, Next: Compile-time vs Install-time, Prev: Target Maintenance, Up: Top
|
||||
File: stow.info, Node: Resource Files, Next: Compile-time vs. Install-time, Prev: Target Maintenance, Up: Top
|
||||
|
||||
11 Resource Files
|
||||
*****************
|
||||
|
|
@ -884,10 +928,10 @@ escape the ‘$’ or ‘~’ with a backslash.
|
|||
is also true of any package names given in the resource file.
|
||||
|
||||
|
||||
File: stow.info, Node: Compile-time vs Install-time, Next: Bootstrapping, Prev: Resource Files, Up: Top
|
||||
File: stow.info, Node: Compile-time vs. Install-time, Next: Bootstrapping, Prev: Resource Files, Up: Top
|
||||
|
||||
12 Compile-time vs Install-time
|
||||
*******************************
|
||||
12 Compile-time vs. Install-time
|
||||
********************************
|
||||
|
||||
Software whose installation is managed with Stow needs to be installed
|
||||
in one place (the package directory, e.g. ‘/usr/local/stow/perl’) but
|
||||
|
|
@ -962,7 +1006,7 @@ following sections.
|
|||
* Perl and Perl 5 Modules::
|
||||
|
||||
|
||||
File: stow.info, Node: GNU Emacs, Next: Other FSF Software, Prev: Compile-time vs Install-time, Up: Compile-time vs Install-time
|
||||
File: stow.info, Node: GNU Emacs, Next: Other FSF Software, Prev: Compile-time vs. Install-time, Up: Compile-time vs. Install-time
|
||||
|
||||
12.2 GNU Emacs
|
||||
==============
|
||||
|
|
@ -993,7 +1037,7 @@ around this problem is:
|
|||
(1) As I write this, the current version of Emacs is 19.31.
|
||||
|
||||
|
||||
File: stow.info, Node: Other FSF Software, Next: Cygnus Software, Prev: GNU Emacs, Up: Compile-time vs Install-time
|
||||
File: stow.info, Node: Other FSF Software, Next: Cygnus Software, Prev: GNU Emacs, Up: Compile-time vs. Install-time
|
||||
|
||||
12.3 Other FSF Software
|
||||
=======================
|
||||
|
|
@ -1013,7 +1057,7 @@ and ‘make install’ steps to work correctly without needing to "fool" the
|
|||
build process.
|
||||
|
||||
|
||||
File: stow.info, Node: Cygnus Software, Next: Perl and Perl 5 Modules, Prev: Other FSF Software, Up: Compile-time vs Install-time
|
||||
File: stow.info, Node: Cygnus Software, Next: Perl and Perl 5 Modules, Prev: Other FSF Software, Up: Compile-time vs. Install-time
|
||||
|
||||
12.4 Cygnus Software
|
||||
====================
|
||||
|
|
@ -1044,7 +1088,7 @@ recompiling files. Usually it will work just fine; otherwise, install
|
|||
manually.
|
||||
|
||||
|
||||
File: stow.info, Node: Perl and Perl 5 Modules, Prev: Cygnus Software, Up: Compile-time vs Install-time
|
||||
File: stow.info, Node: Perl and Perl 5 Modules, Prev: Cygnus Software, Up: Compile-time vs. Install-time
|
||||
|
||||
12.5 Perl and Perl 5 Modules
|
||||
============================
|
||||
|
|
@ -1129,7 +1173,7 @@ convention, you can simply do this:
|
|||
xargs rm
|
||||
|
||||
|
||||
File: stow.info, Node: Bootstrapping, Next: Reporting Bugs, Prev: Compile-time vs Install-time, Up: Top
|
||||
File: stow.info, Node: Bootstrapping, Next: Reporting Bugs, Prev: Compile-time vs. Install-time, Up: Top
|
||||
|
||||
13 Bootstrapping
|
||||
****************
|
||||
|
|
@ -1160,8 +1204,27 @@ File: stow.info, Node: Reporting Bugs, Next: Known Bugs, Prev: Bootstrapping,
|
|||
14 Reporting Bugs
|
||||
*****************
|
||||
|
||||
Please send bug reports to the current maintainers by electronic mail.
|
||||
The address to use is ‘<bug-stow@gnu.org>’. Please include:
|
||||
You can report bugs to the current maintainers in one of three ways:
|
||||
|
||||
1. Send e-mail to <bug-stow@gnu.org>.
|
||||
|
||||
2. File an issue in the Savannah bug tracker
|
||||
(https://savannah.gnu.org/bugs/?group=stow).
|
||||
|
||||
3. File an issue in the GitHub project
|
||||
(https://github.com/aspiers/stow/issues/).
|
||||
|
||||
While GitHub is arguably the most convenient of these three options,
|
||||
it is not the most ethical or freedom-preserving way to host software
|
||||
projects
|
||||
(https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub).
|
||||
Therefore the GitHub project may be moved to a more ethical hosting
|
||||
service (https://github.com/aspiers/stow/issues/43) in the future.
|
||||
|
||||
Before reporting a bug, it is recommended to check whether it is
|
||||
already known, so please first *note Known Bugs::.
|
||||
|
||||
When reporting a new bug, please include:
|
||||
|
||||
• the version number of Stow (‘stow --version’);
|
||||
|
||||
|
|
@ -1175,11 +1238,12 @@ The address to use is ‘<bug-stow@gnu.org>’. Please include:
|
|||
• the precise command you gave;
|
||||
|
||||
• the output from the command (preferably verbose output, obtained by
|
||||
adding ‘--verbose=3’ to the Stow command line).
|
||||
adding ‘--verbose=5’ to the Stow command line).
|
||||
|
||||
If you are really keen, consider developing a minimal test case and
|
||||
creating a new test. See the ‘t/’ directory in the source for lots of
|
||||
examples.
|
||||
examples, and the ‘CONTRIBUTING.md’ file for a guide on how to
|
||||
contribute.
|
||||
|
||||
Before reporting a bug, please read the manual carefully, especially
|
||||
*note Known Bugs::, to see whether you're encountering something that
|
||||
|
|
@ -1191,8 +1255,17 @@ File: stow.info, Node: Known Bugs, Next: GNU General Public License, Prev: Re
|
|||
15 Known Bugs
|
||||
*************
|
||||
|
||||
There are no known bugs in Stow version 2.3.2-fixbug56727! If you think
|
||||
you have found one, please *note Reporting Bugs::.
|
||||
Known bugs can be found in the following locations:
|
||||
|
||||
• the GitHub issue tracker (https://github.com/aspiers/stow/issues/)
|
||||
|
||||
• the Savannah bug tracker
|
||||
(https://savannah.gnu.org/bugs/?group=stow)
|
||||
|
||||
• the bug-stow list archives
|
||||
(https://lists.gnu.org/archive/html/bug-stow/)
|
||||
|
||||
If you think you have found a new bug, please *note Reporting Bugs::.
|
||||
|
||||
|
||||
File: stow.info, Node: GNU General Public License, Next: Index, Prev: Known Bugs, Up: Top
|
||||
|
|
@ -1919,7 +1992,7 @@ Index
|
|||
[index ]
|
||||
* Menu:
|
||||
|
||||
* absolute symlink: Terminology. (line 43)
|
||||
* absolute symlink: Terminology. (line 50)
|
||||
* adopting existing files: Invoking Stow. (line 115)
|
||||
* configuration files: Resource Files. (line 6)
|
||||
* conflicts: Installing Packages. (line 85)
|
||||
|
|
@ -1937,20 +2010,22 @@ Index
|
|||
* ignoring files and directories: Ignore Lists. (line 6)
|
||||
* installation: Installing Packages. (line 6)
|
||||
* installation conflicts: Installing Packages. (line 85)
|
||||
* installation image: Terminology. (line 23)
|
||||
* installation image: Terminology. (line 26)
|
||||
* maintenance: Target Maintenance. (line 6)
|
||||
* mixing operations: Mixing Operations. (line 6)
|
||||
* ownership: Installing Packages. (line 72)
|
||||
* package: Terminology. (line 6)
|
||||
* package directory: Terminology. (line 30)
|
||||
* package name: Terminology. (line 30)
|
||||
* package directory: Terminology. (line 37)
|
||||
* package name: Terminology. (line 37)
|
||||
* refolding trees: Deleting Packages. (line 25)
|
||||
* relative symlink: Terminology. (line 43)
|
||||
* relative symlink: Terminology. (line 50)
|
||||
* resource files: Resource Files. (line 6)
|
||||
* simulated run: Invoking Stow. (line 137)
|
||||
* splitting open folded trees: Installing Packages. (line 51)
|
||||
* stow directory: Terminology. (line 16)
|
||||
* symlink: Terminology. (line 43)
|
||||
* stow directory: Terminology. (line 19)
|
||||
* symlink: Terminology. (line 50)
|
||||
* symlink destination: Terminology. (line 50)
|
||||
* symlink source: Terminology. (line 50)
|
||||
* target directory: Terminology. (line 11)
|
||||
* tree folding: Installing Packages. (line 16)
|
||||
* tree refolding: Deleting Packages. (line 25)
|
||||
|
|
@ -1962,43 +2037,44 @@ Index
|
|||
|
||||
|
||||
Tag Table:
|
||||
Node: Top1427
|
||||
Node: Introduction3088
|
||||
Ref: Introduction-Footnote-16570
|
||||
Ref: Introduction-Footnote-26679
|
||||
Ref: Introduction-Footnote-36777
|
||||
Node: Terminology6854
|
||||
Node: Invoking Stow9349
|
||||
Node: Ignore Lists17276
|
||||
Node: Motivation For Ignore Lists17540
|
||||
Node: Types And Syntax Of Ignore Lists19071
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-122368
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-222534
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-322778
|
||||
Node: Justification For Yet Another Set Of Ignore Files22927
|
||||
Node: Installing Packages24542
|
||||
Ref: tree folding25104
|
||||
Ref: Tree unfolding27102
|
||||
Node: Deleting Packages29241
|
||||
Ref: tree refolding30304
|
||||
Ref: Deleting Packages-Footnote-130853
|
||||
Node: Conflicts31449
|
||||
Ref: Deferred Operation32439
|
||||
Node: Mixing Operations33039
|
||||
Node: Multiple Stow Directories34031
|
||||
Node: Target Maintenance35115
|
||||
Node: Resource Files36398
|
||||
Node: Compile-time vs Install-time38993
|
||||
Node: GNU Emacs42502
|
||||
Ref: GNU Emacs-Footnote-143491
|
||||
Node: Other FSF Software43555
|
||||
Node: Cygnus Software44336
|
||||
Node: Perl and Perl 5 Modules45847
|
||||
Node: Bootstrapping49476
|
||||
Node: Reporting Bugs50285
|
||||
Node: Known Bugs51300
|
||||
Node: GNU General Public License51560
|
||||
Node: Index89114
|
||||
Node: Top1411
|
||||
Node: Introduction3057
|
||||
Ref: Introduction-Footnote-16539
|
||||
Ref: Introduction-Footnote-26648
|
||||
Ref: Introduction-Footnote-36746
|
||||
Node: Terminology6823
|
||||
Ref: symlink9312
|
||||
Node: Invoking Stow11136
|
||||
Node: Ignore Lists19249
|
||||
Node: Motivation For Ignore Lists19513
|
||||
Node: Types And Syntax Of Ignore Lists21044
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-124359
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-224525
|
||||
Ref: Types And Syntax Of Ignore Lists-Footnote-324769
|
||||
Node: Justification For Yet Another Set Of Ignore Files24918
|
||||
Node: Installing Packages26533
|
||||
Ref: tree folding27095
|
||||
Ref: Tree unfolding29093
|
||||
Node: Deleting Packages31232
|
||||
Ref: tree refolding32295
|
||||
Ref: Deleting Packages-Footnote-132844
|
||||
Node: Conflicts33440
|
||||
Ref: Deferred Operation34430
|
||||
Node: Mixing Operations35030
|
||||
Node: Multiple Stow Directories36019
|
||||
Node: Target Maintenance37103
|
||||
Node: Resource Files38386
|
||||
Node: Compile-time vs. Install-time40982
|
||||
Node: GNU Emacs44494
|
||||
Ref: GNU Emacs-Footnote-145485
|
||||
Node: Other FSF Software45549
|
||||
Node: Cygnus Software46331
|
||||
Node: Perl and Perl 5 Modules47843
|
||||
Node: Bootstrapping51473
|
||||
Node: Reporting Bugs52283
|
||||
Node: Known Bugs54051
|
||||
Node: GNU General Public License54557
|
||||
Node: Index92111
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
|
|
|||
|
|
@ -55,7 +55,7 @@
|
|||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "stow 8"
|
||||
.TH stow 8 2023-11-02 "perl v5.38.0" "User Contributed Perl Documentation"
|
||||
.TH stow 8 2024-06-03 "perl v5.38.2" "User Contributed Perl Documentation"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
|
@ -67,7 +67,7 @@ stow \- manage farms of symbolic links
|
|||
stow [ options ] package ...
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
This manual page describes GNU Stow 2.3.2\-fixbug56727. This is not the
|
||||
This manual page describes GNU Stow 2.4.0. This is not the
|
||||
definitive documentation for Stow; for that, see the accompanying info
|
||||
manual, e.g. by typing \f(CW\*(C`info stow\*(C'\fR.
|
||||
.PP
|
||||
|
|
|
|||
Loading…
Reference in a new issue