Bug 160447

Summary: [handbook] Developer's Handbook contains some outdated information
Product: Documentation Reporter: Glen Barber <gjb>
Component: Books & ArticlesAssignee: Isabell Long <issyl0>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Glen Barber freebsd_committer freebsd_triage 2011-09-04 04:50:09 UTC
Submitted by (radiomlodychbandytow % o2 ! pl) via docs:

First, http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/emacs.html
It starts with "Unfortunately, UNIX® systems do not come with the kind of everything-you-ever-wanted-and-lots-more-you-did-not-in-one-gigantic-package integrated development environments that other systems have.", after which is a reference to a statement that notes its outdated, but nevertheless the line clearly deserves removal.

Then "Also, you will need a fair amount of memory to run it--I would recommend 8MB in text mode and 16MB in X as the bare minimum to get reasonable performance."
It's just funny.

Fix: 

PR generated so we don't lose track of this.
Comment 1 Isabell Long freebsd_committer freebsd_triage 2012-06-24 18:17:35 UTC
Responsible Changed
From-To: freebsd-doc->issyl0

Take this PR.
Comment 2 dfilter service freebsd_committer freebsd_triage 2012-06-28 10:10:52 UTC
Author: issyl0
Date: Thu Jun 28 09:10:37 2012
New Revision: 39144
URL: http://svn.freebsd.org/changeset/doc/39144

Log:
  Remove outdated information from the Emacs section of the developer's
  handbook.
  
  PR:		docs/160447
  Submitted by:	radiomlodychbandytow [at] o2 [dot] pl (on the mailing list;
  		PRed by gjb)
  Reviewed by:	gjb
  Approved by:	gabor (mentor)

Modified:
  head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml

Modified: head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml	Thu Jun 28 08:53:51 2012	(r39143)
+++ head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml	Thu Jun 28 09:10:37 2012	(r39144)
@@ -1674,29 +1674,7 @@ else if (pid == 0) {		/* child */
     <sect2>
       <title>Emacs</title>
 
-      <para>Unfortunately, &unix; systems do not come with the kind of
-	everything-you-ever-wanted-and-lots-more-you-did-not-in-one-gigantic-package
-	integrated development environments that other systems
-	have.
-
-	<footnote>
-	  <para>Some powerful, free IDEs now exist, such as KDevelop
-	    in the Ports Collection.</para>
-	</footnote>
-
-	However, it is possible to set up your own environment.  It
-	may not be as pretty, and it may not be quite as integrated,
-	but you can set it up the way you want it.  And it is free.
-	And you have the source to it.</para>
-
-      <para>The key to it all is Emacs.  Now there are some people who
-	loathe it, but many who love it.  If you are one of the former,
-	I am afraid this section will hold little of interest to you.
-	Also, you will need a fair amount of memory to run it&mdash;I would
-	recommend 8MB in text mode and 16MB in X as the bare minimum
-	to get reasonable performance.</para>
-
-      <para>Emacs is basically a highly customizable
+      <para>Emacs is a highly customizable
 	editor&mdash;indeed, it has been customized to the point where
 	it is more like an operating system than an editor! Many
 	developers and sysadmins do in fact spend practically all
@@ -1748,14 +1726,9 @@ else if (pid == 0) {		/* child */
 	    you to look at the source code as you step through your
 	    program.</para>
 	</listitem>
-
-	<listitem>
-	  <para>You can read Usenet news and mail while your program
-	    is compiling.</para>
-	</listitem>
       </itemizedlist>
 
-      <para>And doubtless many more that I have overlooked.</para>
+      <para>And doubtless many more that have been overlooked.</para>
 
       <para>Emacs can be installed on &os; using
 	the <filename role="package">editors/emacs</filename>
_______________________________________________
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"
Comment 3 Isabell Long freebsd_committer freebsd_triage 2012-06-28 10:18:44 UTC
State Changed
From-To: open->closed

I produced and committed a patch for this.