From e8c46cf0588fddd26c3d2198cf5ea4d4f8d1a49b Mon Sep 17 00:00:00 2001 From: Adam Spiers Date: Sun, 31 Mar 2024 19:02:23 +0100 Subject: [PATCH] manual: disambiguate meaning of "source" --- doc/stow.texi | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/stow.texi b/doc/stow.texi index bea2725..2cfd050 100644 --- a/doc/stow.texi +++ b/doc/stow.texi @@ -306,6 +306,24 @@ 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 @emph{outside} the target directory. + +Similarly, the word ``source'' can have two different meanings in this +context: + +@enumerate + +@item +the installation image, or some of its contents, and + +@item +the location of symlinks (the ``source'' of the link, vs. its +destination). + +@end enumerate + +Therefore it should also be avoided, or at least care taken to ensure +that the meaning is not ambiguous. + @end quotation @c ===========================================================================