From: Micah Cowan <micah@cowan.name>
Date: Wed, 12 Sep 2007 17:14:14 +0000 (-0700)
Subject: Initial revamp of -O documentation
X-Git-Tag: v1.13~552
X-Git-Url: http://sjero.net/git/?p=wget;a=commitdiff_plain;h=66f02cb4dc04d3f2ffccfcbd9cb1d4b4fcd8737b

Initial revamp of -O documentation
---

diff --git a/doc/wget.texi b/doc/wget.texi
index fcc5cd60..0563dc72 100644
--- a/doc/wget.texi
+++ b/doc/wget.texi
@@ -548,6 +548,13 @@ 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{-}.)
 
+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 don't expect timestamping to work with it.
+
 Note that a combination with @samp{-k} is only well-defined for
 downloading a single document.