From 15a9da0939dab703753652a2cc3a36181fe6c595 Mon Sep 17 00:00:00 2001
From: kichik <kichik@212acab6-be3b-0410-9dea-997c60f758d6>
Date: Tue, 14 Mar 2006 16:04:16 +0000
Subject: [PATCH] added a detailed explanation about File /r that can't be
 interpreted in more than one way

git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@4583 212acab6-be3b-0410-9dea-997c60f758d6
---
 Docs/src/basic.but | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/Docs/src/basic.but b/Docs/src/basic.but
index 643e2b01..339d244a 100644
--- a/Docs/src/basic.but
+++ b/Docs/src/basic.but
@@ -74,6 +74,27 @@ Adds file(s) to be extracted to the current output path ($OUTDIR).
 \c File /r /x CVS myproject\*.*
 \c File /r /x *.res /x *.obj /x *.pch source\*.*
 
+\\<b\\>Note:\\</b\\> when using the \e{/r} switch, both matching directories and files will be searched. This is always done with or without the use of wildcards, even if the given path perfectly matches one directory. That means, the following directory structure:
+
+\c <DIR> something
+\c   file.dat
+\c   another.dat
+\c <DIR> dir
+\c   something
+\c   <DIR> dir2
+\c     file2.dat
+\c <DIR> another
+\c   <DIR> something
+\c     readme.txt
+
+with the following \e{File} usage:
+
+\c File /r something
+
+will match the directory named \e{something} on the root directory, the file named \e{something} in the directory named \e{dir} and the directory named \e{something} in the directory named \e{another}. To match only the directory named \e{something} on the root directory, use the following:
+
+\c File /r something\*.*
+
 \S2{rename} Rename
 
 \c [/REBOOTOK] source_file dest_file