Bug 116068

Summary: [patch] Add "make config" and "make rmconfig" info to Handbook section on ports
Product: Documentation Reporter: Chess Griffin <chess.griffin>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Chess Griffin 2007-09-04 03:20:00 UTC
Here is a diff to add some information about using "make config" and
"make rmconfig" to reconfigure ports in the Handbook's section on Ports
after 4.5.2.2:

--- chapter.sgml.old	2007-09-03 21:48:01.000000000 -0400
+++ chapter.sgmledit	2007-09-03 22:01:31.000000000 -0400
@@ -1117,6 +1117,25 @@
 	  job.</para>
 
       </sect3>
+
+      <sect3>
+	<title>Reconfiguring Ports</title>
+
+	<para>When building certain ports, you may be presented with a
+	ncurses-based menu from which you can select certain build
+	options.  It is not uncommon for users to wish to revisit this
+	menu to add, remove, or change these options after a port has
+	been built.  There are many ways to do this.  One option is to
+	go into the directory containing the port and type
+	<command>make config</command>, which will simply present the
+	menu again with the same options selected.  Another option is
+	to use the command <command>make showconfig</command> which
+	will show you all the configuration options for the port.  Yet
+	another option is to type <command>make rmconfig</command>
+	which will remove all selected options and allow you to start
+	over.  All of these options, and others, are explained in
+	great detail in in the man page for &man.ports.7;.</para>
+    </sect3>
     </sect2>
 
     <sect2 id="ports-removing">
Comment 1 Chess Griffin 2007-09-08 02:52:46 UTC
Based on feedback I received from Remko, I have updated the diff to fix the indentation after <para>.  I hope it is correct now.  :-)

--- chapter.sgml.old	2007-09-03 21:48:01.000000000 -0400
+++ chapter.sgml	2007-09-07 21:48:13.000000000 -0400
@@ -1117,6 +1117,26 @@
 	  job.</para>
 
       </sect3>
+
+      <sect3>
+	<title>Reconfiguring Ports</title>
+
+	<para>When building certain ports, you may be presented with a
+	  ncurses-based menu from which you can select certain build
+	  options.  It is not uncommon for users to wish to revisit
+	  this menu to add, remove, or change these options after a
+	  port has been built.  There are many ways to do this.  One
+	  option is to go into the directory containing the port and
+	  type <command>make config</command>, which will simply
+	  present the menu again with the same options selected.
+	  Another option is to use the command <command>make
+	  showconfig</command> which will show you all the
+	  configuration options for the port.  Yet another option is
+	  to type <command>make rmconfig</command> which will remove
+	  all selected options and allow you to start over.  All of
+	  these options, and others, are explained in great detail in
+	  in the man page for &man.ports.7;.</para>
+      </sect3>
     </sect2>
 
     <sect2 id="ports-removing">

-- 
Chess Griffin
GPG Public Key:  0x0C7558C3
http://www.chessgriffin.com

Comment 2 Chess Griffin 2007-09-08 03:51:39 UTC
It looks like the diff formatting is not coming through by email -- it looks like there is no identation after <para> but in my diff it's there.  Should I send the diff as an attachment?

-- 
Chess Griffin
GPG Public Key:  0x0C7558C3
http://www.chessgriffin.com

Comment 3 Gabor Kovesdan freebsd_committer freebsd_triage 2007-12-21 15:34:09 UTC
Please send it to me in private mail.

Thanks,

-- 
Gabor Kovesdan
FreeBSD Volunteer

EMAIL: gabor@FreeBSD.org .:|:. gabor@kovesdan.org
WEB:   http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org
Comment 4 Gabor Kovesdan freebsd_committer freebsd_triage 2007-12-21 15:34:22 UTC
Responsible Changed
From-To: freebsd-doc->gabor

Take.
Comment 5 Chess Griffin 2007-12-21 16:52:26 UTC
On Fri, 21 Dec 2007 16:34:09 +0100
Gabor Kovesdan <gabor@FreeBSD.org> wrote:

> Please send it to me in private mail.
> 
> Thanks,
> 


Hi, Gabor, thanks for reviewing my patch!  I'm traveling right now
until the 26th, but upon my return, I will send you the patch via
email.  Thanks!

Chess

-- 
Chess Griffin
GPG Public Key:  0x0C7558C3
http://www.chessgriffin.com
Comment 6 dfilter service freebsd_committer freebsd_triage 2007-12-21 21:14:23 UTC
gabor       2007-12-21 21:14:20 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/ports chapter.sgml 
  Log:
  - Document how to reconfigure a port
  
  PR:             docs/116068
  Submitted by:   Chess Griffin <chess.griffin@gmail.com>
  
  Revision  Changes    Path
  1.269     +20 -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 7 Gabor Kovesdan freebsd_committer freebsd_triage 2007-12-21 21:56:13 UTC
State Changed
From-To: open->closed

Committed, thanks! You will see the change some hours later, when our 
doc set has been rebuilt from sources. 
I fixed the alignment by hand, so you don't need to send the patch any more. 
Have a nice holiday instead! :)