From owner-doc-jp-work@jp.FreeBSD.org Mon Jun  7 21:54:01 2010
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id o57Cs1V01870;
	Mon, 7 Jun 2010 21:54:01 +0900 (JST)
	(envelope-from owner-doc-jp-work@jp.FreeBSD.org)
Received: from mail-iw0-f170.google.com (mail-iw0-f170.google.com [209.85.214.170])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id o57CrvW01848;
	Mon, 7 Jun 2010 21:53:57 +0900 (JST)
	(envelope-from hosaka.yoshihiro@gmail.com)
Received: by iwn8 with SMTP id 8so905022iwn.1
        for <multiple recipients>; Mon, 07 Jun 2010 05:53:55 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:received:in-reply-to
         :references:date:message-id:subject:from:to:cc:content-type
         :content-transfer-encoding;
        bh=yCRJeUO1ybWO3Xp0tXeEGdcLEOYAXcL7Zw1m7HlSp30=;
        b=spsocnptl/6LqjfxvrozoJQ+CVk32OVgx4PmOfrCGDscEYemddKTRelVdLIVZyotp6
         MVhEiHrxRtHrh9yeJkjiejfDwuuMuwlxh5191Bljj9tMWTB6II89aCvvKaNde4cy2wnL
         97oiEUtQ8PuynfBLJUH4lwgd9ecHjqApD9xRw=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type:content-transfer-encoding;
        b=r5UP/sEFcm0ykSgBFDBrHZrFXPSG17GkLf/g3FEDaMwSoAxay1SaaXTUcevWh/e0SI
         YA+rZ5hP3QXk8XLod1FFxk7BTeUfgg2iMnkVhKu0J1Vu1Xqbn0KQvMqPk/L0SXBGPE0h
         IzZTH1Xyte77HrCnjhOiOweAp2HaMJaYXh9gs=
MIME-Version: 1.0
Received: by 10.231.174.129 with SMTP id t1mr7577388ibz.61.1275915235290; Mon, 
	07 Jun 2010 05:53:55 -0700 (PDT)
Received: by 10.231.206.14 with HTTP; Mon, 7 Jun 2010 05:53:55 -0700 (PDT)
In-Reply-To: <20100601.002159.193738444.ryusuke@jp.FreeBSD.org>
References: <20100601.002159.193738444.ryusuke@jp.FreeBSD.org>
Message-ID: <AANLkTinZEeLMGmwdJJWnlMRSMIrwVgM3AdikRUkhiP0R@mail.gmail.com>
From: Yoshihiro Hosaka <hosaka.yoshihiro@gmail.com>
To: Ryusuke SUZUKI <ryusuke@jp.FreeBSD.org>
Cc: doc-jp-work@jp.FreeBSD.org
Content-Type: text/plain; charset=ISO-2022-JP
Content-Transfer-Encoding: 7bit
Reply-To: doc-jp-work@jp.FreeBSD.org
Precedence: list
Date: Mon, 7 Jun 2010 21:53:55 +0900
X-Sequence: doc-jp-work 2069
Subject: [doc-jp-work 2069] Re: Porter's Handbook (1.183->1.195)
Sender: owner-doc-jp-work@jp.FreeBSD.org
X-Originator: hosaka.yoshihiro@gmail.com
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+060209

$BNkLZ$5$s(B
doc-jp-work$B$N3'MM(B

$B$*Hh$lMM$G$9!#J]:d$G$9!#(B

$B:#2s$N::FI$,40N;$7$^$7$?!#(B
$BFC$KLdBj$,$"$j$^$;$s!#(B
@@ -1954,
$B$NItJ,$NA08e$,CfESH>C<$K@Z$l$F$$$?$N$GA08e$N3NG'$r$7$^$7$?!#(B
$B$=$NItJ,$@$1:9J,0J30$bFI$_$^$7$?$,LdBj$"$j$^$;$s$G$7$?!#(B
$B0J>e$G$9!#(B

$B"(A02s$N::FI$G$$$m$$$m$H4*0c$$$r$7$F$$$F<:Ni$7$^$7$?!#(B
$B$^$?!"$$$m$$$m;XE&$7$?$N$OLdBj$,$"$k$+$i$H$$$&$h$j$O!"(B
$B::FI<+BN$,<+J,$NG'<1$H$7$F$O:G8e$N%A%'%C%/$@$H;W$C$F$$$?$?$a$G$9!#(B
$B8@$o$J$1$l$P%9%k!<$5$l$F$7$^$&$H!#(B
$B$^$?!"<+J,$N%9%-%k%l%Y%k$b9g$o$;$FG'<1$7$F$$$?$@$1$k$H;W$C$?$?$a$b$"$j$^$9!#(B
$BK]Lu$4C4Ev$NJ}$,5$$r0-$/$5$l$F$^$7$?$i!"$3$N>l$r<Z$j$F$*OM$S$7$F$*$-$^$9!#(B


