View | Details | Raw Unified | Return to bug 100590
Collapse All | Expand All

(-)zh_TW.Big5/books/porters-handbook/book.sgml (-53 / +84 lines)
Lines 3-9 Link Here
3
3
4
     $FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.9 2006/07/10 07:26:14 vanilla Exp $
4
     $FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.9 2006/07/10 07:26:14 vanilla Exp $
5
     Original Revision: 1.675
5
     Original Revision: 1.675
6
     Chased Revision: 1.729
6
     Chased Revision: 1.733
7
-->
7
-->
8
8
9
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
9
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
Lines 457-512 Link Here
457
	<para>¨ú±o­ì©lªº source ÀÉ(³q±`ÀɦW¬O <filename><replaceable>foo</replaceable>.tar.gz</filename> 
457
	<para>¨ú±o­ì©lªº source ÀÉ(³q±`ÀɦW¬O <filename><replaceable>foo</replaceable>.tar.gz</filename> 
458
	  ©Î <filename><replaceable>foo</replaceable>.tar.Z</filename> ¤§ÃþªºÀ£ÁYÀÉ)¡A
458
	  ©Î <filename><replaceable>foo</replaceable>.tar.Z</filename> ¤§ÃþªºÀ£ÁYÀÉ)¡A
459
	  µM«á·|§â§ì¤U¨ÓªºÀɮשñ¦b <makevar>DISTDIR</makevar> ¤º¡C
459
	  µM«á·|§â§ì¤U¨ÓªºÀɮשñ¦b <makevar>DISTDIR</makevar> ¤º¡C
460
	  °O±o¡G§ìªº®É­Ô¡A¾¨¶q¨Ï¥Î¡y¥D¬y¯¸¡z¤W­±ªº¨Ó·½ÀÉ¡A¥H½T«OÀɮצ³®Ä¡B¥i«H¡C</para>
460
	  °O±o¡G§ìªº®É­Ô¡A¾¨¶q¨Ï¥Î¡y¸Ó³nÅé¥D­nªº¥¿¦¡ºô¯¸¡z¤W­±ªº¨Ó·½ÀÉ¡A¥H½T«OÀɮצ³®Ä¡B¥i«H¡C</para>
461
461
462
	<para>You will need to set the variable <makevar>MASTER_SITES</makevar>
462
	<para>»Ý­n³] <makevar>MASTER_SITES</makevar> ¥H«ü©w­ì©lÀɮ׬O©ñ¦b¦ó³B¡C¬ÛÃöºô§}¦b 
463
	  to reflect where the original tarball resides.  You will find
463
	  <filename>bsd.sites.mk</filename> ¤º¦³¤@¨Ç¤è«Kªº³t°Oªí¥i¥H¨Ï¥Î¡C  ½ÐºÉ¥i¯à¦h¥Î¹ïÀ³³o¨Çºô§}ªºÅܼơA
464
	  convenient shorthand definitions for most mainstream sites
464
	  ¥HÁ×§K¦P¼Ëªº¤@°ïºô§}¦³­«½Æ«Ü¦h¦¸¥X²{¦b port tree ¤º¡C
465
	  in <filename>bsd.sites.mk</filename>.  Please use these
465
	  §_«h¡A³o¨Çºô§}¥u­n¤@¦³§ïÅܪº¸Ü¡A¨º»ò´N·|¦¨¬°ºûÅ@ port ªº¹ÚÆL¡C</para>
466
	  sites&mdash;and the associated definitions&mdash;if
466
467
	  at all possible, to help avoid the problem of having the same
467
	<para>¦pªG¸ÓÀɨèS¦³©ñ¦b¤½¶}ªº FTP ¯¸©Îºô¯¸(HTTP)¤W¡A©ÎªÌ¸ÓÀɨëD¤@¯ë¼Ð·Ç®æ¦¡ªº¸Ü¡A
468
	  information repeated over again many times in the source base.
468
	  ¨º»ò¥i¥H¦Ò¼{½Æ»s¸ÓÀÉ¡AµM«á©ñ¨ì§A¥i´x´¤¡B¥i«H¥ôªº FTP ¯¸©Îºô¯¸(HTTP)¤W¡A¤ñ¦p¡G§A¦Û¤vªººô­¶ªÅ¶¡¡C</para>
469
	  As these sites tend to change over time, this becomes a
469
470
	  maintenance nightmare for everyone involved.</para>
470
	<para>­Y§ä¤£¨ì¦a¤è(¤è«K¡B¥i«H¥ô)¨Ó©ñÀɮתº¸Ü¡A
471
471
	  ¨º»ò¥i¥H <quote>house(¼È©ñ)</quote> ¦b <hostid>ftp.FreeBSD.org</hostid> ¤Wªº committer ¦ÛÄݪŶ¡¤º¡F
472
	<para>If you cannot find a FTP/HTTP site that is well-connected to the
472
	  µM¦Ó¡A³o¬O³Ì¤£²z·Qªº¸Ñªk¡C
473
	  net, or can only find sites that have irritatingly non-standard
473
	  ÀÉ®×­n©ñ¨ì¸Ó committer ªº <hostid>freefall</hostid> ¤Wªº <filename>~/public_distfiles/</filename> ¥Ø¿ý¤º¤~¥i¥H¡C
474
	  formats, you might want to put a copy on a reliable FTP or HTTP
474
	  ½Ð»P¨ó§U commit §Aªº port ªº¨º¦ì committer Ápô¡A¥H«K§âÀɮשñ¨ì¥Lªº¥Ø¿ý¤º¡C
475
	  server that you control (e.g., your home page).</para>
475
	  ¨º¦ì committer ¦P®É¤]·|§â <makevar>MASTER_SITES</makevar> ³]¬°
