| .\" Title: gtester |
| .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] |
| .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> |
| .\" Date: 06/12/2008 |
| .\" Manual: [FIXME: manual] |
| .\" Source: [FIXME: source] |
| .\" Language: English |
| .\" |
| .TH "GTESTER" "1" "06/12/2008" "[FIXME: source]" "[FIXME: manual]" |
| .\" ----------------------------------------------------------------- |
| .\" * (re)Define some macros |
| .\" ----------------------------------------------------------------- |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" toupper - uppercase a string (locale-aware) |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de toupper |
| .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
| \\$* |
| .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
| .. |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" SH-xref - format a cross-reference to an SH section |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de SH-xref |
| .ie n \{\ |
| .\} |
| .toupper \\$* |
| .el \{\ |
| \\$* |
| .\} |
| .. |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" SH - level-one heading that works better for non-TTY output |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de1 SH |
| .\" put an extra blank line of space above the head in non-TTY output |
| .if t \{\ |
| .sp 1 |
| .\} |
| .sp \\n[PD]u |
| .nr an-level 1 |
| .set-an-margin |
| .nr an-prevailing-indent \\n[IN] |
| .fi |
| .in \\n[an-margin]u |
| .ti 0 |
| .HTML-TAG ".NH \\n[an-level]" |
| .it 1 an-trap |
| .nr an-no-space-flag 1 |
| .nr an-break-flag 1 |
| \." make the size of the head bigger |
| .ps +3 |
| .ft B |
| .ne (2v + 1u) |
| .ie n \{\ |
| .\" if n (TTY output), use uppercase |
| .toupper \\$* |
| .\} |
| .el \{\ |
| .nr an-break-flag 0 |
| .\" if not n (not TTY), use normal case (not uppercase) |
| \\$1 |
| .in \\n[an-margin]u |
| .ti 0 |
| .\" if not n (not TTY), put a border/line under subheading |
| .sp -.6 |
| \l'\n(.lu' |
| .\} |
| .. |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" SS - level-two heading that works better for non-TTY output |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de1 SS |
| .sp \\n[PD]u |
| .nr an-level 1 |
| .set-an-margin |
| .nr an-prevailing-indent \\n[IN] |
| .fi |
| .in \\n[IN]u |
| .ti \\n[SN]u |
| .it 1 an-trap |
| .nr an-no-space-flag 1 |
| .nr an-break-flag 1 |
| .ps \\n[PS-SS]u |
| \." make the size of the head bigger |
| .ps +2 |
| .ft B |
| .ne (2v + 1u) |
| .if \\n[.$] \&\\$* |
| .. |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" BB/BE - put background/screen (filled box) around block of text |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de BB |
| .if t \{\ |
| .sp -.5 |
| .br |
| .in +2n |
| .ll -2n |
| .gcolor red |
| .di BX |
| .\} |
| .. |
| .de EB |
| .if t \{\ |
| .if "\\$2"adjust-for-leading-newline" \{\ |
| .sp -1 |
| .\} |
| .br |
| .di |
| .in |
| .ll |
| .gcolor |
| .nr BW \\n(.lu-\\n(.i |
| .nr BH \\n(dn+.5v |
| .ne \\n(BHu+.5v |
| .ie "\\$2"adjust-for-leading-newline" \{\ |
| \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
| .\} |
| .el \{\ |
| \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] |
| .\} |
| .in 0 |
| .sp -.5v |
| .nf |
| .BX |
| .in |
| .sp .5v |
| .fi |
| .\} |
| .. |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .\" BM/EM - put colored marker in margin next to block of text |
| .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| .de BM |
| .if t \{\ |
| .br |
| .ll -2n |
| .gcolor red |
| .di BX |
| .\} |
| .. |
| .de EM |
| .if t \{\ |
| .br |
| .di |
| .ll |
| .gcolor |
| .nr BH \\n(dn |
| .ne \\n(BHu |
| \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] |
| .in 0 |
| .nf |
| .BX |
| .in |
| .fi |
| .\} |
| .. |
| .\" ----------------------------------------------------------------- |
| .\" * set default formatting |
| .\" ----------------------------------------------------------------- |
| .\" disable hyphenation |
| .nh |
| .\" disable justification (adjust text to left margin only) |
| .ad l |
| .\" ----------------------------------------------------------------- |
| .\" * MAIN CONTENT STARTS HERE * |
| .\" ----------------------------------------------------------------- |
| .SH "Name" |
| gtester \- test running utility |
| .SH "Synopsis" |
| .fam C |
| .HP \w'\fBgtester\fR\ 'u |
| \fBgtester\fR [option...] [testprogram] |
| .fam |
| .SH "Description" |
| .PP |
| \fBgtester\fR |
| is a utility to run unit tests that have been written using the GLib test framework\&. |
| .PP |
| When called with the |
| \fB\-o\fR |
| option, |
| \fBgtester\fR |
| writes an XML report of the test results, which can be converted into HTML using the |
| \fBgtester\-report\fR |
| utility\&. |
| .SS "Options" |
| .PP |
| \fB\-h\fR, \fB\-\-help\fR |
| .RS 4 |
| print help and exit |
| .RE |
| .PP |
| \fB\-v\fR, \fB\-\-version\fR |
| .RS 4 |
| print version information and exit |
| .RE |
| .PP |
| \fB\-\-g\-fatal\-warnings\fR |
| .RS 4 |
| make warnings fatal |
| .RE |
| .PP |
| \fB\-k\fR, \fB\-\-keep\-going\fR |
| .RS 4 |
| continue running after tests failed |
| .RE |
| .PP |
| \fB\-l\fR |
| .RS 4 |
| list paths of available test cases |
| .RE |
| .PP |
| \fB\-m=\fR\fB\fIMODE\fR\fR |
| .RS 4 |
| run test cases in |
| \fIMODE\fR, which can be perf, slow, thorough or quick\&. The default mode is quick\&. |
| .RE |
| .PP |
| \fB\-p=\fR\fB\fITESTPATH\fR\fR |
| .RS 4 |
| only run test cases matching |
| \fITESTPATH\fR |
| .RE |
| .PP |
| \fB\-\-seed=\fR\fB\fISEEDSTRING\fR\fR |
| .RS 4 |
| run all test cases with random number seed |
| \fISEEDSTRING\fR |
| .RE |
| .PP |
| \fB\-o=\fR\fB\fILOGFILE\fR\fR |
| .RS 4 |
| write the test log to |
| \fILOGFILE\fR |
| .RE |
| .PP |
| \fB\-q\fR, \fB\-\-quiet\fR |
| .RS 4 |
| suppress per test binary output |
| .RE |
| .PP |
| \fB\-\-verbose\fR |
| .RS 4 |
| report success per testcase |
| .RE |
| .SH "See also" |
| .PP |
| |
| \fBgtester\-report\fR(1) |