2010$BG/(B6$B7n(B1$BF|(B0:21 Ryusuke SUZUKI <ryusuke@jp.freebsd.org>:
> $BJ]:d$5$s!"(Bdoc-jp $B$NNkLZ$G$9!#(B
>
> $B::FI$*Hh$l$5$^$G$9!#(B
>
> $B<!$N(B Porter's handbook $B$N::FIJ,(B (1.183 -> 1.195) $B$G$9!#(B
>  book_en.sgml.diff : $B1QJ8$N:9J,(B
>  book_jp.sgml.diff : $BK]LuJ8$N:9J,(B
> ($B1QJ8$NCf?H$O(B 1.184 -> 1.195 $B$N(B diff $B$G$9$,!"$=$3$O5$$K$7$J$$$G$/$@$5$$!#(B)
>
> $BA02s$HF1$8$h$&$KN><T$r8+Hf$Y$F!"LdBj$J$$$+$I$&$+$r3NG'$7$F$/$@$5$$!#(B
>
> $B$h$m$7$/$*4j$$$7$^$9!#(B
>
>
> Index: book.sgml
> ===================================================================
> RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
> retrieving revision 1.184
> retrieving revision 1.195
> diff -u -u -d -r1.184 -r1.195
> --- book.sgml   25 Nov 2001 01:03:01 -0000      1.184
> +++ book.sgml   28 Feb 2002 23:24:58 -0000      1.195
> @@ -1,7 +1,7 @@
>  <!--
>      The FreeBSD Documentation Project
>
> -     $FreeBSD: doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v 1.184 2001/11/25 01:03:01 dd Exp $
> +     $FreeBSD: doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v 1.195 2002/02/28 23:24:58 tom Exp $
>  -->
>
>  <!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
> @@ -29,6 +29,8 @@
>
>     <copyright>
>       <year>2000</year>
> +      <year>2001</year>
> +      <year>2002</year>
>       <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation
>        Project</holder>
>     </copyright>
> @@ -349,7 +351,14 @@
>             large amount of pirated software showing up there.</para>
>         </note>
>
> -        <para>We will look at your port, get back to you if necessary, and put
> +       <para>After you have submitted your port, please be patient.
> +         Sometimes it can take a few months before a port is included
> +         in FreeBSD, although it might only take a few days.  You can
> +         view the list of <ulink
> +         url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports">ports
> +         waiting to be committed to FreeBSD</ulink>.</para>
> +
> +        <para>Once we have looked at your port, we will get back to you if necessary, and put
>           it in the tree.  Your name will also appear in the list of
>           <quote>Additional FreeBSD contributors</quote> in the FreeBSD
>           Handbook and other files. Isn't that great?!? <!-- smiley
> @@ -1593,7 +1602,7 @@
>        @${FALSE}
>  .endif</programlisting>
>
> -      <para><filename>japanese/xdvi300</filename> also has all the regular
> +      <para><filename role="package">japanese/xdvi300</filename> also has all the regular
>         patches, package files, etc.  If you type <command>make</command>
>         there, it will take the default value for the resolution (300) and
>         build the port normally.</para>
> @@ -1604,7 +1613,7 @@
>       <programlisting>RESOLUTION=     118
>  MASTERDIR=      ${.CURDIR}/../xdvi300
>
> -.include ${MASTERDIR}/Makefile</programlisting>
> +.include "${MASTERDIR}/Makefile"</programlisting>
>
>       <para>(<filename>xdvi240/Makefile</filename> and
>         <filename>xdvi400/Makefile</filename> are similar).  The
> @@ -1736,7 +1745,7 @@
>       <para>There are many programs that require a Motif library (available
>         from several commercial vendors, while there is a free clone reported
>         to be able to run many applications in
> -        <filename>x11-toolkits/lesstif</filename>) to compile.  Since it is a
> +        <filename role="package">x11-toolkits/lesstif</filename>) to compile.  Since it is a
>         popular toolkit and their licenses usually permit redistribution of
>         statically linked binaries, we have made special provisions for
>         handling ports that require Motif in a way that we can easily compile
> @@ -1832,7 +1841,7 @@
>
>       <para>Here's a seven-step procedure to convert ports to use
>         <command>install-info</command>.
> -        <filename>editors/emacs</filename> will be used as an
> +        <filename role="package">editors/emacs</filename> will be used as an
>         example.</para>
>
>       <procedure>
> @@ -1884,7 +1893,7 @@
>             to use the extra arguments to <command>install-info</command>
>             because <command>makeinfo</command> cannot handle those texinfo
>             sources.  (See <filename>Makefile</filename> and
> -            <filename>pkg-plist</filename> of <filename>japanese/skk</filename>
> +            <filename>pkg-plist</filename> of <filename role="package">japanese/skk</filename>
>             for examples on how to do this).</para>
>         </step>
>
> @@ -2968,6 +2977,12 @@
>                    <entry>440002</entry>
>                  </row>
>
> +                 <row>
> +                   <entry>4.4-STABLE after the userland components of smbfs
> +                     were imported.</entry>
> +                   <entry>440003</entry>
> +                 </row>
> +
>
>                  <row>
>                    <entry>5.0-CURRENT</entry>
> @@ -3129,6 +3144,31 @@
>                      was added.</entry>
>                    <entry>500027</entry>
>                  </row>
> +
> +                 <row>
> +                   <entry>5.0-CURRENT after the userland components of smbfs
> +                     were imported.</entry>
> +                   <entry>500028</entry>
> +                 </row>
> +
> +                 <row>
> +                   <entry>5.0-CURRENT after the new C99 specific-width
> +                     integer types were added.</entry>
> +                   <entry>(Not incremented.)</entry>
> +                 </row>
> +
> +                 <row>
> +                   <entry>5.0-CURRENT after a change was made in the return
> +                     value of sendfile(2).</entry>
> +                   <entry>500029</entry>
> +                 </row>
> +
> +                 <row>
> +                   <entry>5.0-CURRENT after the introduction of the
> +                     type <literal>fflags_t</literal>, which is the
> +                     appropriate size for file flags.</entry>
> +                   <entry>500030</entry>
> +                 </row>
>                 </tbody>
>               </tgroup>
>             </informaltable>
> @@ -3520,12 +3560,12 @@
>         <para>If your port requires a certain user to be on the installed
>           system, let the <filename>pkg-install</filename> script call
>           <command>pw</command> to create it automatically.  Look at
> -          <filename>net/cvsup-mirror</filename> for an example.</para>
> +          <filename role="package">net/cvsup-mirror</filename> for an example.</para>
>
>         <para>If your port must use the same user/group ID number when it is
>           installed as a binary package as when it was compiled, then you must
>           choose a free UID from 50 to 999 and register it below.  Look at
> -          <filename>japanese/Wnn</filename> for an example.</para>
> +          <filename role="package">japanese/Wnn</filename> for an example.</para>
>
>         <para>Make sure you do not use a UID already used by the system or
>           other ports.  This is the current list of UIDs between 50 and
> @@ -3553,6 +3593,7 @@
>  mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin
>  vpopmail:*:89:89::0:0:User &:/usr/local/vpopmail:/nonexistent
>  smmsp:*:90:90:Sendmail Queue:/nonexistent:/nonexistent
> +mailman:*:91:91:Mailman User:/usr/local/mailman:/sbin/nologin
>  drweb:*:426:426:Dr.Web Mail Scanner:/nonexistent:/sbin/nologin</programlisting>
>
>         <para>Please include a notice when you submit a port (or an upgrade)
> @@ -3786,18 +3827,18 @@
>
>       <para>Store the directory structure in a new file.</para>
>
> -      <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>
> +      <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) &gt; OLD-DIRS</userinput></screen>
>
>       <para>If your port honors <makevar>PREFIX</makevar> (which it should)
>         you can then install the port and create the package list.</para>
>
>       <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
> -&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * \! -type d) &gt; pkg-plist</userinput></screen>
> +&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * \! -type d) &gt; pkg-plist</userinput></screen>
>
>       <para>You must also add any newly created directories to the packing
>         list.</para>
>
> -      <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</replaceable></userinput></screen>
> +      <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find -d * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</replaceable></userinput></screen>
>
>       <para>Finally, you need to tidy up the packing list by hand; it isn't
>         <emphasis>all</emphasis> automated.  Manual pages should be listed in
> @@ -4556,6 +4597,12 @@
>         changes by looking at <ulink
>           url="http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/Mk/bsd.port.mk"> the
>           bsd.port.mk CVS log</ulink>.</para>
> +
> +      <para>Other resources to assist port maintainers include a list of
> +       <ulink url="http://bento.FreeBSD.org/">package building logs and
> +       errors </ulink> and the <ulink
> +         url="http://people.FreeBSD.org/~fenner/portsurvey/">FreeBSD
> +         Ports distfiles survey</ulink>.</para>
>     </chapter>
>
>     <chapter>
>
>
