From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 11 Feb 2006 00:12:06 +0000 (+0000)
Subject: clarified wxUSE_STD_IOSTREAM and wxUSE_STREAMS
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/b0d969e854a10bf98379acec2029e21308748c9c

clarified wxUSE_STD_IOSTREAM and wxUSE_STREAMS


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@37477 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/include/wx/setup_inc.h b/include/wx/setup_inc.h
index f9667f42a9..f34caf2a33 100644
--- a/include/wx/setup_inc.h
+++ b/include/wx/setup_inc.h
@@ -242,10 +242,29 @@
 // Recommended setting: 0 unless you do plan to develop MT applications
 #define wxUSE_THREADS 1
 
-// If enabled (1), compiles wxWidgets streams classes
+// If enabled, compiles wxWidgets streams classes
+//
+// wx stream classes are used for image IO, process IO redirection, network
+// protocols implementation and much more and so disabling this results in a
+// lot of other functionality being lost.
+//
+// Default is 1
+//
+// Recommended setting: 1 as setting it to 0 disables many other things
 #define wxUSE_STREAMS       1
 
-// Use standard C++ streams if 1. If 0, use wxWin streams implementation only.
+// Use standard C++ streams if 1 instead of wx streams in some places. If
+// disabled (default),.wx streams are used everywhere and wxWidgets doesn't
+// depend on the standard streams library.
+//
+// Notice that enabling this does not replace wx streams with std streams
+// everywhere, in a lot of places wx streams are used no matter what.
+//
+// Default is 0
+//
+// Recommended setting: 1 if you use the standard streams anyhow and so
+//                      dependency on the standard streams library is not a
+//                      problem
 #define wxUSE_STD_IOSTREAM  0
 
 // Enable conversion to standard C++ string if 1.