From owner-freebsd-doc@FreeBSD.ORG Thu Jul 20 05:10:17 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 812C816A4E5 for ; Thu, 20 Jul 2006 05:10:17 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B398043D4C for ; Thu, 20 Jul 2006 05:10:16 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k6K5AGrC054240 for ; Thu, 20 Jul 2006 05:10:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k6K5AGZQ054239; Thu, 20 Jul 2006 05:10:16 GMT (envelope-from gnats) Resent-Date: Thu, 20 Jul 2006 05:10:16 GMT Resent-Message-Id: <200607200510.k6K5AGZQ054239@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, chinsan Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3417816A4DA; Thu, 20 Jul 2006 05:06:31 +0000 (UTC) (envelope-from chinsan.tw@gmail.com) Received: from smtp2.bc.hgc.com.tw (smtp2.bc.hgc.com.tw [203.133.1.156]) by mx1.FreeBSD.org (Postfix) with ESMTP id BC9ED43D45; Thu, 20 Jul 2006 05:06:30 +0000 (GMT) (envelope-from chinsan.tw@gmail.com) Received: from smtp2.bc.hgc.com.tw (u14-109.u203-187.giga.net.tw [203.187.14.109]) by smtp2.bc.hgc.com.tw (Postfix) with SMTP id 6D42D2E970; Thu, 20 Jul 2006 13:06:30 +0800 (CST) Received: by smtp2.bc.hgc.com.tw (sSMTP sendmail emulation); Thu, 20 Jul 2006 13:11:08 +0800 Message-Id: <20060720050630.6D42D2E970@smtp2.bc.hgc.com.tw> Date: Thu, 20 Jul 2006 13:11:08 +0800 From: chinsan To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: vanilla@FreeBSD.org Subject: docs/100590: [UPDATE] zh_TW: Update porters-handbook to SVN#836 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: chinsan List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 20 Jul 2006 05:10:17 -0000 >Number: 100590 >Category: docs >Synopsis: [UPDATE] zh_TW: Update porters-handbook to SVN#836 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Thu Jul 20 05:10:15 GMT 2006 >Closed-Date: >Last-Modified: >Originator: chinsan >Release: FreeBSD 6.1-STABLE i386 >Organization: FreeBSD Taiwan >Environment: System: FreeBSD chinsan2.twbbs.org 6.1-STABLE FreeBSD 6.1-STABLE #1: Fri Jun 2 16:44:35 CST 2006 root@chinsan2.twbbs.org:/usr/obj/usr/src/sys/GENERIC i386 >Description: - Update porters-handbook to SVN#836 ( patch URL http://chinsan2.twbbs.org/chinsan/zh_TW.Big5.20060720.porter.diff ) >How-To-Repeat: >Fix: --- zh_TW.Big5.20060720.porter.diff begins here --- diff -ruN zh_TW.Big5/books/porters-handbook.orig/book.sgml zh_TW.Big5/books/porters-handbook/book.sgml --- zh_TW.Big5/books/porters-handbook.orig/book.sgml Thu Jul 20 13:04:53 2006 +++ zh_TW.Big5/books/porters-handbook/book.sgml Thu Jul 20 13:06:12 2006 @@ -3,7 +3,7 @@ $FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.9 2006/07/10 07:26:14 vanilla Exp $ Original Revision: 1.675 - Chased Revision: 1.729 + Chased Revision: 1.733 --> 取得原始的 source 檔(通常檔名是 foo.tar.gz 或 foo.tar.Z 之類的壓縮檔)， 然後會把抓下來的檔案放在 DISTDIR 內。 - 記得：抓的時候，儘量使用『主流站』上面的來源檔，以確保檔案有效、可信。 + 記得：抓的時候，儘量使用『該軟體主要的正式網站』上面的來源檔，以確保檔案有效、可信。 - You will need to set the variable MASTER_SITES - to reflect where the original tarball resides. You will find - convenient shorthand definitions for most mainstream sites - in bsd.sites.mk. Please use these - sites—and the associated definitions—if - at all possible, to help avoid the problem of having the same - information repeated over again many times in the source base. - As these sites tend to change over time, this becomes a - maintenance nightmare for everyone involved. - - If you cannot find a FTP/HTTP site that is well-connected to the - net, or can only find sites that have irritatingly non-standard - formats, you might want to put a copy on a reliable FTP or HTTP - server that you control (e.g., your home page). - - If you cannot find somewhere convenient and reliable to put the - distfile - we can house it ourselves - on ftp.FreeBSD.org; however, this is the - least-preferred solution. - The distfile must be placed into - ~/public_distfiles/ of someone's - freefall account. - Ask the person who commits your port to do this. - This person will also set MASTER_SITES to - MASTER_SITE_LOCAL and - MASTER_SITE_SUBDIR to their - freefall username. - - If your port's distfile changes all the time without any - kind of version update by the author, - consider putting the distfile on your home page and listing it as - the first MASTER_SITES. If you can, try - to talk the port author out of doing this; it - really does help to establish some kind of source code control. - Hosting your own version will prevent users - from getting checksum mismatch errors, and - also reduce the workload of maintainers of our FTP site. Also, if - there is only one master site for the port, it is recommended that - you house a backup at your site and list it as the second - MASTER_SITES. - - If your port requires some additional `patches' that are - available on the Internet, fetch them too and put them in - DISTDIR. Do not worry if they come from a site - other than where you got the main source tarball, we have a way to - handle these situations (see the description of PATCHFILES below). + 需要設 MASTER_SITES 以指定原始檔案是放在何處。相關網址在 + bsd.sites.mk 內有一些方便的速記表可以使用。 請盡可能多用對應這些網址的變數， + 以避免同樣的一堆網址有重複很多次出現在 port tree 內。 + 否則，這些網址只要一有改變的話，那麼就會成為維護 port 的夢魘。 + + 如果該檔並沒有放在公開的 FTP 站或網站(HTTP)上，或者該檔並非一般標準格式的話， + 那麼可以考慮複製該檔，然後放到你可掌握、可信任的 FTP 站或網站(HTTP)上，比如：你自己的網頁空間。 + + 若找不到地方(方便、可信任)來放檔案的話， + 那麼可以 house(暫放) 在 ftp.FreeBSD.org 上的 committer 自屬空間內； + 然而，這是最不理想的解法。 + 檔案要放到該 committer 的 freefall 上的 ~/public_distfiles/ 目錄內才可以。 + 請與協助 commit 你的 port 的那位 committer 聯繫，以便把檔案放到他的目錄內。 + 那位 committer 同時也會把 MASTER_SITES 設為 + MASTER_SITE_LOCAL，並且把 + MASTER_SITE_SUBDIR 設為他自己的 + freefall 帳號名稱。 + + 若該 port 的原始檔打包會經常重包，但原作者卻沒更新版號的話， + 請考慮把該檔改放到自己的網頁空間，並且把自己網頁空間列為 MASTER_SITES 的第一順位。 + 或者請與原作者聯繫：請他不要這樣做(不斷重包同樣的檔案)；如此一來，才有助於建立一定程度的 source code 版本控制。 + 把檔案另外複製一份放到自屬網頁空間的話，不但可有效防止使用者會發生 checksum mismatch(檔案經檢查有問題) + 的錯誤訊息，也可降低我們 FTP 站維護者的工作量。此外，若該 port 的檔案僅有一個主要網址， + 那麼建議：請在自屬網站上放上備份檔，並修改 MASTER_SITES 把你的網址列為第二順位。 + + 若該 port 需要一些額外 `patches'(可透過 Internet 下載)，並放在 + DISTDIR 內，不必擔心這些 patch 檔是否得都跟原始檔一樣來自同一網站， + 這些情況有另外的解法(請看下面的 PATCHFILES 介紹部分)。 @@ -9024,6 +9005,33 @@ 600104 + 6.0-STABLE after NLS catalog support of + csh(1). + 600105 + + + 6.1-RELEASE + 601000 + + + 6.1-STABLE after 6.1-RELEASE. + 601100 + + + 6.1-STABLE after the import of csup. + 601101 + + + 6.1-STABLE after the iwi(4) update. + 601102 + + + 6.1-STABLE after the resolver update to + BIND9, and exposure of reentrant version of + netdb functions. + 601103 + + 7.0-CURRENT. 700000 @@ -9099,6 +9107,24 @@ 7-0.CURRENT after pts import. 700014 + + 7.0-CURRENT after the introduction of version 2 + of &man.hwpmc.4;'s ABI. + 700015 + + + 7.0-CURRENT after addition of &man.fcloseall.3; + to libc. + 700016 + + + 7.0-CURRENT after removal of ip6fw. + 700017 + + + 7.0-CURRENT after import of snd_emu10kx. + 700018 + @@ -9726,10 +9752,15 @@ BROKEN is reserved for ports that currently do not compile, install, or deinstall correctly. It should be used for ports where the the problem is - believed to be temporary. - The build cluster will still attempt to try to build + believed to be temporary. + + If instructed, the build cluster will still attempt to + try to build them to see if the underlying problem has been - resolved. For instance, use + resolved. (However, in general, the cluster is run without + this.) + + For instance, use BROKEN when a port: --- zh_TW.Big5.20060720.porter.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: