diff options
Diffstat (limited to 'zh_TW.Big5/books/porters-handbook/book.sgml')
| -rw-r--r-- | zh_TW.Big5/books/porters-handbook/book.sgml | 64 |
1 files changed, 32 insertions, 32 deletions
diff --git a/zh_TW.Big5/books/porters-handbook/book.sgml b/zh_TW.Big5/books/porters-handbook/book.sgml index 7d793c6bcf..6009acd55f 100644 --- a/zh_TW.Big5/books/porters-handbook/book.sgml +++ b/zh_TW.Big5/books/porters-handbook/book.sgml @@ -51,7 +51,7 @@ 請務必感恩在心。</para> <para>在 FreeBSD 上面，每個人都可以提交新的 port， - 或假如該 port 並沒有人維護的話，可以自願維護 — + 或假如該 port 並沒有人維護的話，可以自願維護 — 這點並不需要任何 commit 的權限，就可以來做這件事情。</para> </chapter> @@ -126,7 +126,7 @@ USE_IMAKE= yes .include <bsd.port.mk></programlisting> - <para>嗯，大致就是這樣，看看你已經領略多少了呢？ + <para>嗯，大致就是這樣，看看你已經領略多少了呢？ 看到 <literal>$FreeBSD$</literal> 這一行的話，別想太多 ，它是 RCS ID 用途，當該 port 正式進入 port tree 時， CVS 就會自動轉換為相關字串囉。 有關這點的細節部份，可以參閱 <link @@ -177,7 +177,7 @@ WWW: http://www.oneko.org/</programlisting> (打包清單)』。 以 <literal>${PREFIX}</literal> 為基準點， 而用相對路徑表示。(<literal>${PREFIX}</literal> 通常是 <filename>/usr/local</filename> 或 <filename>/usr/X11R6</filename>) - 但是如果該程式有安裝 man page 的話，則要以類似 + 但是如果該程式有安裝 man page 的話，則要以類似 <makevar>MAN<replaceable>n</replaceable>=</makevar> 的方式寫在 <filename>Makefile</filename> 內，不能列在 <filename>pkg-plist</filename> 哦。 @@ -361,7 +361,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> 錯誤報告和意見發表</ulink>)</para> <para>記得在填寫 PR 時『分類(Category)』選 <literal>ports</literal>， - 還有『種類(Class)』填 <literal>change-request</literal> + 還有『種類(Class)』填 <literal>change-request</literal> (千萬別傻傻地把該 PR 的『Confidential(機密)』設為 yes！)， 此外在『描述(<quote>Description</quote>)』 那邊寫上該程式的簡潔說明，而 shar 檔則附在『修正(<quote>Fix</quote>) @@ -411,7 +411,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> 你可以另開一窗來看 <filename>bsd.port.mk</filename> 內容，以便瞭解我們下面在講什麼。</para> - <para>但別太擔心是否完全看懂 + <para>但別太擔心是否完全看懂 <filename>bsd.port.mk</filename> 在做啥，很多人都還沒完全看完... <!-- smiley --><emphasis>:-></emphasis></para> @@ -465,7 +465,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> </listitem> <listitem> - <para>若有設 <makevar>USE_IMAKE</makevar> 的話，那麼就會跑 + <para>若有設 <makevar>USE_IMAKE</makevar> 的話，那麼就會跑 <makevar>XMKMF</makevar> (預設是 <command>xmkmf -a</command>) 。</para> </listitem> @@ -473,7 +473,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> </step> <step> - <para>最後是 <maketarget>build</maketarget> 階段，它會在該 + <para>最後是 <maketarget>build</maketarget> 階段，它會在該 port 的 working directory(由 <makevar>WRKSRC</makevar> 所設定) 內開始編譯。 若有設 <makevar>USE_GMAKE</makevar> 的話， 那麼就會改用 GNU <command>make</command> 來編譯， @@ -482,7 +482,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> </procedure> <para>上面講的都是打 <command>make</command> 時的預設階段。 - 此外，還可以設定各階段之前、之後要作的事情：透過定義 + 此外，還可以設定各階段之前、之後要作的事情：透過定義 <maketarget>pre-<replaceable>something</replaceable></maketarget> 或 <maketarget>post-<replaceable>something</replaceable></maketarget>， 或者把這些檔名的 script 丟到 <filename>scripts</filename> 子目錄去， @@ -499,12 +499,12 @@ PLIST_DIRS= lib/X11/oneko</programlisting> 因為這樣會比較方便加上這些原本沒有的階段，同時也方便他人協助除錯 。</para> - <para>預設的各階段動作都是照 <filename>bsd.port.mk</filename> 內的 + <para>預設的各階段動作都是照 <filename>bsd.port.mk</filename> 內的 <maketarget>do-<replaceable>something</replaceable></maketarget> 之類所定義的。 舉例：<maketarget>do-extract</maketarget> 就是定義怎麼把檔案解壓縮的。 若對預設方式覺得不妥的話，都可以在該 port 的 - <filename>Makefile</filename> 重新定義。</para> + <filename>Makefile</filename> 重新定義。</para> <note> <para>The <quote>main</quote> targets (e.g., @@ -518,14 +518,14 @@ PLIST_DIRS= lib/X11/oneko</programlisting> </note> <para>現在，你已經知道打 <command>make</command> 到底會作些什麼事囉， - 接下來會教你如何作更完美的 port。</para> + 接下來會教你如何作更完美的 port。</para> </sect1> <sect1 id="slow-sources"> <title>取得原始的 source 檔</title> <para>取得原始的 source 檔(通常檔名是 - <filename><replaceable>foo</replaceable>.tar.gz</filename> + <filename><replaceable>foo</replaceable>.tar.gz</filename> 或 <filename><replaceable>foo</replaceable>.tar.Z</filename> 之類的壓縮檔)，然後會把抓下來的檔案放在 <makevar>DISTDIR</makevar> 內。 記得：抓的時候，儘量使用『該軟體主要的正式網站』上面的來源檔 @@ -552,7 +552,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> 以便把檔案放到他的目錄內。 那位 committer 同時也會把 <makevar>MASTER_SITES</makevar> 設為 <makevar>MASTER_SITE_LOCAL</makevar>，並且把 - <makevar>MASTER_SITE_SUBDIR</makevar> 設為他自己的 + <makevar>MASTER_SITE_SUBDIR</makevar> 設為他自己的 <hostid>freefall</hostid> 帳號名稱。</para> <para>若該 port 的原始檔打包會經常重包，但原作者卻沒更新版號的話， @@ -561,7 +561,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> 或者請與原作者聯繫：請他不要這樣做(不斷重包同樣的檔案)；如此一來， 才有助於建立一定程度的 source code 版本控制。 把檔案另外複製一份放到自屬網頁空間的話，不但可有效防止使用者會發生 - <errorname>checksum mismatch(檔案經檢查有問題)</errorname> + <errorname>checksum mismatch(檔案經檢查有問題)</errorname> 的錯誤訊息，也可降低我們 FTP 站維護者的工作量。此外，若該 port 的檔案僅有一個主要網址， 那麼建議：請在自屬網站上放上備份檔，並修改 @@ -578,7 +578,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting> <title>量身打造 port</title> <para>解開壓縮檔，然後開始逐一修改，使該 port 在目前所用的 FreeBSD - 版本上得以順利編譯。 + 版本上得以順利編譯。 所做的每個動作請都 <emphasis>仔細記錄</emphasis>， 如此一來才能迅速自動套用這些修改。 在完成 port 之後，每項動作包括：對於檔案的刪除、增加、修改， @@ -4076,7 +4076,7 @@ PORTVERSION= 1.0</programlisting> ${MKDIR} ${EXAMPLESDIR} (cd ${WRKSRC}/examples/ && \ ${COPYTREE_SHARE} \* ${EXAMPLESDIR} "! -name Makefile")</programlisting> - + <para>Note that these macros does not add the installed files to <filename>pkg-plist</filename>. You still need to list them.</para> </sect2> @@ -5038,7 +5038,7 @@ PLIST_SUB+= NLS="@comment " xineramaproto xkbfile xkbui xmu xmuu xorg-server xp xpm xprintapputil xprintutil xpr oto xproxymngproto xrandr xrender xres xscrnsaver xt xtrans xtrap xtst xv xvmc xxf86dga xxf86misc xxf86vm</literal>.</para> - + <para>Always up-to-date list can be found in <filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para> @@ -5048,7 +5048,7 @@ PLIST_SUB+= NLS="@comment " Valid options are: <literal>glut, glu, glw, gl</literal> and <literal>linux</literal>. For backwards compatibility, the value of <literal>yes</literal> maps to <literal>glu</literal>.</para> - + <example id="use-xorg-example"> <title>USE_XORG example</title> <programlisting>USE_XORG= xrender xft xkbfile xt xaw @@ -5290,7 +5290,7 @@ USE_XORG= yes</programlisting> url="http://standards.freedesktop.org/desktop-entry-spec/latest/"> Freedesktop standard</ulink>)。 這些項目會在相應的桌面環境如 GNOME 或 KDE 的應用程式選單中出現。 <filename>.desktop</filename> 檔案 - 將會被建立、安裝以及自動加入 <filename>pkg-plist</filename> + 將會被建立、安裝以及自動加入 <filename>pkg-plist</filename> 中。語法為：</para> <programlisting>DESKTOP_ENTRIES= "NAME" "COMMENT" "ICON" "COMMAND" "CATEGORY" StartupNotify</programlisting> @@ -5672,7 +5672,7 @@ do-configure: it cannot work. <command>qmake</command> generates standard Makefiles, so it is not necessary to write our own <maketarget>build</maketarget> target.</para> - + <para>Qt applications often are written to be cross-platform and often X11/Unix isn't the platform they are developed on, which in turn often leads to certain loose ends, like:</para> @@ -6215,7 +6215,7 @@ do-configure: <row> <entry><makevar>AP_FAST_BUILD</makevar></entry> - <entry>使用 <command>apxs</command> + <entry>使用 <command>apxs</command> 來編譯及安裝這個模組。</entry> </row> @@ -6261,14 +6261,14 @@ do-configure: <makevar>PREFIX</makevar> is available in <filename>Makefile</filename> as <makevar>WWWDIR_REL</makevar>.</para> - + <para>The user and group of web server process are available as <makevar>WWWOWN</makevar> and <makevar>WWWGRP</makevar>, in case you need to change the ownership of some files. The default values of both are <literal>www</literal>. If you want different values for your port, use <literal>WWWOWN?= myuser</literal> notation, to allow user to override it easily.</para> - + <para>請別過於相依 Apache，除非這些程式有明確需要，而得相依 Apache 。也許有些使用者，會想在其他非 Apache 的 Web 伺服器上執行這些網頁程式。</para> @@ -8756,8 +8756,8 @@ as .putsy.conf and edit it.</programlisting> program is part of the Ports Collection.</para> <para><command>port</command> is the front-end script, - which can help you simplify the testing job. Whenever you want - to test a new port or update an existing one, you can use + which can help you simplify the testing job. Whenever you want + to test a new port or update an existing one, you can use <command>port test</command> to test your port, including the <link linkend="testing-portlint"><command>portlint</command></link> checking. This command also detects and lists any files that @@ -8836,7 +8836,7 @@ as .putsy.conf and edit it.</programlisting> have a better chance of working if the system administrator has moved the whole <filename>/usr/local</filename> tree somewhere else.</para> </sect1> - + <sect1 id="testing-tinderbox"> <title>Tinderbox</title> @@ -12024,13 +12024,13 @@ Reference: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 <entry>8.0-CURRENT after adding l_sysid to struct flock. </entry> <entry>800028</entry> - </row> + </row> <row> <entry>8.0-CURRENT after reintegration of the <function>BUF_LOCKWAITERS</function> function and the addition of &man.lockmgr.waiters.9;.</entry> <entry>800029</entry> - </row> + </row> <row> <entry>8.0-CURRENT after the introduction of the &man.rw.try.rlock.9; and &man.rw.try.wlock.9; functions. @@ -12105,7 +12105,7 @@ Reference: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 <entry>800043</entry> </row> <row> - <entry>8.0-CURRENT after the commit of the first step of + <entry>8.0-CURRENT after the commit of the first step of the vimage project renaming global variables to be virtualized with a V_ prefix with macros to map them back to their global names.</entry> @@ -12281,13 +12281,13 @@ post-install: <title>在 wrapper scripts 中使用 <function>exec</function> 述句</title> <para>若某 port 為了執行其他程式而安裝了一個 shell script， - 而該程式同時也是該 script 最後一個動作，那麼需要確定該 script + 而該程式同時也是該 script 最後一個動作，那麼需要確定該 script 是用 <function>exec</function> 述句（statement），舉例而言：</para> <programlisting>#!/bin/sh exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting> - <para><function>exec</function> 述句以所指定的程式取代了該 shell + <para><function>exec</function> 述句以所指定的程式取代了該 shell 的程序。 若省略 <function>exec</function> ，那麼該 shell 程序 將會在程式執行中一直存在於記憶體，這無疑地浪費了系統資源。</para> @@ -12729,7 +12729,7 @@ IGNORE=POINTYHAT is not supported <title><filename>sysctl</filename> 使用時機</title> <para><filename>sysctl</filename> 除了在 targets 之外，都不鼓勵使用。 - 這是因為任何 <literal>makevar</literal> + 這是因為任何 <literal>makevar</literal> 的評估都有可能會使得程序執行速度變慢。例如在 <command>make index</command> 的過程中就會需要用到 <filename>sysctl</filename>。</para> |