476
476
	  <makevar>MASTER_SITE_LOCAL</makevar>¡A¨Ã¥B§â
477
	<para>If you cannot find somewhere convenient and reliable to put the
477
	  <makevar>MASTER_SITE_SUBDIR</makevar> ³]¬°¥L¦Û¤vªº 
478
	  distfile
478
	  <hostid>freefall</hostid> ±b¸¹¦WºÙ¡C</para>
479
	  we can <quote>house</quote> it ourselves
479
480
	  on <hostid>ftp.FreeBSD.org</hostid>; however, this is the
480
	<para>­Y¸Ó port ªº­ì©lÀÉ¥´¥]·|¸g±`­«¥]¡A¦ý­ì§@ªÌ«o¨S§ó·sª©¸¹ªº¸Ü¡A
481
	  least-preferred solution.
481
	  ½Ð¦Ò¼{§â¸ÓÀɧï©ñ¨ì¦Û¤vªººô­¶ªÅ¶¡¡A¨Ã¥B§â¦Û¤vºô­¶ªÅ¶¡¦C¬° <makevar>MASTER_SITES</makevar> ªº²Ä¤@¶¶¦ì¡C
482
	  The distfile must be placed into
482
	  ©ÎªÌ½Ð»P­ì§@ªÌÁpô¡G½Ð¥L¤£­n³o¼Ë°µ(¤£Â_­«¥]¦P¼ËªºÀÉ®×)¡F¦p¦¹¤@¨Ó¡A¤~¦³§U©ó«Ø¥ß¤@©wµ{«×ªº source code ª©¥»±±¨î¡C
483
	  <filename>~/public_distfiles/</filename> of someone's
483
	  §âÀÉ®×¥t¥~½Æ»s¤@¥÷©ñ¨ì¦ÛÄݺô­¶ªÅ¶¡ªº¸Ü¡A¤£¦ý¥i¦³®Ä¨¾¤î¨Ï¥ÎªÌ·|µo¥Í <errorname>checksum mismatch(Àɮ׸gÀˬd¦³°ÝÃD)</errorname> 
484
	  <hostid>freefall</hostid> account.
484
	  ªº¿ù»~°T®§¡A¤]¥i­°§C§Ú­Ì FTP ¯¸ºûÅ@ªÌªº¤u§@¶q¡C¦¹¥~¡A­Y¸Ó port ªºÀɮ׶Ȧ³¤@­Ó¥D­nºô§}¡A
485
	  Ask the person who commits your port to do this.
485
	  ¨º»ò«ØÄ³¡G½Ð¦b¦ÛÄݺô¯¸¤W©ñ¤W³Æ¥÷ÀÉ¡A¨Ã­×§ï <makevar>MASTER_SITES</makevar> §â§Aªººô§}¦C¬°²Ä¤G¶¶¦ì¡C</para>
486
	  This person will also set <makevar>MASTER_SITES</makevar> to
486
487
	  <makevar>MASTER_SITE_LOCAL</makevar> and
487
	<para>­Y¸Ó port »Ý­n¤@¨ÇÃB¥~ `patches'(¥i³z¹L Internet ¤U¸ü)¡A¨Ã©ñ¦b
488
	  <makevar>MASTER_SITE_SUBDIR</makevar> to their
488
	  <makevar>DISTDIR</makevar> ¤º¡A¤£¥²¾á¤ß³o¨Ç patch ÀɬO§_±o³£¸ò­ì©lÀɤ@¼Ë¨Ó¦Û¦P¤@ºô¯¸¡A
489
	  <hostid>freefall</hostid> username.</para>
489
	  ³o¨Ç±¡ªp¦³¥t¥~ªº¸Ñªk(½Ð¬Ý¤U­±ªº <link
490
490
	    linkend="porting-patchfiles">PATCHFILES</link> ¤¶²Ð³¡¤À)¡C</para>
491
	<para>If your port's distfile changes all the time without any
492
	  kind of version update by the author,
493
	  consider putting the distfile on your home page and listing it as
494
	  the first <makevar>MASTER_SITES</makevar>.  If you can, try
