diff options
Diffstat (limited to 'zh_TW.Big5/books/developers-handbook/policies/chapter.xml')
| -rw-r--r-- | zh_TW.Big5/books/developers-handbook/policies/chapter.xml | 84 |
1 files changed, 31 insertions, 53 deletions
diff --git a/zh_TW.Big5/books/developers-handbook/policies/chapter.xml b/zh_TW.Big5/books/developers-handbook/policies/chapter.xml index 16d63c7663..a76c7ceb30 100644 --- a/zh_TW.Big5/books/developers-handbook/policies/chapter.xml +++ b/zh_TW.Big5/books/developers-handbook/policies/chapter.xml @@ -4,26 +4,21 @@ $FreeBSD$ --> - -<chapter id="policies"> - <chapterinfo> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="policies"> + <info><title>Source Tree Guidelines and Policies</title> <authorgroup> - <author> - <firstname>Poul-Henning</firstname> - <surname>Kamp</surname> - <contrib>Contributed by </contrib> - </author> + <author><personname><firstname>Poul-Henning</firstname><surname>Kamp</surname></personname><contrib>Contributed by </contrib></author> </authorgroup> - <!-- June 1996 --> - </chapterinfo> + + </info> - <title>Source Tree Guidelines and Policies</title> + <para>This chapter documents various guidelines and policies in force for the FreeBSD source tree.</para> - <sect1 id="policies-maintainer"> - <title><makevar>MAINTAINER</makevar> on Makefiles</title> + <sect1 xml:id="policies-maintainer"> + <title><varname>MAINTAINER</varname> on Makefiles</title> <indexterm><primary>ports maintainer</primary></indexterm> <para>If a particular portion of the FreeBSD distribution is being @@ -55,23 +50,16 @@ people.</para> </sect1> - <sect1 id="policies-contributed"> - <sect1info> + <sect1 xml:id="policies-contributed"> + <info><title>Contributed Software</title> <authorgroup> - <author> - <firstname>Poul-Henning</firstname> - <surname>Kamp</surname> - <contrib>Contributed by </contrib> - </author> - <author> - <firstname>David</firstname> - <surname>O'Brien</surname> - </author> + <author><personname><firstname>Poul-Henning</firstname><surname>Kamp</surname></personname><contrib>Contributed by </contrib></author> + <author><personname><firstname>David</firstname><surname>O'Brien</surname></personname></author> </authorgroup> - <!-- June 1996 --> - </sect1info> + + </info> - <title>Contributed Software</title> + <indexterm><primary>contributed software</primary></indexterm> @@ -141,7 +129,7 @@ the rules: it is supposed to contain the sources as distributed (on a proper CVS vendor-branch and without RCS keyword expansion) with as few FreeBSD-specific changes as possible. The 'easy-import' tool on - <hostid>freefall</hostid> will assist in doing the import, but if there are any doubts on + <systemitem>freefall</systemitem> will assist in doing the import, but if there are any doubts on how to go about it, it is imperative that you ask first and not blunder ahead and hope it <quote>works out</quote>. CVS is not forgiving of import accidents and a fair amount of effort is required to back out @@ -239,7 +227,7 @@ inclusion in the next vendor release. obrien@FreeBSD.org - 30 March 1997</programlisting> </sect1> - <sect1 id="policies-encumbered"> + <sect1 xml:id="policies-encumbered"> <title>Encumbered Files</title> <para>It might occasionally be necessary to include an encumbered file in @@ -269,7 +257,7 @@ obrien@FreeBSD.org - 30 March 1997</programlisting> <listitem> <para>Any encumbered file requires specific approval from the - <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> before it is added to the + <link xlink:href="&url.articles.contributors;/staff-core.html">Core team</link> before it is added to the CVS repository.</para> </listitem> @@ -286,7 +274,7 @@ obrien@FreeBSD.org - 30 March 1997</programlisting> <listitem> <para>Object files are named - <filename><replaceable>arch</replaceable>/<replaceable>filename</replaceable>.o.uu></filename>.</para> + <filename>arch/filename.o.uu></filename>.</para> </listitem> <listitem> @@ -300,9 +288,9 @@ obrien@FreeBSD.org - 30 March 1997</programlisting> <listitem> <para>Should always be in <filename>LINT</filename>, but the - <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> decides per case if it + <link xlink:href="&url.articles.contributors;/staff-core.html">Core team</link> decides per case if it should be commented out or not. The - <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> can, of course, change + <link xlink:href="&url.articles.contributors;/staff-core.html">Core team</link> can, of course, change their minds later on.</para> </listitem> @@ -319,13 +307,13 @@ obrien@FreeBSD.org - 30 March 1997</programlisting> <orderedlist> <listitem> <indexterm><primary>core team</primary></indexterm> - <para>The <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> decides if + <para>The <link xlink:href="&url.articles.contributors;/staff-core.html">Core team</link> decides if the code should be part of <command>make world</command>.</para> </listitem> <listitem> <indexterm><primary>release engineer</primary></indexterm> - <para>The <ulink url="&url.articles.contributors;/staff-who.html">Release Engineer</ulink> + <para>The <link xlink:href="&url.articles.contributors;/staff-who.html">Release Engineer</link> decides if it goes into the release.</para> </listitem> </orderedlist> @@ -333,27 +321,17 @@ obrien@FreeBSD.org - 30 March 1997</programlisting> </orderedlist> </sect1> - <sect1 id="policies-shlib"> - <sect1info> + <sect1 xml:id="policies-shlib"> + <info><title>Shared Libraries</title> <authorgroup> - <author> - <firstname>Satoshi</firstname> - <surname>Asami</surname> - <contrib>Contributed by </contrib> - </author> - <author> - <firstname>Peter</firstname> - <surname>Wemm</surname> - </author> - <author> - <firstname>David</firstname> - <surname>O'Brien</surname> - </author> + <author><personname><firstname>Satoshi</firstname><surname>Asami</surname></personname><contrib>Contributed by </contrib></author> + <author><personname><firstname>Peter</firstname><surname>Wemm</surname></personname></author> + <author><personname><firstname>David</firstname><surname>O'Brien</surname></personname></author> </authorgroup> - <!-- 9 Dec 1996 --> - </sect1info> + + </info> - <title>Shared Libraries</title> + <para>If you are adding shared library support to a port or other piece of software that does not have one, the version numbers should follow these |