Initialize the dummy char we send down the pipe to make valgrind
[wine.git] / documentation / glossary.sgml
blob301cb8bbdf7719463f24bb394275220302eb35be
1 <glossary>
2 <title>Glossary</title>
3 <!--
4 EXAMPLE:
5 <glossdiv>
6 <title>test</title>
7 <glossentry sortas="rme">
8 <glossterm id="bad_mistake">Very Stupid Mistake</glossterm>
9 <glosssee>things_to_avoid</glosssee>
10 <acronym>VSM</acronym>
11 <abbrev>Doh!</abbrev>
12 <glossseealso otherterm="accident">
13 <glossdef>
14 <para>Something you should try to avoid at all costs.</para>
15 </glossdef>
16 </glossentry>
17 </glossdiv>
18 -->
19 <glossdiv>
20 <title></title>
21 <glossentry>
22 <glossterm>Binary</glossterm>
23 <glossdef>
24 <para>
25 A file which is in machine executable, compiled form: hex data (as opposed to a source code file).
26 </para>
27 </glossdef>
28 </glossentry>
29 <glossentry>
30 <glossterm>CVS</glossterm>
31 <glossdef>
32 <para>
33 Concurrent Versions System, a software package to manage software development done by several people. See the CVS chapter in the Wine Developers Guide for detailed usage information.
34 </glossdef>
35 </glossentry>
36 <glossentry>
37 <glossterm>Distribution</glossterm>
38 <glossdef>
39 <para>
40 A distribution is usually the way in which some "vendor" ships operating system CDs (usually mentioned in the context of Linux).
41 A Linux environment can be shipped in lots of different configurations: e.g. distributions could be built to be suitable for games, scientific
42 applications, server operation, desktop systems, etc.
43 </para>
44 </glossdef>
45 </glossentry>
46 <glossentry>
47 <glossterm>DLL</glossterm>
48 <glossdef>
49 <para>
50 A DLL (Dynamic Link Library) is a file that can be loaded and executed by programs dynamically. Basically it's an external code repository for programs.
51 Since usually several different programs reuse the same DLL instead of having that code in their own file, this dramatically reduces required storage space.
52 A synonym for a DLL would be library.
53 </para>
54 </glossdef>
55 </glossentry>
56 <glossentry>
57 <glossterm>Editor</glossterm>
58 <glossdef>
59 <para>
60 An editor is usually a program to create or modify text files.
61 There are various graphical and text mode editors available on
62 Linux.
63 </para>
64 <para>
65 Examples of graphical editors are: nedit, gedit, kedit, xemacs,
66 gxedit.
67 </para>
68 <para>
69 Examples of text mode editors are: joe, ae, emacs, vim, vi.
70 In a <glossterm>terminal</glossterm>, simply run them via:
71 </para>
72 <screen>
73 <prompt>$ </><userinput><replaceable>editorname</replaceable>
74 <replaceable>filename</replaceable></>
75 </screen>
76 </glossdef>
77 </glossentry>
78 <glossentry>
79 <glossterm>Environment variable</glossterm>
80 <glossdef>
81 <para>
82 Environment variables are text definitions used in a <glossterm>Shell</glossterm> to store important system settings.
83 In a <command>bash</command> shell (the most commonly used one in Linux),
84 you can view all environment variables by executing:
85 </para>
86 <screen>
87 <userinput>set</userinput>
88 </screen>
89 <para>
90 If you want to change an environment variable, you could run:
91 </para>
92 <screen>
93 <userinput>export <replaceable>MYVARIABLE</>=<replaceable>mycontent</></userinput>
94 </screen>
95 <para>
96 For deleting an environment variable, use:
97 </para>
98 <screen>
99 <userinput>unset <replaceable>MYVARIABLE</></userinput>
100 </screen>
101 </glossdef>
102 </glossentry>
103 <glossentry>
104 <glossterm>Package</glossterm>
105 <glossdef>
106 <para>
107 A package is a compressed file in a
108 <glossterm>distribution</glossterm> specific format. It contains the
109 files for a particular program you want to install. Packages are
110 usually installed via the <command>dpkg</command> or
111 <command>rpm</command> package managers.
112 </para>
113 </glossdef>
114 </glossentry>
115 <glossentry>
116 <glossterm>root</glossterm>
117 <glossdef>
118 <para>
119 root is the account name of the system administrator.
120 In order to run programs as root, simply open a
121 <glossterm>Terminal</glossterm> window, then run:
122 </para>
123 <screen>
124 <prompt>$ </><userinput>su -</>
125 </screen>
126 <para>
127 This will prompt you for the password of the root user of your system,
128 and after that you will be able to system administration tasks
129 that require special root privileges. The root account is indicated by the
130 </para>
131 <screen>
132 <prompt># </>
133 </screen>
134 <para>
135 prompt, whereas '$' indicates a normal user account.
136 </para>
137 </glossdef>
138 </glossentry>
139 <glossentry>
140 <glossterm>Shell</glossterm>
141 <glossdef>
142 <para>
143 A shell is a tool to enable users to interact with the
144 system. Usually shells are text based and command line oriented.
145 Examples of popular shells include <command>bash</command>,
146 <command>tcsh</command> and <command>ksh</command>. Wine assumes
147 that for Wine installation tasks, you use <command>bash</command>,
148 since this is the most popular shell on Linux.
149 Shells are usually run in a <glossterm>Terminal</glossterm> window.
150 </para>
151 <!-- <glossseealso otherterm="Terminal"> -->
152 </glossdef>
153 </glossentry>
154 <glossentry>
155 <glossterm>Source code</glossterm>
156 <glossdef>
157 <para>
158 Source code is the code that a program consists of before the program
159 is being compiled, i.e. it's the original building instructions of a
160 program that tell a compiler what the program should look like once
161 it's been compiled to a <glossterm>Binary</glossterm>.
162 </para>
163 </glossdef>
164 </glossentry>
165 <glossentry>
166 <glossterm>Terminal</glossterm>
167 <glossdef>
168 <para>
169 A terminal window is usually a graphical window that one uses to
170 execute a <command>Shell</command>. If Wine asks you to open a
171 terminal, then you usually need to click on an icon on your desktop
172 that shows a big black window (or, in other cases, an icon displaying a
173 maritime shell).
174 Wine assumes you're using the <command>bash</command> shell in a
175 terminal window, so if your terminal happens to use a different
176 shell program, simply type:
177 </para>
178 <screen>
179 <userinput>bash</>
180 </screen>
181 <para>
182 in the terminal window.
183 </para>
184 </glossdef>
185 </glossentry>
186 </glossary>