From owner-doc-jp@jp.freebsd.org  Thu Sep 30 00:39:11 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id AAA79904;
	Thu, 30 Sep 1999 00:39:11 +0900 (JST)
	(envelope-from owner-doc-jp@jp.FreeBSD.org)
Received: from mail.kt.rim.or.jp (root@mail.kt.rim.or.jp [202.247.130.53])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id AAA79899
	for <doc-jp@jp.freebsd.org>; Thu, 30 Sep 1999 00:39:10 +0900 (JST)
	(envelope-from kuriyama@sky.rim.or.jp)
Received: from rhea.sky.rim.or.jp (ppp514.kt.rim.or.jp [202.247.140.164])
	by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id AAA23803
	for <doc-jp@jp.freebsd.org>; Thu, 30 Sep 1999 00:39:05 +0900 (JST)
Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1])
	by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id AAA22481
	for <doc-jp@jp.freebsd.org>; Thu, 30 Sep 1999 00:39:02 +0900 (JST)
Date: Thu, 30 Sep 1999 00:39:00 +0900
Message-ID: <14322.12948.804390.19432P@localhost.sky.rim.or.jp>
From: Jun Kuriyama <kuriyama@sky.rim.or.jp>
To: Japanese Documentation Project <doc-jp@jp.freebsd.org>
User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd)
MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko")
Content-Type: text/plain; charset=ISO-2022-JP
Reply-To: doc-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: doc-jp 6728
Subject: [doc-jp 6728] <handbook> ports/chapter.sgml (1.32 -> 1.33)
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org
X-Originator: kuriyama@sky.rim.or.jp


$B!!$A$g$C$T$j!#(B


Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- chapter.sgml	1999/06/28 02:37:29	1.32
+++ chapter.sgml	1999/06/28 03:37:21	1.33
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $Id: chapter.sgml,v 1.31 1999/06/26 06:31:34 hoek Exp $
+     $Id: chapter.sgml,v 1.32 1999/06/28 02:37:29 billf Exp $
 -->
 
 <chapter id="ports">
@@ -946,15 +946,19 @@
     <para><emphasis>Contributed by &a.jkh;, &a.gpalmer;, &a.asami; &a.obrien;
 	and &a.hoek;.  28 August 1996.</emphasis></para>
 
-    <para>So, now you are interested in making your own port? Great!</para>
+    <para>So, now you are interested in making your own port or upgrading
+      an existing one?  Great!</para>
 	
     <para>What follows are some guidelines for creating a new port for
-      FreeBSD.  The bulk of the work is done by
+      FreeBSD.  If you want to upgrade an existing port, you should read this
+      and then read <xref linkend="port-upgrading">.</para>
+
+    <para>When this document is not sufficiently detailed, you should refer to
       <filename>/usr/ports/Mk/bsd.port.mk</filename>, which all port Makefiles
-      include.  Please refer to that file for more details on the inner
-      workings of the ports collection.  Even if you do not hack Makefiles
+      include.
+                                         Even if you do not hack Makefiles
       daily, it is well commented, and you will still gain much knowledge from
-      it.</para>
+      it.  Additionally, you may send specific questions to &a.ports;.</para>
 	  
     <note>
       <para>Only a fraction of the overridable variables
@@ -963,12 +967,12 @@
 	<filename>bsd.port.mk</filename>.  This file users a non-standard tab
 	setting.  <application>Emacs</application> and
 	<application>Vim</application> should recognise the setting on loading
-	the file.  <command>vi</command> or <command>ex</command> can be set
+	the file.  Both <command>vi</command> and <command>ex</command> can be set
 	to use the correct value by typing <command>:set tabstop=4</command>
 	once the file has been loaded.</para>
     </note>
     
-    <sect2>
+    <sect2 id="quick-porting">
       <title>Quick Porting</title>
       
       <para>This section tells you how to do a quick port.  In many cases, it
@@ -2258,6 +2262,14 @@
 	depending on the setting of <makevar>NOMANCOMPRESS</makevar> in
 	<filename>/etc/make.conf</filename>.</para>
 	  
+      <para>If your port tries to install multiple names for manpages using
+	symlinks or hardlinks, you must use the <makevar>MLINKS</makevar>
+	variable to identify these.  The link installed by your port will
+	be destroyed and recreated by <filename>bsd.port.mk</filename>
+	to make sure it points to the correct file.  Any manpages
+	listed in MLINKS must not be listed in the
+	<filename>PLIST</filename>.</para>
+	
       <para>To specify whether the manpages are compressed upon installation,
 	use the <makevar>MANCOMPRESSED</makevar> variable. This variable can
 	take three values, <literal>yes</literal>, <literal>no</literal> and
@@ -2294,6 +2306,7 @@
 MAN1=          foo.1
 MAN3=          bar.3
 MAN4=          baz.4
+MLINKS=        foo.1 alt-name.8
 MANLANG=       "" ja
 MAN3PREFIX=    ${PREFIX}/share/foobar
 MANCOMPRESSED= yes</programlisting>
@@ -2307,6 +2320,12 @@
 ${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
 ${PREFIX}/man/man4/baz.4.gz
 ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
+
+      <para>Additionally <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
+	may or may-not be installed by your port.  Regardless, a
+	symlink will be made to join the foo(1) manpage and
+	alt-name(8) manpage.</para>
+	
     </sect2>
 
     <sect2 id="porting-motif">
@@ -2894,14 +2913,15 @@
       </note>
     </sect2>
     
-    <sect2>
+    <sect2 id="port-upgrading">
       <title>Upgrading</title>
       
       <para>When you notice that a port is out of date compared to the latest
 	version from the original authors, first make sure you have the latest
 	port.  You can find them in the
 	<filename>ports/ports-current</filename> directory of the ftp mirror
-	sites.</para>
+	sites.  You may also use CVSup to keep your whole ports collection
+	up-to-date, as described in <xref linkend="cvsup-config">.</para>
 	    
       <para>The next step is to send a mail to the maintainer, if one is
 	listed in the port's <filename>Makefile</filename>.  That person may
@@ -2926,7 +2946,7 @@
 
       <note>
         <para>Once again, please use &man.diff.1; and not &man.shar.1; to send
-	  updates to existing ports.</para>
+	  updates to existing ports!</para>
       </note>
     </sect2>
     


$B$/$j$d$^(B // kuriyama@sky.rim.or.jp
        // kuriyama@FreeBSD.ORG
