Fix size return from InternetGetCookieW.
[wine.git] / documentation / glossary.sgml
blob9358aa9c85f87e96d39707501dcc39906a7f9afd
1 <glossary id="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 </para>
35 </glossdef>
36 </glossentry>
37 <glossentry>
38 <glossterm>Distribution</glossterm>
39 <glossdef>
40 <para>
41 A distribution is usually the way in which some "vendor" ships operating system CDs (usually mentioned in the context of Linux).
42 A Linux environment can be shipped in lots of different configurations: e.g. distributions could be built to be suitable for games, scientific
43 applications, server operation, desktop systems, etc.
44 </para>
45 </glossdef>
46 </glossentry>
47 <glossentry>
48 <glossterm>DLL</glossterm>
49 <glossdef>
50 <para>
51 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.
52 Since usually several different programs reuse the same DLL instead of having that code in their own file, this dramatically reduces required storage space.
53 A synonym for a DLL would be library.
54 </para>
55 </glossdef>
56 </glossentry>
57 <glossentry>
58 <glossterm>Editor</glossterm>
59 <glossdef>
60 <para>
61 An editor is usually a program to create or modify text files.
62 There are various graphical and text mode editors available on
63 Linux.
64 </para>
65 <para>
66 Examples of graphical editors are: nedit, gedit, kedit, xemacs,
67 gxedit.
68 </para>
69 <para>
70 Examples of text mode editors are: joe, ae, emacs, vim, vi.
71 In a <glossterm>terminal</glossterm>, simply run them via:
72 </para>
73 <screen>
74 <prompt>$ </><userinput><replaceable>editorname</replaceable>
75 <replaceable>filename</replaceable></>
76 </screen>
77 </glossdef>
78 </glossentry>
79 <glossentry>
80 <glossterm>Environment variable</glossterm>
81 <glossdef>
82 <para>
83 Environment variables are text definitions used in a <glossterm>Shell</glossterm> to store important system settings.
84 In a <command>bash</command> shell (the most commonly used one in Linux),
85 you can view all environment variables by executing:
86 </para>
87 <screen>
88 <userinput>set</userinput>
89 </screen>
90 <para>
91 If you want to change an environment variable, you could run:
92 </para>
93 <screen>
94 <userinput>export <replaceable>MYVARIABLE</>=<replaceable>mycontent</></userinput>
95 </screen>
96 <para>
97 For deleting an environment variable, use:
98 </para>
99 <screen>
100 <userinput>unset <replaceable>MYVARIABLE</></userinput>
101 </screen>
102 </glossdef>
103 </glossentry>
104 <glossentry>
105 <glossterm>Package</glossterm>
106 <glossdef>
107 <para>
108 A package is a compressed file in a
109 <glossterm>distribution</glossterm> specific format. It contains the
110 files for a particular program you want to install. Packages are
111 usually installed via the <command>dpkg</command> or
112 <command>rpm</command> package managers.
113 </para>
114 </glossdef>
115 </glossentry>
116 <glossentry>
117 <glossterm>root</glossterm>
118 <glossdef>
119 <para>
120 root is the account name of the system administrator.
121 In order to run programs as root, simply open a
122 <glossterm>Terminal</glossterm> window, then run:
123 </para>
124 <screen>
125 <prompt>$ </><userinput>su -</>
126 </screen>
127 <para>
128 This will prompt you for the password of the root user of your system,
129 and after that you will be able to system administration tasks
130 that require special root privileges. The root account is indicated by the
131 </para>
132 <screen>
133 <prompt># </>
134 </screen>
135 <para>
136 prompt, whereas '$' indicates a normal user account.
137 </para>
138 </glossdef>
139 </glossentry>
140 <glossentry>
141 <glossterm>Shell</glossterm>
142 <glossdef>
143 <para>
144 A shell is a tool to enable users to interact with the
145 system. Usually shells are text based and command line oriented.
146 Examples of popular shells include <command>bash</command>,
147 <command>tcsh</command> and <command>ksh</command>. Wine assumes
148 that for Wine installation tasks, you use <command>bash</command>,
149 since this is the most popular shell on Linux.
150 Shells are usually run in a <glossterm>Terminal</glossterm> window.
151 </para>
152 <!-- <glossseealso otherterm="Terminal"> -->
153 </glossdef>
154 </glossentry>
155 <glossentry>
156 <glossterm>Source code</glossterm>
157 <glossdef>
158 <para>
159 Source code is the code that a program consists of before the program
160 is being compiled, i.e. it's the original building instructions of a
161 program that tell a compiler what the program should look like once
162 it's been compiled to a <glossterm>Binary</glossterm>.
163 </para>
164 </glossdef>
165 </glossentry>
166 <glossentry>
167 <glossterm>Terminal</glossterm>
168 <glossdef>
169 <para>
170 A terminal window is usually a graphical window that one uses to
171 execute a <command>Shell</command>. If Wine asks you to open a
172 terminal, then you usually need to click on an icon on your desktop
173 that shows a big black window (or, in other cases, an icon displaying a
174 maritime shell).
175 Wine assumes you're using the <command>bash</command> shell in a
176 terminal window, so if your terminal happens to use a different
177 shell program, simply type:
178 </para>
179 <screen>
180 <userinput>bash</>
181 </screen>
182 <para>
183 in the terminal window.
184 </para>
185 </glossdef>
186 </glossentry>
187 </glossdiv>
188 </glossary>