(no commit message)
authorflorianh <florianh@web>
Sat, 27 Nov 2010 17:17:01 +0000 (09:17 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Sat, 27 Nov 2010 17:17:01 +0000 (09:17 -0800)
docs/how_to_get_to_the_desktop/index.mdwn

index 7f018e4..113a15c 100644 (file)
@@ -15,5 +15,43 @@ The basic pkgsrc tools are already provided with every DragonFly default install
 First choose a mirror next to you which provides a git repo containing the pkgsrc tree, you can find them on the [DragonFly mirrors page](http://www.dragonflybsd.org/mirrors/). Next copy the mirrors adress into the Makefile contained in /usr.
 
 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
+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.
+
+### Installing a package
+You got two possibilities to install a package. The first one is to install it from source and the second one is to install prebuild binaries. Depending on your cpu and the size of the package its faster installing binaries, but if you want to change some build options you have to install it by source.
+If you want to install binaries you only have to use the pkg_radd application. For example to install the xfce4 package just do:
+# pkg_radd xfce4
+If you want to install something by source you have to change into the packages directory contained in the pkgsrc tree and execute bmake install clean:
+# cd /usr/pkgsrc/security/openssh && bmake install clean
+If you build a package by source you can also change some build options if supported by the package.
+# cd /usr/pkgsrc/security/openssh && bmake show-options
+You will get a list of supported options. To change them install the package by:
+# bmake PKG_OPTIONS.<package_name>="-option1 option2" install clean
+
+### Removing a package
+If you don't need a package anymore and you want to remove it just change into the packages directory and do:
+# bmake deinstall
+
+### Updating packages
+From time to time you should update your packages, since there will be newer versions with bugfixes or new functionality. There are several methods to update packages but the best one is to use pkg_rolling-replace. You can install it with pkgsrc. After you've done that you'll only have to:
+# cd /usr && make pkgsrc-update
+# pkg_rolling-replace -u
+
+## The X Window System
+### Installing the Server
+### Installing appropriate drivers
+### Other importan X related packages
+### Configuring X
+## Installing a Desktop Environment
+### KDE
+### Xfce4