add iconphoto notes about recommended usage

FossilOrigin-Name: d7c21cf32b5b563b92e7cd9d0b2af82aafb22df5

1 files changed, 5 insertions, 3 deletions

diff --git a/doc/wm.n b/doc/wm.n
index e479679..0dd38b8 100644
--- a/doc/wm.n
+++ b/doc/wm.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: wm.n,v 1.17 2004/10/05 22:04:44 hobbs Exp $
+'\" RCS: @(#) $Id: wm.n,v 1.18 2004/10/07 17:39:51 hobbs Exp $
 '\" 
 .so man.macros
 .TH wm n 8.5 Tk "Tk Built-In Commands"
@@ -288,7 +288,8 @@ If \fI-default\fR is specified, this is applied to all future created
 toplevels as well.  The data in the images is taken as a snapshot at the
 time of invocation.  If the images are later changed, this is not
 reflected to the titlebar icons.  Multiple images are accepted to allow
-different images sizes (eg, 16x16 and 32x32) to be provided.
+different images sizes (eg, 16x16 and 32x32) to be provided.  The window
+manager may scale provided icons to an appropriate size.
 .PP
 On Windows, the images are packed into a Windows icon structure.
 This will override an ico specified to \fBwm iconbitmap\fR, and
@@ -296,7 +297,8 @@ vice versa.
 .PP
 On X, the images are arranged into the _NET_WM_ICON X property, which
 most modern window managers support.  A \fBwm iconbitmap\fR may exist
-simultaneously.
+simultaneously.  It is recommended to use not more than 2 icons, placing
+the larger icon first.
 .PP
 On Macintosh, this is currently does nothing.
 .VE 8.5