From 72140071ad486040d96b6365affad602a144224a Mon Sep 17 00:00:00 2001 From: Adam Spiers Date: Sun, 4 Apr 2021 22:52:22 +0100 Subject: [PATCH] manual: improve explanation of target directory definition Bring this more up to date by mentioning the dotfiles use case. --- NEWS | 2 ++ doc/stow.texi | 9 ++++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/NEWS b/NEWS index 40d433a..72f53e9 100644 --- a/NEWS +++ b/NEWS @@ -13,6 +13,8 @@ News file for Stow. ***** Added some more information from the web page to the README +***** Made some small improvements to the documentation + ***** Added a CONTRIBUTING.md file ***** Add a =watch= target to =Makefile= diff --git a/doc/stow.texi b/doc/stow.texi index 3b840a1..a191d9e 100644 --- a/doc/stow.texi +++ b/doc/stow.texi @@ -220,9 +220,12 @@ to be installed in a particular directory structure --- e.g., with @cindex target directory A @dfn{target directory} is the root of a tree in which one or more -packages wish to @emph{appear} to be installed. A common, but by no -means the only such location is @file{/usr/local}. The examples in this -manual will use @file{/usr/local} as the target directory. +packages wish to @emph{appear} to be installed. @file{/usr/local} is a +common choice for this, but by no means the only such location. Another +common choice is @file{~} (i.e. the user's @code{$HOME} directory) in +the case where Stow is being used to manage the user's configuration +(``dotfiles'') and other files in their @code{$HOME}. The examples in +this manual will use @file{/usr/local} as the target directory. @cindex stow directory A @dfn{stow directory} is the root of a tree containing separate