00dani/stow
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Add some @sections to the manual to break larger nodes up.

Browse source
This commit is contained in:
Adam Spiers 2012-02-18 15:45:16 +00:00
parent 149034de9f
commit c6a45b7c81
1 changed files with 8 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
doc/stow.texi
View file

@ -127,7 +127,7 @@ Ignore Lists
* Types And Syntax Of Ignore Lists:: * Types And Syntax Of Ignore Lists::
* Justification For Yet Another Set Of Ignore Files:: * Justification For Yet Another Set Of Ignore Files::
Compile-time vs Install-time Advice on changing compilation and installation parameters
* GNU Emacs:: * GNU Emacs::
* Other FSF Software:: * Other FSF Software::
@ -580,6 +580,8 @@ Stow can create a single symlink that points to an entire subtree within
the package tree, it will choose to do that rather than create a the package tree, it will choose to do that rather than create a
directory in the target tree and populate it with symlinks. directory in the target tree and populate it with symlinks.
@anchor{tree folding}
@section Tree folding
@cindex tree folding @cindex tree folding
@cindex directory folding @cindex directory folding
@cindex folding trees @cindex folding trees
@ -616,6 +618,8 @@ tree-folding symlink @file{perl} pointing to
descends as far as necessary into the target tree when it can create a descends as far as necessary into the target tree when it can create a
tree-folding symlink. tree-folding symlink.
@anchor{Tree unfolding}
@section Tree unfolding
@cindex splitting open folded trees @cindex splitting open folded trees
@cindex unfolding trees @cindex unfolding trees
The time often comes when a tree-folding symlink has to be undone The time often comes when a tree-folding symlink has to be undone
@ -638,6 +642,7 @@ directory @file{/usr/local/bin} is created; links are made from
@file{/usr/local/bin} to @file{../stow/perl/bin/perl} and @file{/usr/local/bin} to @file{../stow/perl/bin/perl} and
@file{../stow/perl/bin/a2p}. @file{../stow/perl/bin/a2p}.
@section Ownership
@cindex ownership @cindex ownership
When splitting open a folded tree, Stow makes sure that the When splitting open a folded tree, Stow makes sure that the
symlink it is about to remove points inside a valid package in the symlink it is about to remove points inside a valid package in the
@ -649,6 +654,7 @@ the stow directory, or directories that only contain symlinks that stow
``owns''. Note that by this definition, Stow doesn't ``own'' anything ``owns''. Note that by this definition, Stow doesn't ``own'' anything
@emph{in} the stow directory or in any of the packages. @emph{in} the stow directory or in any of the packages.
@section Conflicts during installation
@cindex conflict @cindex conflict
If Stow needs to create a directory or a symlink in the target If Stow needs to create a directory or a symlink in the target
tree and it cannot because that name is already in use and is not owned tree and it cannot because that name is already in use and is not owned
@ -889,6 +895,7 @@ This means that when you compile a package, you must tell it the
location of the run-time, or target tree; but when you install it, you location of the run-time, or target tree; but when you install it, you
must place it in the stow tree. must place it in the stow tree.
@section Advice on changing compilation and installation parameters
Some software packages allow you to specify, at compile-time, separate Some software packages allow you to specify, at compile-time, separate
locations for installation and for run-time. Perl is one such package; locations for installation and for run-time. Perl is one such package;
see @ref{Perl and Perl 5 Modules}. Others allow you to compile the see @ref{Perl and Perl 5 Modules}. Others allow you to compile the