dri-faq/about.xml at main · hatarch/dri-faq · GitHub

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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<?xml version='1.0' encoding='iso-8859-1'?>

<sect1 id="about">
	<title>About this FAQ</title>

	<sect2 id="latest">
		<title>Where can I get the latest version of this FAQ?</title>

		<para>
		You can get the latest version of this FAQ in
		<ulink url="http://dri.sf.net/doc/faq/">
			http://dri.sf.net/doc/faq/
		</ulink>,
		also available in <ulink url="other-formats/">other formats</ulink>.
		</para>
	</sect2>

	<sect2 id="audience">
		<title>Who is the target audience of this FAQ?</title>

		<sect3 id="audience-users">
			<title>For the users...</title>

			<para>
			This FAQ is not really intended to users. But if you were curious to come so far you might
			consider collaborate with the developers by <link linkend="audience-testers">testing</link>
			the development branches helping improving the support for your 3D graphics card.
			</para>
		</sect3>

		<sect3 id="audience-testers">
			<title>For the testers...</title>

			<para>
			This FAQ will give you a good overview of what DRI is all about enabling you to make better bug-tracking.
			It also addresses the specific topics of debugging and benchmarking in the section
			<link linkend="testing" endterm="testing.title"></link>.
			</para>
		</sect3>

		<sect3 id="audience-developers">
			<title>For the developers...</title>

			<para>
			This FAQ will try give you a good jump-start in the knowledge of the DRI infrastructure so that you can more easily
			start to code in the area of your interest.
			</para>
		</sect3>

		<sect3 id="audience-gurus">
			<title>For the gurus...</title>

			<para>
			This FAQ is a convenient and easy way for you to share you wisdom with the newbies so consider
			submitting corrections, updates or additions to it.
			</para>
		</sect3>
	</sect2>

	<sect2 id="what-is-not">
		<title>What this FAQ is not?</title>

		<para>
		Although I try to gather as much useful information as possible this FAQ is not, and it will never be, a replacement of:
		</para>

		<itemizedlist>
			<listitem>
				<para>
				<emphasis role="strong">the original DRI documentation</emphasis>.
				Spite much of the information in the original DRI documentation is included in this FAQ not all was suited to be in a FAQ.
				Always take a look in it when need to know more.
				</para>
			</listitem>

			<listitem>
				<para>
				<emphasis role="strong">the source code</emphasis>.
				Any documentation gets out-of-date as soon as someone starts to code so always refer to it to know the state of
				development and implementations details.
				</para>
				<para>
				Don't get afraid by the size of the XFree86 tree. This FAQ will give you very good pointers to the specific places you
				need to look into.
				</para>
				<para>
				Do not forget to take a good peek at other drivers than the one you're interest.
				You will find very similarities and hints to how to proceed.
				</para>
			</listitem>

			<listitem>
				<para>
				<emphasis role="strong">the dri-devel mailing list</emphasis>.
				Always keep in touch with the others developers. We have a quite active developer base that will help you.
				</para>

				<para>
				Try to assist to the IRC meetings. You'll get the chance of talking directly with the others developers and get an insight of the DRI future.
				</para>
			</listitem>
		</itemizedlist>
	</sect2>
</sect1>