385 changes: 308 additions & 77 deletions INSTALL

Large diffs are not rendered by default.

527 changes: 433 additions & 94 deletions doc/INSTALL.html

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions doc/INSTALL.t2t
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,9 @@ source directory.
%!include: osx.t2t

%!include: wcs-test-server.t2t

%!include: jenkins.t2t

%!include: debug-tests.t2t

%!include: iauthors.t2t
53 changes: 53 additions & 0 deletions doc/debug-tests.t2t
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@

= Debug output and running tests =

If you are interested in seeing embedded debug output, change the following
CMake option:

```
-D CMAKE_BUILD_TYPE=DEBUG (or RELWITHDEBINFO)
```

This will flood your terminal or system log with lots of useful output from
QgsDebugMsg() calls in source code.

If you would like to run the test suite, you will need to do so from the build
directory, as it will not work with the installed/bundled app. First set the
CMake option to enable tests:

```
-D ENABLE_TESTS=TRUE
```

Then run all tests from build directory:

```
cd build
make test
```

To run all tests and report to http://dash.orfeo-toolbox.org/index.php?project=QGIS

```
cd build
make Experimental
```

You can define the host name reported via 'make Experimental' by setting a CMake
option:

```
-D SITE="my.domain.org"
```

To run specific test(s) (see 'man ctest'):

```
cd build
# show listing of tests, without running them
ctest --show-only

# run specific C++ or Python test(s) matching a regular expression
ctest --verbose --tests-regex SomeTestName
```

4 changes: 4 additions & 0 deletions doc/iauthors.t2t
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ The following people have contributed to this document:
- OSX Section
- Tim Sutton 2007
- With special thanks to Tom Elwertowski and William Kyngesburye
- Larry Shaffer 2012

- GNU/Linux Section
- Tim Sutton 2006
Expand All @@ -35,3 +36,6 @@ The following people have contributed to this document:

- Latex Generator
- Tim Sutton 2011

- Debug Output/Tests Section
- Larry Shaffer 2012, by way of 'Test Friday' Tim Sutton
3 changes: 2 additions & 1 deletion doc/jenkins.t2t
Original file line number Diff line number Diff line change
Expand Up @@ -86,4 +86,5 @@ described elsewhere in this doc.

I based some of the set up from this nice blog article here:

* http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html
http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html

337 changes: 269 additions & 68 deletions doc/osx.t2t

Large diffs are not rendered by default.