From nobody@FreeBSD.org  Sat Aug 17 13:05:39 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTP id 2D90A152
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 17 Aug 2013 13:05:39 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from oldred.freebsd.org (oldred.freebsd.org [8.8.178.121])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 1B0DE2766
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 17 Aug 2013 13:05:39 +0000 (UTC)
Received: from oldred.freebsd.org ([127.0.1.6])
	by oldred.freebsd.org (8.14.5/8.14.7) with ESMTP id r7HD5cW4052129
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 17 Aug 2013 13:05:38 GMT
	(envelope-from nobody@oldred.freebsd.org)
Received: (from nobody@localhost)
	by oldred.freebsd.org (8.14.5/8.14.5/Submit) id r7HD5cAa052124;
	Sat, 17 Aug 2013 13:05:38 GMT
	(envelope-from nobody)
Message-Id: <201308171305.r7HD5cAa052124@oldred.freebsd.org>
Date: Sat, 17 Aug 2013 13:05:38 GMT
From: Hendrik Lugtenburg <hendrik.lugtenburg@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [handbook] Remove KDE3
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         181353
>Category:       docs
>Synopsis:       [handbook] Remove KDE3
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 17 13:10:00 UTC 2013
>Closed-Date:    Thu Aug 22 21:34:22 UTC 2013
>Last-Modified:  Thu Aug 22 22:50:01 UTC 2013
>Originator:     Hendrik Lugtenburg
>Release:        9
>Organization:
>Environment:
>Description:
As KDE 3 is removed from ports (see ports/UPDATING 20130726) I have taken the liberty to wipe it out of the X11 section in the handbook.

By the way, this is my first contribution to docs, so I hope you'll forgive me if I did something wrong.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: books/handbook/x11/chapter.xml
===================================================================
--- books/handbook/x11/chapter.xml	(revision 42558)
+++ books/handbook/x11/chapter.xml	(working copy)
@@ -1581,15 +1581,6 @@
 	  <application>KDE</application>, consult the <ulink
 	  url="http://freebsd.kde.org/">KDE/FreeBSD
 	  initiative</ulink>'s website.</para>
-
-	<para>There are two versions of
-	  <application>KDE</application> available on FreeBSD.
-	  Version 3 has been around for a long time, and is still
-	  available in the Ports Collection though it's now
-	  unmaintained and partially broken.  Version 4 is
-	  punctually updated and is the default choice for
-	  <application>KDE</application> users.  They can even be
-	  installed side by side.</para>
       </sect3>
 
       <sect3 id="x11-wm-kde-install">
@@ -1599,30 +1590,23 @@
 	  other desktop environment, the software can be easily
 	  installed from a package or the Ports Collection:</para>
 
-	<para>To install the <application>KDE 3</application> package
-	  from the network, type:</para>
-
-	<screen>&prompt.root; <userinput>pkg_add -r kde</userinput></screen>
-
-	<para>To install the <application>KDE 4</application> package
-	  from the network, type:</para>
-
 	<screen>&prompt.root; <userinput>pkg_add -r kde4</userinput></screen>
 
 	<para>&man.pkg.add.1; will automatically fetch the latest
 	  version of the application.</para>
+  	<para>Or if you use <application>pkgng</application>:
+	</para>
+	<screen>&prompt.root; <userinput>pkg install kde4</userinput></screen>
 
-	<para>To build <application>KDE 3</application> from source,
+	<para>To build <application>KDE</application> from source,
 	  use the ports tree:</para>
 
-	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde3</userinput>
-&prompt.root; <userinput>make install clean</userinput></screen>
-
-	<para>To build <application>KDE 4</application> from source,
-	  use the ports tree:</para>
-
 	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
+	<para>This will pop up a curses based menu that let you choose
+		which modules to install. Note that it is a very large port 
+		and will take quite some time to compile.
+	</para>
 
 	<para>After <application>KDE</application> has been installed,
 	  the X server must be told to launch this application
@@ -1629,12 +1613,6 @@
 	  instead of the default window manager.  This is accomplished
 	  by editing the <filename>.xinitrc</filename> file:</para>
 
-	<para>For <application>KDE 3</application>:</para>
-
-	<screen>&prompt.user; <userinput>echo "exec startkde" &gt; ~/.xinitrc</userinput></screen>
-
-	<para>For <application>KDE 4</application>:</para>
-
 	<screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" &gt; ~/.xinitrc</userinput></screen>
 
 	<para>Now, whenever the X Window System is invoked with
@@ -1684,18 +1662,7 @@
 	  <application>GNOME</application>, or something else) to
 	  run after logging on.</para>
 
