--- wikisrc/pkgsrc/how_to_install_modular_xorg.mdwn	2011/11/20 20:28:27	1.1
+++ wikisrc/pkgsrc/how_to_install_modular_xorg.mdwn	2019/05/12 18:23:51	1.3
@@ -1,74 +1,60 @@
-**Contents**
-
-[[!toc levels=2]]
-
-#  Introduction
-
-The purpose of this document is to guide the reader on how to install the modular Xorg. 
-
-#  No X installed
-
-Assuming you have just made a clean install of NetBSD and you have not installed the X11 sets, you should do the following: 
-
-##  /etc/mk.conf
-
-Edit your /etc/mk.conf and add the following line: 
-    
-    X11_TYPE=modular
-    
-
-##  Install xorg server
-
-Provided that your pkgsrc tree lies in `/usr/pkgsrc`, type: 
-    
-    # cd /usr/pkgsrc/x11/modular-xorg-server
-    # make install
-    
-
-##  Install xorg apps
-    
-    # cd /usr/pkgsrc/meta-pkgs/modular-xorg-apps
-    # make install
-    
-
-##  Install xorg fonts
-    
-    # cd /usr/pkgsrc/meta-pkgs/modular-xorg-fonts
-    # make install
-    
-
-##  Install xorg input device
-    
-    # cd /usr/pkgsrc/x11/xf86-input-keyboard
-    # make install
-    
-
-And: 
-    
-    # cd /usr/pkgsrc/x11/xf86-input-mouse
-    # make install
-    
-
-##  Install xorg video driver
-
-In order to determine the appropriate driver for you, list the `/usr/pkgsrc/x11/xf86-video-*` files. For example, if you would need the nvidia driver, search for it: 
-    
-    # ls -ld xf86-video-* | grep nv
-    # drwxr-r-x  4 root wheel  512 Aug 26 16:17 xf86-video-nv
-    
-
-and then install it: 
-    
-    # cd /usr/pkgsrc/x11/xf86-video-nv
-    # make install
-    
-
-##  Configure Xorg
-
-Run as root the xorgconfig(1) utility to create an xorg.conf file. Or use command: 
-    
-    # X -configure
-    
-
-This will create /root/xorg.conf.new, which should be copied to /etc/X11/xorg.conf and possibly edited. 
-
+**Contents**
+
+[[!toc levels=2]]
+
+#  No X installed
+
+Assuming you have just made a clean install of NetBSD and you have not installed the X11 sets, you should do the following: 
+
+##  /etc/mk.conf
+
+Edit your /etc/mk.conf and add the following line: 
+    
+    X11_TYPE=modular
+    
+
+##  Install xorg
+
+Provided that your pkgsrc tree lies in `/usr/pkgsrc`, type: 
+    
+    # cd /usr/pkgsrc/meta-pkgs/modular-xorg
+    # make install
+    
+
+##  Configure Xorg
+
+Usually no configuration is necessary. To start X you use:
+
+    $ startx
+
+## Additional configuration
+
+Additional adjustments can be made in ~/.xinitrc and ~/.Xresources.
+For example, you may want to use a different terminal emulator font, such as pkgsrc/fonts/overpass.
+
+## ~/.Xresources
+
+To do so, we can add this line to ~/.Xresources:
+
+    *font: xft:overpass mono:size=12
+
+For this to take effect, we must do merge it into the database.
+
+    $ xrdb -merge ~/.Xresources
+
+To do this at every X startup, we can add it to ~/.xinitrc.
+
+<!-- XXX refer to further documentation on .xinitrc -->
+
+## ~/.xinitrc
+
+An example ~/.xinitrc to run a window manager and configure keyboard layout:
+
+    xrdb merge ~/.Xresources				# respect ~/.Xresources configuration
+
+    setxkbmap -option grp:alt_shift_toggle us,il	# two keyboard options, US keyboard and IL,
+    							# with alt+shift as a toggle option
+    
+    openbox						# run your favourite window manager.
+
+