From 90334476e5d4533cc20ab008bc437dba212824d6 Mon Sep 17 00:00:00 2001 From: Viktor Szakats Date: Wed, 6 Jan 2010 00:27:55 +0000 Subject: [PATCH] 2010-01-06 01:24 UTC+0100 Viktor Szakats (harbour.01 syenar.hu) * INSTALL + Added new section: 7. DEBUGGING OPTIONS So far covered: tracing, memory statistics, valgrind and codeguard. I'd like to ask our experts to review and if needed extend these informations (send me suggestions and I'll update it). * bin/postinst.bat + Enabling -debug option on shared tool hbmk2 builds if HB_BUILD_DEBUG=yes. * contrib/hbide/ideactions.prg ! Typo. --- harbour/ChangeLog | 13 +++++++ harbour/INSTALL | 54 +++++++++++++++++++++++----- harbour/bin/postinst.bat | 5 +-- harbour/contrib/hbide/ideactions.prg | 2 +- 4 files changed, 62 insertions(+), 12 deletions(-) diff --git a/harbour/ChangeLog b/harbour/ChangeLog index 960ecbcca2..e4c0299e1e 100644 --- a/harbour/ChangeLog +++ b/harbour/ChangeLog @@ -17,6 +17,19 @@ past entries belonging to author(s): Viktor Szakats. */ +2010-01-06 01:24 UTC+0100 Viktor Szakats (harbour.01 syenar.hu) + * INSTALL + + Added new section: 7. DEBUGGING OPTIONS + So far covered: tracing, memory statistics, valgrind and codeguard. + I'd like to ask our experts to review and if needed extend + these informations (send me suggestions and I'll update it). + + * bin/postinst.bat + + Enabling -debug option on shared tool hbmk2 builds if HB_BUILD_DEBUG=yes. + + * contrib/hbide/ideactions.prg + ! Typo. + 2010-01-05 20:35 UTC+0100 Viktor Szakats (harbour.01 syenar.hu) * contrib/hbide/projects/hbide.hbi ! Deleted windows and local environment specific hbmk2 diff --git a/harbour/INSTALL b/harbour/INSTALL index 432f4e0104..2848ff592b 100644 --- a/harbour/INSTALL +++ b/harbour/INSTALL @@ -666,7 +666,41 @@ HARBOUR executables are required for a cross-build process to succeed. -7. EXAMPLES +7. DEBUGGING OPTIONS +==================== + + Tracing (all targets) + ------- + Build Harbour with: + HB_USER_CFLAGS=-DHB_TR_LEVEL_DEBUG + Run app with: + HB_TR_LEVEL=debug + HB_TR_WINOUT=yes (for additional OutputDebugString() output on Windows systems only) + + Memory statistics (all targets) + ----------------- + Build Harbour with: + HB_USER_CFLAGS=-DHB_FM_STATISTICS + + Valgrind (on linux and darwin targets only) + -------- + Build Harbour with: + HB_USER_DEBUG=yes + + Build app with: + $ hbmk2 myapp -debug + + Runn app using: + $ valgrind --tool=memcheck --leak-check=yes -v ./myapp 2> myapp.log + + CodeGuard (on win/bcc target only) + --------- + Build Harbour with: + HB_USER_CFLAGS=-vG + HB_USER_LIBS=cg32 + + +8. EXAMPLES =========== for Windows hosts @@ -980,7 +1014,7 @@ HARBOUR gmake OR make HB_PLATFORM=wce --- -8. HOW TO GET THE HARBOUR SOURCES +9. HOW TO GET THE HARBOUR SOURCES ================================= 1.) It's possible you're reading this file as part of the Harbour @@ -1008,8 +1042,8 @@ HARBOUR http://sourceforge.net/project/showfiles.php?group_id=681&package_id=192305 -9. TROUBLESHOOTING -================== +10. TROUBLESHOOTING +=================== Please evaluate these points before reporting an issue on the developers' mailing list. @@ -1040,7 +1074,7 @@ HARBOUR examples as is. -10. QUICK START TO BUILD YOUR OWN HARBOUR APPLICATIONS +11. QUICK START TO BUILD YOUR OWN HARBOUR APPLICATIONS ====================================================== For all platforms you'll need two things: @@ -1111,7 +1145,7 @@ HARBOUR to build a Harbour application with above methods. -11. BUILD HOST-PLATFORM/SHELL - TARGET-PLATFORM/COMPILER COMPATIBILITY MATRIX +12. BUILD HOST-PLATFORM/SHELL - TARGET-PLATFORM/COMPILER COMPATIBILITY MATRIX ============================================================================= host target target @@ -1207,7 +1241,7 @@ HARBOUR *nix / POSIX shell (* not supported: HB_BUILD_PKG - implemented as standalone scripts) -12. LINKS TO EXTERNAL COMPONENTS +13. LINKS TO EXTERNAL COMPONENTS ================================ C/C++ Compilers/Shells: @@ -1315,6 +1349,8 @@ HARBOUR GNU Sed (stream editor) [multiplatform, free, open-source] Windows binary: http://gnuwin32.sourceforge.net/packages/sed.htm + Valgrind (dynamic executable analysis tool) [linux, darwin, free, open-source] + http://valgrind.org/ UPX (executable compressor) [win, dos, *nix, free, open-source] http://upx.sourceforge.net/ Nullsoft Installer [win, free, open-source] @@ -1364,7 +1400,7 @@ HARBOUR http://tools.ietf.org/html/rfc1855 -13. HOW TO PARTICIPATE +14. HOW TO PARTICIPATE ====================== There are several ways to help making Harbour better: @@ -1387,7 +1423,7 @@ HARBOUR various environments, etc. -14. FOR MORE INFORMATION +15. FOR MORE INFORMATION ======================== Homepage: diff --git a/harbour/bin/postinst.bat b/harbour/bin/postinst.bat index 602cdfd648..817e993bb8 100644 --- a/harbour/bin/postinst.bat +++ b/harbour/bin/postinst.bat @@ -50,8 +50,9 @@ if "%HB_SHELL%" == "nt" goto _SH_NT if "%HB_BUILD_DLL%" == "no" goto _NO_DLL_BIN set HBMK_OPTIONS= - if "%HB_BUILD_MODE%" == "cpp" set HBMK_OPTIONS=%HBMK_OPTIONS% -cpp=yes - if "%HB_BUILD_MODE%" == "c" set HBMK_OPTIONS=%HBMK_OPTIONS% -cpp=no + if "%HB_BUILD_MODE%" == "cpp" set HBMK_OPTIONS=%HBMK_OPTIONS% -cpp=yes + if "%HB_BUILD_MODE%" == "c" set HBMK_OPTIONS=%HBMK_OPTIONS% -cpp=no + if "%HB_BUILD_DEBUG%" == "yes" set HBMK_OPTIONS=%HBMK_OPTIONS% -debug echo ! Making shared version of Harbour binaries... "%HB_HOST_BIN_DIR%\hbmk2" -quiet -q0 -lng=en-EN -shared "-o%HB_BIN_INSTALL%\hbrun-dll" "%~dp0..\utils\hbrun\hbrun.hbp" diff --git a/harbour/contrib/hbide/ideactions.prg b/harbour/contrib/hbide/ideactions.prg index e88628875b..f8a693dbca 100644 --- a/harbour/contrib/hbide/ideactions.prg +++ b/harbour/contrib/hbide/ideactions.prg @@ -226,7 +226,7 @@ METHOD IdeActions:loadActions() aadd( aAct, { "ManageThemes" , "Manage Themes" , "" , "" , "No", "Yes" } ) aadd( aAct, { "DefaultTheme" , "Set Default Theme" , "" , "" , "No", "Yes" } ) aadd( aAct, { "AboutIDE" , "About Harbour IDE" , "vr-16x16" , "" , "No", "Yes" } ) - aadd( aAct, { "AboutHarbour" , "Abouthb Harbour" , "hb-16x16" , "" , "No", "Yes" } ) + aadd( aAct, { "AboutHarbour" , "About Harbour" , "hb-16x16" , "" , "No", "Yes" } ) aadd( aAct, { "HarbourUsersList" , "Harbour Users (Mailing Lists)", "list-users" , "" , "No", "Yes" } ) aadd( aAct, { "HarbourDevList" , "Harbour Developers (Mailing Lists)", "list-developers", "", "No", "Yes" } )