Further refinement of -O description; .hignore <- doc products

[wget] / doc / wget.texi

diff --git a/doc/wget.texi b/doc/wget.texi
index fcc5cd603467c4ef44c01669c626e50ea7c1ea31..6d3ae4932fd8f844a5715e060f8a2e8b5f1e7b39 100644 (file)
--- a/doc/wget.texi
+++ b/doc/wget.texi
@@ -548,8 +548,16 @@ is used as @var{file}, documents will be printed to standard output,
 disabling link conversion.  (Use @samp{./-} to print to a file
 literally named @samp{-}.)
 
-Note that a combination with @samp{-k} is only well-defined for
-downloading a single document.
+Use of @samp{-O} is @emph{not} intended to mean simply ``use the name
+@var{file} instead of the one in the URL;'' rather, it is
+analogous to shell redirection:
+@samp{wget -O file http://foo} is intended to work like
+@samp{wget -O - http://foo > file}; @file{file} will be truncated
+immediately, and @emph{all} downloaded content will be written there.
+
+Note that a combination with @samp{-k} is only permitted when
+downloading a single document, and combination with any of @samp{-r},
+@samp{-p}, or @samp{-N} is not allowed.
 
 @cindex clobbering, file
 @cindex downloading multiple times