|
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Åé¥Dnªº¥¿¦¡ºô¯¸¡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¨Çºô§}¥un¤@¦³§ïÅܪº¸Ü¡A¨º»ò´N·|¦¨¬°ºûÅ@ port ªº¹ÚÆL¡C</para> |
| 466 |
sites—and the associated definitions—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¦¹¥~¡AY¸Ó port ªºÀɮ׶Ȧ³¤@Ó¥Dnºô§}¡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> |