1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Fontmatrix User Manual - Contributing - Testing and reporting</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="style.css" rel="stylesheet" type="text/css" />
</head>
<body>
<h2>Testing and reporting</h2>
<h3>Testing</h3>
<p>Testing is what helps making applications rock stable. Since we a re a community project, we rely on you, yes — you, our dear users.</p>
<p>We don't really encourage you to compile the most unstable cutting edge source code, but in case you find some bugs in the latest released version, do not hesitate to point them out to us.</p>
<h3>Crashers</h3>
<p>So you found a reproducible way to crash Fontmatrix. If you are on Linux, please use application called <b>gdb</b> to create a report which in programmers lingo is called <em>backtrace</em>. Here is how you do it:</p>
<ol>
<li>Install gdb via package manager</li>
<li>Open terminal</li>
<li>$ gdb fontmatrix</li>
<li>gdb's console appears</li>
<li><tt>> run</tt></li>
<li>Fontmatrix starts, a little slower than usually</li>
<li>Reproduce the crash</li>
<li>Go back to terminal</li>
<li><tt>> bt</tt></li>
<li>Copy the output using mouse and paste it somewhere</li>
<li><tt>> quit</tt></li>
</ol>
<p>If you are on Windows or Mac or simply do not have time to fiddle with gdb, at least own up and tell us exactly what you did.</p>
<h3>Reporting bugs and requesting features</h3>
<p>You can submit bugs reports to our
<a title="Go to https://gna.org/bugs/?func=additem&group=undertype"
href="https://gna.org/bugs/?func=additem&group=undertype">bugtracker</a>
(no need to register). Don’t worry about the "Undertype" name, as Fontmatrix
originally belonged to this bigger project.</p>
<p>A good, useful bug report contains:</p>
<ol>
<li>List of actions that led to a bug</li>
<li>Backtrace, if the application crashed (see above)</li>
<li>Information on your system</li>
</ol>
<p>Typical information on your system we would appreciate:</p>
<ul>
<li>Linux: name and version of distribution, version of Qt, version of Fontmatrix</li>
<li>Mac OS X: version of Mac OS X, version of Fontmatrix</li>
<li>Windows: version of Windows, version of Fontmatrix</li>
</ul>
<p>If you want to request a new feature, use the very same tracker.</p>
</body>
</html>
|