495
	  to talk the port author out of doing this; it
496
	  really does help to establish some kind of source code control.
497
	  Hosting your own version will prevent users
498
	  from getting <errorname>checksum mismatch</errorname> errors, and
499
	  also reduce the workload of maintainers of our FTP site.  Also, if
500
	  there is only one master site for the port, it is recommended that
501
	  you house a backup at your site and list it as the second
502
	  <makevar>MASTER_SITES</makevar>.</para>
503
504
	<para>If your port requires some additional `patches' that are
505
	  available on the Internet, fetch them too and put them in
506
	  <makevar>DISTDIR</makevar>.  Do not worry if they come from a site
507
	  other than where you got the main source tarball, we have a way to
508
	  handle these situations (see the description of <link
509
	    linkend="porting-patchfiles">PATCHFILES</link> below).</para>
510
      </sect1>
491
      </sect1>
511
492
512
      <sect1 id="slow-modifying">
493
      <sect1 id="slow-modifying">
Lines 9024-9029 Link Here
9024
		    <entry>600104</entry>
9005
		    <entry>600104</entry>
9025
		  </row>
9006
		  </row>
9026
		  <row>
9007
		  <row>
9008
		    <entry>6.0-STABLE after NLS catalog support of
9009
		      csh(1).</entry>
9010
		    <entry>600105</entry>
9011
		  </row>
9012
		  <row>
9013
		    <entry>6.1-RELEASE</entry>
9014
		    <entry>601000</entry>
9015
		  </row>
9016
		  <row>
9017
		    <entry>6.1-STABLE after 6.1-RELEASE.</entry>
9018
		    <entry>601100</entry>
9019
		  </row>
9020
		  <row>
9021
		    <entry>6.1-STABLE after the import of csup.</entry>
9022
		    <entry>601101</entry>
9023
		  </row>
9024
		  <row>
9025
		    <entry>6.1-STABLE after the iwi(4) update.</entry>
9026
		    <entry>601102</entry>
9027
		  </row>
9028
		  <row>
9029
		    <entry>6.1-STABLE after the resolver update to
9030
		      BIND9, and exposure of reentrant version of
9031
		      netdb functions.</entry>
9032
		    <entry>601103</entry>
9033
		  </row>
9034
		  <row>
9027
		    <entry>7.0-CURRENT.</entry>
9035
		    <entry>7.0-CURRENT.</entry>
9028
		    <entry>700000</entry>
9036
		    <entry>700000</entry>
9029
		  </row>
9037
		  </row>
Lines 9099-9104 Link Here
9099
		    <entry>7-0.CURRENT after pts import.</entry>
9107
		    <entry>7-0.CURRENT after pts import.</entry>
9100
		    <entry>700014</entry>
9108
		    <entry>700014</entry>
9101
		  </row>
9109
		  </row>
9110
		  <row>
9111
		    <entry>7.0-CURRENT after the introduction of version 2
9112
		      of &man.hwpmc.4;'s ABI.</entry>
9113
		    <entry>700015</entry>
9114
		  </row>
9115
		  <row>
9116
		    <entry>7.0-CURRENT after addition of &man.fcloseall.3;
9117
		      to libc.</entry>
9118
		    <entry>700016</entry>
9119
		  </row>
9120
		  <row>
9121
		    <entry>7.0-CURRENT after removal of ip6fw.</entry>
9122
		    <entry>700017</entry>
9123
		  </row>
9124
		  <row>
9125
		    <entry>7.0-CURRENT after import of snd_emu10kx.</entry>
9126
		    <entry>700018</entry>
9127
		  </row>
9102
		</tbody>
9128
		</tbody>
9103
	      </tgroup>
9129
	      </tgroup>
9104
	    </table>
9130
	    </table>
Lines 9726-9735 Link Here
9726
	    <para><makevar>BROKEN</makevar> is reserved for ports that
9752
	    <para><makevar>BROKEN</makevar> is reserved for ports that
9727
	      currently do not compile, install, or deinstall correctly.
9753
	      currently do not compile, install, or deinstall correctly.
9728
	      It should be used for ports where the the problem is
9754
	      It should be used for ports where the the problem is
9729
	      believed to be temporary.
9755
	      believed to be temporary.</para>
9730
	      The build cluster will still attempt to try to build
9756
9757
	    <para>If instructed, the build cluster will still attempt to
9758
	      try to build
9731
	      them to see if the underlying problem has been
9759
	      them to see if the underlying problem has been
9732
	      resolved.  For instance, use
9760
	      resolved.  (However, in general, the cluster is run without
9761
	      this.)</para>
9762
	      
9763
	    <para>For instance, use
9733
	      <makevar>BROKEN</makevar> when a port:</para>
9764
	      <makevar>BROKEN</makevar> when a port:</para>
9734
9765
9735
	    <itemizedlist>
9766
	    <itemizedlist>

Return to bug 100590