Bug 103519

Summary: [patch] minor suggestions to changes in handbook ports section
Product: Documentation Reporter: Jeppe Larsen <jwl>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chapter.diff none

Description Jeppe Larsen 2006-09-23 15:40:22 UTC

    
Comment 1 Pav Lucistnik freebsd_committer freebsd_triage 2006-09-23 22:20:03 UTC
> @@ -1192,8 +1192,15 @@
>  
>        <para>To just fetch distfiles (or packages, if
>  	<option>-P</option> is specified) without building or
> -	installing anything, use <option>-F</option>.
> -	For further information see &man.portupgrade.1;.</para>
> +	installing anything, use <option>-F</option>.</para>
> +
> +      <para>The <application>portupgrade</application> suite also comes with 
> +	<command>portinstall</command> that automates the previously explained
> +	approach, so a port and all its dependcies will be compiled and installed
> +	with:</para>
> +	<screen>&prompt.root; <userinput>portinstall lsof</userinput></screen>
> +
> +	<para>For further information see &man.portupgrade.1;.</para>
>        </sect3>
>  
>        <sect3 id="portmanager">

I disagree with this change. There is absolutely no need for
portinstall, ever. It just changes to the respective directory and do
make install.

User can do this himself, absolutely.

>        <screen>&prompt.root; <userinput>portsclean -D</userinput></screen>
> +      <para>Or if you want to remove all distfiles not referenced by any port
> +      currently installed on your system:</para>
> +      <screen>&prompt.root; <userinput>portsclean -DD</userinput></screen>

Any particular need to duplicate portupgrade manpages here?
 
>        <para>Do not forget to remove the installed ports once you no longer need
> -	them.  A nice tool to help automate this task is available from the
> +	them. A nice tool to help automate this task is available from the
>  	<filename role="package">sysutils/pkg_cutleaves</filename> port.</para>
>      </sect2>

Please don't, the double space after full stop is a proper English.

-- 
Pav Lucistnik <pav@oook.cz>
              <pav@FreeBSD.org>

An arrow (+0,+0) {@f0} finds a mark. It dies.
Comment 2 dfilter service freebsd_committer freebsd_triage 2006-10-09 19:36:41 UTC
trhodes     2006-10-09 18:36:34 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/ports chapter.sgml 
  Log:
  Add information on portsclean -DD.
  
  PR:             103519
  Glanced at by:  pav
  
  Revision  Changes    Path
  1.260     +5 -0      doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2006-10-09 19:36:54 UTC
State Changed
From-To: open->closed

Manually merged the only part (portsclean -DD) which both 
made sense and was not argued.  Pav is right about the other 
parts and as such, they have not been merged.  Thanks for the 
submission! 


Comment 4 Tom Rhodes freebsd_committer freebsd_triage 2006-10-09 19:36:54 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me, closed_count++