From: florianh <florianh@web>
Date: Sat, 27 Nov 2010 17:23:22 +0000 (-0800)
Subject: (no commit message)
X-Git-Url: https://gitweb.dragonflybsd.org/ikiwiki.git/commitdiff_plain/d0f4eeeb2dbea083ee205f6dc3e26bf82d483146

---

diff --git a/docs/how_to_get_to_the_desktop/index.mdwn b/docs/how_to_get_to_the_desktop/index.mdwn
index 113a15c0..4ae4b2e9 100644
--- a/docs/how_to_get_to_the_desktop/index.mdwn
+++ b/docs/how_to_get_to_the_desktop/index.mdwn
@@ -16,13 +16,13 @@ First choose a mirror next to you which provides a git repo containing the pkgsr
 
 Now execute as root
 
-    #  cd /usr && make pkgsrc-create
+    # cd /usr && make pkgsrc-create
 
 to initally create the pkgsrc tree.
 
 ### Searching a package
 Since there are many different packages in the pkgsrc tree you can use a small tool to find the one you are looking for in a short time. For example if you are looking for the ruby package just do
-# pkg_search ruby
+    # pkg_search ruby
 and you will get a list of packages containing ruby in their name. If you want to install the ruby-1.9.2pl0 package now, just do
 # pkg_search -v ruby-1.9.2pl0
 and you will get the path leading to the package.
@@ -49,9 +49,78 @@ From time to time you should update your packages, since there will be newer ver
 
 ## The X Window System
 ### Installing the Server
+The installation of the X Window System contains a few steps. We will start with the most basic one: Installing the X-Server.
+To do so you have to execute as root
+# cd /usr/pkgsrc/x11/modular-xorg-server && bmake install clean
+or if you want to install it as a binary
+# pkg_radd modular-xorg-server
+
 ### Installing appropriate drivers
+You now need some input drivers and a video driver for your video card.
+If you want to install all input and video drivers so you can test them out install the modular-xorg-drivers package
+# cd /usr/pkgsrc/meta-pkgs/modular-xorg-drivers && bmake install clean
+or if you want to install them as binaries
+# pkg_radd modular-xorg-drivers
+
+If you know which drivers you need install them on your own needs. They can be found in /usr/pkgsrc/x11/ and are named xf86-<video or input>-<driver name>
+
 ### Other importan X related packages
+Now we will install other important packages for X. We will need some additional libraries
+# cd /usr/pkgsrc/meta-pkgs/modular-xorg-libs && bmake install clean
+or if you want to install them as binaries
+# pkg_radd modular-xorg-libs
+
+Next we'll need some fonts
+# cd /usr/pkgsrc/meta-pkgs/modular-xorg-fonts && bmake install clean
+or if you want to install them as binaries
+# pkg_radd modular-xorg-fonts
+
+Last package we need contains some useful applications like xterm and startx
+# cd /usr/pkgsrc/meta-pkgs/modular-xorg-apps && bmake install clean
+or if you want to install them as binaries
+# pkg_radd modular-xorg-apps
+
 ### Configuring X
+Since we have installed all necessary packages now we have to configure X so it works like we want it. First execute as root
+# Xorg -configure
+# cp /root/xorg.conf.new /etc/X11/xorg.conf
+Now we have a basic configuration file for X.
+As normal user now create a file named ~/.xinitrc and write exec xterm in it. Now make it executable
+# chmod +x ~/.xinitrc
+Now you can try to start the X server by doing
+# startx
+as normal user.
+If everything works well you should see a white terminal and should be able to mover your mouse. Click into the terminal and test you keyboard layout. Now type exit into the terminal and you will return to TTY. If everything worked well you can continue with installing a desktop environment, if not you have to manually edit /etc/X11/xorg.conf . Also check the X.org documentation and the DragonFly handbook, where you may find a solution to your problem.
+
 ## Installing a Desktop Environment
+
+This part will explain how to install the desktop environments KDE and Xfce, if you prefer GNOME or a standalone windowmanager you have to read other guides or documentation.
 ### KDE
+KDE stands for K Desktop Environment, its a modern desktop environment, based on Nokia's QT-Framework, with many nice applications. If your computer has less than 1Gb RAM you should better install Xfce4 described later in this guide.
+Since the KDE and QT packages are pretty huge you can save much time when using binary packages.
+There are 2 different KDE meta-packages available: KDE3 and KDE4 . KDE3 is the older, but more stable release while KDE4 has many new features but also new bugs. So it's on you to decide which one you want to install.
+For KDE3 simply do as root
+# pkg_radd kde3
+For KDE4
+# pkg_radd kde4
+
+Now that you have installed KDE we still need to start it.
+As user edit your ~/.xinitrc and comment the exec xterm part out and add exec startkde.
+Now start it with executing startx as user. If everything works well you should see a standard KDE desktop, you now can explore ist or read documentation to see what you can do with it.
+
+Some users may prefer a graphical log in, KDE provides it's own display manager for them: kdm. It looks better than the X display manager xdm and provides more options. To start it at boot time simply change your ttyv8 line in /etc/ttys to ttyv8 “/usr/pkg/bin/kdm -nodaemon” xterm on secure .
+
 ### Xfce4
+Xfce is a lightweight desktop environment using the GTK+ toolkit (like GNOME) it has less applications than KDE but if your computer isn't that good it's the better choice. 
+To install Xfce4 simply install the xfce4 and xfce4- meta-packages as root
+# pkg_radd xfce4 && pkg_radd xfce4-extras
+or if you want to compile them yourself
+# cd /usr/pkgsrc/meta-pkgs/xfce4 && bmake install clean
+# cd /usr/pkgsrc/meta-pkgs/xfce4-extras && bmake install clean
+To test if it works edit your ~/.xinitrc as user, comment the exec xterm part out and add exec startxfce4.
+Since Xfce doesnt have its own display manager for a graphical login so you have to install one yourself. You could either install xdm, kdm or gdm. Gdm is the GNOME display manager and also uses the GTK+ toolkit so it's a good choice for Xfce, too.
+Install gdm by executing:
+# pkg_radd gdm
+or
+# cd /usr/pkgsrc/x11/gdm && bmake install
+To start it at boot time you can simply add gdm_enable=”YES” to your /etc/rc.conf