Remove Note
[ikiwiki.git] / docs / newhandbook / GettingStarted / index.mdwn
CommitLineData
ca64e42d 1# I. Getting Started
2
3
4
5This part of the DragonFly Handbook is for users and administrators who are new to DragonFly. These chapters:
6
7
8
9
10* Introduce you to DragonFly.
11
12
13* Guide you through the installation process.
14
15
16* Teach you UNIX® basics and fundamentals.
17
18
19* Show you how to install the wealth of third party applications available for DragonFly.
20
21
22* Introduce you to X, the UNIX windowing system, and detail how to configure a desktop environment that makes you more productive.
23
24
25
26We have tried to keep the number of forward references in the text to a minimum so that you can read this section of the Handbook from front to back with the minimum page flipping required.
27
28
29## Intended Audience
30
31
32
33The DragonFly newcomer will find that the first section of this book guides the user through the DragonFly installation process and gently introduces the concepts and conventions that underpin UNIX®. Working through this section requires little more than the desire to explore, and the ability to take on broad new concepts as they are introduced.
34
35
36
37Once you have travelled this far, the second, far larger, section of the Handbook is a comprehensive reference to all manner of topics of interest to DragonFly system administrators. Some of these chapters may recommend that you do some prior reading, and this is noted in the synopsis at the beginning of each chapter.
38
39
40
41For a list of additional sources of information, please see [Appendix B](bibliography.html).
42
43
44<!-- Cut out of "Organization of This Book" -->
45
46
47
48## Conventions used in this book
49
50
51
52To provide a consistent and easy to read text, several conventions are followed throughout the book.
53
54
55
56### Typographic Conventions
57
58
59
60***Italic***
61
62 :: An ***italic*** font is used for filenames, URLs, emphasized text, and the first usage of technical terms.
63
64
65
66`Monospace`
67
68 :: A `monospaced` font is used for error messages, commands, environment variables, names of ports, hostnames, user names, group names, device names, variables, and code fragments.
69
70
71
72 **Bold**
73
74 :: A **bold** font is used for applications, commands, and keys.
75
76
77
78### User Input
79
80
81
82Keys are shown in **bold** to stand out from other text. Key combinations that are meant to be typed simultaneously are shown with **+** between the keys, such as:
83
84
85
86 **Ctrl** + **Alt** + **Del**
87
88
89
90Meaning the user should type the **Ctrl** , **Alt** ,and **Del** keys at the same time.
91
92
93
94Keys that are meant to be typed in sequence will be separated with commas, for example:
95
96
97
98 **Ctrl** + **X** , **Ctrl** + **S**
99
100
101
102Would mean that the user is expected to type the **Ctrl** and **X** keys simultaneously and then to type the **Ctrl** and **S** keys simultaneously.
103
104
105
106### Examples
107
108
109
110Examples starting with # indicate a command that must be invoked as the superuser in DragonFly. You can login as `root` to type the command, or login as your normal account and use [su(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=su&section1) to gain superuser privileges.
111
112
113
114
115
116 # dd if=kern.flp of=/dev/fd0
117
118
119
120
121
122Examples starting with % indicate a command that should be invoked from a normal user account. Unless otherwise noted, C-shell syntax is used for setting environment variables and other shell commands.
123
124
125
126
127
128 % top
129
130
131
132
133
134Examples starting with `E:\>` indicate a MS-DOS® command. Unless otherwise noted, these commands may be executed from a ***Command Prompt*** window in a modern Microsoft® Windows® environment.
135
136
137
138
139
140 E:\> tools\fdimage floppies\kern.flp A:
141
142
143
144
145
146## Acknowledgments
147
148
149
150The book you are holding represents the efforts of many hundreds of people around the world. Whether they sent in fixes for typos, or submitted complete chapters, all the contributions have been useful.
151
152
153
154The DragonFly Handbook was originally built from an edition of the FreeBSD Handbook. The FreeBSD Handbook was created by the collective hard work of hundreds of people, and the DragonFly Documentation Team appreciates all their labor.
155
156
157
158----
159
160
161
162
163
164