From a15302de187de4571ea3e9315e3ee75927f46dca Mon Sep 17 00:00:00 2001
From: Francesco Montorsi <f18m_cpp217828@yahoo.it>
Date: Sun, 23 Mar 2008 18:08:16 +0000
Subject: [PATCH] update infos about profiling under linux (callgrind utility
 has been merged with valgrind)

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52741 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 tests/benchmarks/printfbench.cpp | 40 +++++++++++++++++++++++++++-------------
 1 file changed, 27 insertions(+), 13 deletions(-)

diff --git a/tests/benchmarks/printfbench.cpp b/tests/benchmarks/printfbench.cpp
index 147cfa1..f4c2ffb 100644
--- a/tests/benchmarks/printfbench.cpp
+++ b/tests/benchmarks/printfbench.cpp
@@ -9,6 +9,32 @@
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
+//
+// Profiling under Linux:
+// =====================
+//
+//   1) configure wxWidgets in release mode
+//   2) make sure that HAVE_UNIX98_PRINTF is undefined (just #defining it to zero
+//      does not work; you must comment out the entire #define) in your setup.h;
+//      and also that wxUSE_PRINTF_POS_PARAMS is set to 1; this will force the
+//      use of wx's own implementation of wxVsnprintf()
+//   3) compile wx
+//   4) set wxTEST_WX_ONLY to 1 and compile tests as well
+//
+// Now you have two main choices:
+//
+//  - using gprof:
+//      5) add to the Makefile of this test program the -pg option both to
+//         CXXFLAGS and to LDFLAGS
+//      6) run the test
+//      7) look at the gmon.out file with gprof utility
+//
+//  - using valgrind:
+//      4) run "valgrind --tool=callgrind ./printfbench"
+//      5) run "kcachegrind dump_file_generated_by_callgrind"
+//
+
+
 // ============================================================================
 // declarations
 // ============================================================================
@@ -38,7 +64,7 @@
 // command line
 // ----------------------------------------------------------------------------
 
-#define HELP_SWITCH              "h"
+#define HELP_SWITCH                   "h"
 #define NUMBENCHMARK_OPTION           "n"
 
 static const wxCmdLineEntryDesc g_cmdLineDesc[] =
@@ -61,18 +87,6 @@ static const wxCmdLineEntryDesc g_cmdLineDesc[] =
 #define BUFSIZE                  10000
 
 // set wxTEST_WX_ONLY to 1 when you want to profile wx's implementation only.
-// A little reminder about profiling under Linux:
-//
-//   1) configure wxWidgets in release mode
-//   2) make sure that HAVE_UNIX98_PRINTF is undefined (just #defining it to zero
-//      does not work; you must comment out the entire #define) in your setup.h;
-//      and also that wxUSE_PRINTF_POS_PARAMS is set to 1; this will force the
-//      use of wx's own implementation of wxVsnprintf()
-//   3) compile wx
-//   4) set wxTEST_WX_ONLY to 1 and compile tests as well
-//   5) run "callgrind ./printfbench"
-//   6) run "kcachegrind dump_file_generated_by_callgrind"
-//
 #define wxTEST_WX_ONLY           1
 
 
-- 
2.7.4