From mwlucas@blackhelicopters.org  Mon Nov 19 10:57:56 2001
Return-Path: <mwlucas@blackhelicopters.org>
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id 7D65337B405
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 Nov 2001 10:57:55 -0800 (PST)
Received: (from root@localhost)
	by blackhelicopters.org (8.11.6/8.11.6) id fAJIvtr93375;
	Mon, 19 Nov 2001 13:57:55 -0500 (EST)
	(envelope-from mwlucas)
Message-Id: <200111191857.fAJIvtr93375@blackhelicopters.org>
Date: Mon, 19 Nov 2001 13:57:55 -0500 (EST)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: cleanup on deinstalling ports section
X-Send-Pr-Version: 3.2

>Number:         32111
>Category:       docs
>Synopsis:       cleanup on deinstalling ports section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    mwlucas
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Nov 19 11:00:02 PST 2001
>Closed-Date:    Thu Dec 13 06:07:38 PST 2001
>Last-Modified:  Thu Dec 13 06:08:53 PST 2001
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

today's -doc tree

>Description:

Bunch of stupid little things.

1) "The next few paragraphs will cover just that."  No, really?  I
thought that this section was titled "Removing Installed Ports"
because it discussed the Project's attempts to crossbreed elephants
and kangaroos.

2) Don't insult the reader's attention span twice in one paragraph.
Once is entirely sufficient.  (I always recommend insulting the reader
about different things within a single paragraph.)

3) "managed to remove" is a bit strong.  The Ports Teams makes this
fairly easy, and if typing two words is "managing" to do something
then logging in must be a challenge.

4) Add mention of using pkg_delete to uninstall ports after a make
clean.

>How-To-Repeat:


>Fix:

*** en_US.ISO8859-1/books/handbook/ports/chapter.sgml-dist	Mon Nov 19 13:21:05 2001
--- en_US.ISO8859-1/books/handbook/ports/chapter.sgml	Mon Nov 19 13:46:51 2001
***************
*** 832,845 ****
        </indexterm>
        <para>Now that you know how to install ports, you are probably
          wondering how to remove them, just in case you install one and
! 	later on you decide that you installed the wrong port.  The next
! 	few paragraphs will cover just that.</para>
! 
!       <para>Now we will remove our previous example (which was 
  	<command>lsof</command> for
          those of you not paying attention).  As with installing ports,
  	the first thing you must do is change to the port directory,
- 	which if you remember was
  	<filename>/usr/ports/irc/lsof</filename>.  After you change
  	directories, you are ready to uninstall <command>lsof</command>.
  	This is done with
--- 832,842 ----
        </indexterm>
        <para>Now that you know how to install ports, you are probably
          wondering how to remove them, just in case you install one and
! 	later on you decide that you installed the wrong port.  
!         We will remove our previous example (which was 
  	<command>lsof</command> for
          those of you not paying attention).  As with installing ports,
  	the first thing you must do is change to the port directory,
  	<filename>/usr/ports/irc/lsof</filename>.  After you change
  	directories, you are ready to uninstall <command>lsof</command>.
  	This is done with
***************
*** 849,859 ****
  &prompt.root; <userinput>make deinstall</userinput>
  ===&gt;  Deinstalling for lsof-4.57</screen>
  
!       <para>That was easy enough.  You have now managed to remove
  	<command>lsof</command>
          from your system.  If you would like to reinstall it, you can do
  	so by running <command>make reinstall</command> from the
          <filename>/usr/ports/irc/lsof</filename> directory.</para>
      </sect2>
    </sect1>
  
--- 846,863 ----
  &prompt.root; <userinput>make deinstall</userinput>
  ===&gt;  Deinstalling for lsof-4.57</screen>
  
!       <para>That was easy enough.  You have removed
  	<command>lsof</command>
          from your system.  If you would like to reinstall it, you can do
  	so by running <command>make reinstall</command> from the
          <filename>/usr/ports/irc/lsof</filename> directory.</para>
+ 
+       <para>The <command>make deinstall</command> and <command>make
+         reinstall</command> sequence does not work once you have run
+         <command>make clean</command>.  If you want to deinstall a
+         port after cleaning, use <command>pkg_delete</command> as
+         discussed in the <link linkend="packages-using">Packages
+         section of the Handbook</link>.</para>
      </sect2>
    </sect1>
  
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->mwlucas 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Dec 6 19:49:20 PST 2001 
Responsible-Changed-Why:  
Michael can close his own PR's now :) 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32111 
State-Changed-From-To: open->closed 
State-Changed-By: mwlucas 
State-Changed-When: Thu Dec 13 06:07:38 PST 2001 
State-Changed-Why:  
Committed.  This is what you get for submitting too many PRs, you doofus... 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32111 
>Unformatted:
