Fossil SCM
Describe the debugging options.
Commit
d364933abc1ffe9960f67774e6344173b3cbf772c23ab46f3d6a5cd8cf142dde
Parent
f59c9ecb5eb25a1…
1 file changed
+27
-1
+27
-1
| --- www/makefile.wiki | ||
| +++ www/makefile.wiki | ||
| @@ -297,9 +297,35 @@ | ||
| 297 | 297 | dependences are used. |
| 298 | 298 | |
| 299 | 299 | Fossil includes a copy of [https://github.com/richgel999/miniz | miniz] |
| 300 | 300 | which can be used as an alternative to zlib. |
| 301 | 301 | |
| 302 | -<h1>7.0 See Also</h1> | |
| 302 | +<h1>7.0 Debugging</h1> | |
| 303 | + | |
| 304 | +Debug mode is controlled via FOSSIL_DEBUG preprocessor macro which could be | |
| 305 | +set explicitly at the make command for the target platform. | |
| 306 | + | |
| 307 | +However, in practice it is instead recommended to add a respective configure | |
| 308 | +option for the target platform and then perform a clean build. This way the | |
| 309 | +Debug flags are consistently applied across the whole build process. For | |
| 310 | +example, use these Debug flags in addition to other flags passed to the | |
| 311 | +configure scripts: | |
| 312 | + | |
| 313 | +On Linux, *NIX and similar platforms: | |
| 314 | +<blockquote><pre> | |
| 315 | +./configure --fossil-debug | |
| 316 | +</pre></blockquote> | |
| 317 | + | |
| 318 | +On Windows: | |
| 319 | +<blockquote><pre> | |
| 320 | +win\buildmsvc.bat FOSSIL_DEBUG=1 | |
| 321 | +</pre></blockquote> | |
| 322 | + | |
| 323 | +The resulting fossil binary could then be loaded into a platform-specific | |
| 324 | +debugger. Source files displayed in the debugger correspond to the ones | |
| 325 | +generated from the translation stage of the build process, that is what was | |
| 326 | +actually compiled into the object files. | |
| 327 | + | |
| 328 | +<h1>8.0 See Also</h1> | |
| 303 | 329 | |
| 304 | 330 | * [./tech_overview.wiki | A Technical Overview Of Fossil] |
| 305 | 331 | * [./adding_code.wiki | How To Add Features To Fossil] |
| 306 | 332 |
| --- www/makefile.wiki | |
| +++ www/makefile.wiki | |
| @@ -297,9 +297,35 @@ | |
| 297 | dependences are used. |
| 298 | |
| 299 | Fossil includes a copy of [https://github.com/richgel999/miniz | miniz] |
| 300 | which can be used as an alternative to zlib. |
| 301 | |
| 302 | <h1>7.0 See Also</h1> |
| 303 | |
| 304 | * [./tech_overview.wiki | A Technical Overview Of Fossil] |
| 305 | * [./adding_code.wiki | How To Add Features To Fossil] |
| 306 |
| --- www/makefile.wiki | |
| +++ www/makefile.wiki | |
| @@ -297,9 +297,35 @@ | |
| 297 | dependences are used. |
| 298 | |
| 299 | Fossil includes a copy of [https://github.com/richgel999/miniz | miniz] |
| 300 | which can be used as an alternative to zlib. |
| 301 | |
| 302 | <h1>7.0 Debugging</h1> |
| 303 | |
| 304 | Debug mode is controlled via FOSSIL_DEBUG preprocessor macro which could be |
| 305 | set explicitly at the make command for the target platform. |
| 306 | |
| 307 | However, in practice it is instead recommended to add a respective configure |
| 308 | option for the target platform and then perform a clean build. This way the |
| 309 | Debug flags are consistently applied across the whole build process. For |
| 310 | example, use these Debug flags in addition to other flags passed to the |
| 311 | configure scripts: |
| 312 | |
| 313 | On Linux, *NIX and similar platforms: |
| 314 | <blockquote><pre> |
| 315 | ./configure --fossil-debug |
| 316 | </pre></blockquote> |
| 317 | |
| 318 | On Windows: |
| 319 | <blockquote><pre> |
| 320 | win\buildmsvc.bat FOSSIL_DEBUG=1 |
| 321 | </pre></blockquote> |
| 322 | |
| 323 | The resulting fossil binary could then be loaded into a platform-specific |
| 324 | debugger. Source files displayed in the debugger correspond to the ones |
| 325 | generated from the translation stage of the build process, that is what was |
| 326 | actually compiled into the object files. |
| 327 | |
| 328 | <h1>8.0 See Also</h1> |
| 329 | |
| 330 | * [./tech_overview.wiki | A Technical Overview Of Fossil] |
| 331 | * [./adding_code.wiki | How To Add Features To Fossil] |
| 332 |