-	<para>To enable <application>KDM</application>, different
-	  files need to be edited depending on the version of
-	  <application>KDE</application>.</para>
-
-	<para>For <application>KDE 3</application>, the
-	  <literal>ttyv8</literal> entry in
-	  <filename>/etc/ttys</filename> has to be adapted as
-	  follows:</para>
-
-	 <programlisting>ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure</programlisting>
-
-	<para>For <application>KDE 4</application>, you have to mount
+  <para>For <application>KDE 4</application>, you have to mount
 	  &man.procfs.5; and add the following line to
 	  <filename>/etc/rc.conf</filename>:</para>
 


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Sat Aug 17 14:20:49 UTC 2013 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=181353 
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Thu Aug 22 21:34:01 UTC 2013 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=181353 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/181353: commit references a PR
Date: Thu, 22 Aug 2013 22:45:58 +0000 (UTC)

 --===============6897461099231335955==
 Content-Type: text/plain; charset=UTF-8
 Content-Transfer-Encoding: 8bit
 
 Author: wblock
 Date: Thu Aug 22 21:33:53 2013
 New Revision: 42571
 URL: http://svnweb.freebsd.org/changeset/doc/42571
 
 Log:
   Remove mention of KDE3 from the Handbook desktop environments section.
   Modified patch from PR.  Thanks to Hendrik Lugtenburg for his patience.
   
   PR:		docs/181353
   Submitted by:	Hendrik Lugtenburg <hendrik.lugtenburg@gmail.com>
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Thu Aug 22 20:36:35 2013	(r42570)
 +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Thu Aug 22 21:33:53 2013	(r42571)
 @@ -1581,15 +1581,6 @@ DisplayManager.requestPort:     0</scree
  	  <application>KDE</application>, consult the <ulink
  	  url="http://freebsd.kde.org/">KDE/FreeBSD
  	  initiative</ulink>'s website.</para>
 -
 -	<para>There are two versions of
 -	  <application>KDE</application> available on FreeBSD.
 -	  Version 3 has been around for a long time, and is still
 -	  available in the Ports Collection though it's now
 -	  unmaintained and partially broken.  Version 4 is
 -	  punctually updated and is the default choice for
 -	  <application>KDE</application> users.  They can even be
 -	  installed side by side.</para>
        </sect3>
  
        <sect3 id="x11-wm-kde-install">
 @@ -1598,12 +1589,6 @@ DisplayManager.requestPort:     0</scree
  	<para>Just as with <application>GNOME</application> or any
  	  other desktop environment, the software can be easily
  	  installed from a package or the Ports Collection:</para>
 -
 -	<para>To install the <application>KDE 3</application> package
 -	  from the network, type:</para>
 -
 -	<screen>&prompt.root; <userinput>pkg_add -r kde</userinput></screen>
 -
  	<para>To install the <application>KDE 4</application> package
  	  from the network, type:</para>
  
 @@ -1612,29 +1597,30 @@ DisplayManager.requestPort:     0</scree
  	<para>&man.pkg.add.1; will automatically fetch the latest
  	  version of the application.</para>
  
 -	<para>To build <application>KDE 3</application> from source,
 -	  use the ports tree:</para>
 +	<para>For <application>pkgng</application> users, the
 +	  equivalent command is:</para>
  
 -	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde3</userinput>
 -&prompt.root; <userinput>make install clean</userinput></screen>
 +	<screen>&prompt.root; <userinput>pkg install kde4</userinput></screen>
  
 -	<para>To build <application>KDE 4</application> from source,
 +	<para>To build <application>KDE</application> from source,
  	  use the ports tree:</para>
  
  	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput>
  &prompt.root; <userinput>make install clean</userinput></screen>
  
 +	<para>The first time the port is installed, a menu will be
 +	  shown for selecting options. Accepting the defaults is
 +	  recommended.</para>
 +
 +	<para><application>KDE 4</application> is a large application,
 +	  and will take quite some time to compile even on a fast
 +	  computer.</para>
 +
  	<para>After <application>KDE</application> has been installed,
  	  the X server must be told to launch this application
  	  instead of the default window manager.  This is accomplished
  	  by editing the <filename>.xinitrc</filename> file:</para>
  
 -	<para>For <application>KDE 3</application>:</para>
 -
 -	<screen>&prompt.user; <userinput>echo "exec startkde" &gt; ~/.xinitrc</userinput></screen>
 -
 -	<para>For <application>KDE 4</application>:</para>
 -
  	<screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" &gt; ~/.xinitrc</userinput></screen>
  
  	<para>Now, whenever the X Window System is invoked with
 @@ -1684,19 +1670,8 @@ DisplayManager.requestPort:     0</scree
  	  <application>GNOME</application>, or something else) to
  	  run after logging on.</para>
  
 -	<para>To enable <application>KDM</application>, different
 -	  files need to be edited depending on the version of
 -	  <application>KDE</application>.</para>
 -
 -	<para>For <application>KDE 3</application>, the
 -	  <literal>ttyv8</literal> entry in
 -	  <filename>/etc/ttys</filename> has to be adapted as
 -	  follows:</para>
 -
 -	 <programlisting>ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure</programlisting>
 -
 -	<para>For <application>KDE 4</application>, you have to mount
 -	  &man.procfs.5; and add the following line to
 +	<para><application>KDE 4</application> requires that
 +	  &man.procfs.5; be mounted, and this line must be added to
  	  <filename>/etc/rc.conf</filename>:</para>
  
  	<programlisting>kdm4_enable="YES"</programlisting>
 
 --===============6897461099231335955==
 Content-Type: text/plain; charset="us-ascii"
 MIME-Version: 1.0
 Content-Transfer-Encoding: 7bit
 Content-Disposition: inline
 
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 --===============6897461099231335955==--
 
>Unformatted:
