Date: Thu, 14 Nov 2013 00:20:52 +0000 (UTC) From: Xin LI <delphij@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43188 - in head: . en_US.ISO8859-1/books/faq en_US.ISO8859-1/htdocs zh_CN.GB2312 zh_CN.UTF-8 zh_CN.UTF-8/articles zh_CN.UTF-8/articles/contributing zh_CN.UTF-8/articles/cvs-freebsd zh_... Message-ID: <201311140020.rAE0KqHZ062339@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: delphij Date: Thu Nov 14 00:20:51 2013 New Revision: 43188 URL: http://svnweb.freebsd.org/changeset/doc/43188 Log: Convert zh_CN from GB2312 to UTF-8. While I'm there, also fix a bunch of font issues when rendering PDF. Added: head/zh_CN.UTF-8/ - copied from r43186, head/zh_CN.GB2312/ Deleted: head/zh_CN.GB2312/ Modified: head/Makefile head/en_US.ISO8859-1/books/faq/book.xml head/en_US.ISO8859-1/htdocs/Makefile head/zh_CN.UTF-8/articles/Makefile.inc head/zh_CN.UTF-8/articles/contributing/article.xml head/zh_CN.UTF-8/articles/cvs-freebsd/article.xml head/zh_CN.UTF-8/articles/linux-users/article.xml head/zh_CN.UTF-8/articles/nanobsd/article.xml head/zh_CN.UTF-8/articles/rc-scripting/article.xml head/zh_CN.UTF-8/articles/remote-install/article.xml head/zh_CN.UTF-8/books/Makefile.inc head/zh_CN.UTF-8/books/arch-handbook/book.xml head/zh_CN.UTF-8/books/arch-handbook/boot/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/chapters.ent head/zh_CN.UTF-8/books/arch-handbook/driverbasics/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/isa/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/jail/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/kobj/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/locking/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/mac.ent head/zh_CN.UTF-8/books/arch-handbook/mac/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/newbus/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/pccard/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/pci/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/scsi/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/smp/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/sound/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/sysinit/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/usb/chapter.xml head/zh_CN.UTF-8/books/arch-handbook/vm/chapter.xml head/zh_CN.UTF-8/books/handbook/advanced-networking/chapter.xml head/zh_CN.UTF-8/books/handbook/audit/chapter.xml head/zh_CN.UTF-8/books/handbook/basics/chapter.xml head/zh_CN.UTF-8/books/handbook/bibliography/chapter.xml head/zh_CN.UTF-8/books/handbook/book.xml head/zh_CN.UTF-8/books/handbook/boot/chapter.xml head/zh_CN.UTF-8/books/handbook/bsdinstall/chapter.xml head/zh_CN.UTF-8/books/handbook/chapters.ent head/zh_CN.UTF-8/books/handbook/colophon.xml head/zh_CN.UTF-8/books/handbook/config/chapter.xml head/zh_CN.UTF-8/books/handbook/cutting-edge/chapter.xml head/zh_CN.UTF-8/books/handbook/desktop/chapter.xml head/zh_CN.UTF-8/books/handbook/disks/chapter.xml head/zh_CN.UTF-8/books/handbook/dtrace/chapter.xml head/zh_CN.UTF-8/books/handbook/eresources/chapter.xml head/zh_CN.UTF-8/books/handbook/filesystems/chapter.xml head/zh_CN.UTF-8/books/handbook/firewalls/chapter.xml head/zh_CN.UTF-8/books/handbook/geom/chapter.xml head/zh_CN.UTF-8/books/handbook/install/chapter.xml head/zh_CN.UTF-8/books/handbook/introduction/chapter.xml head/zh_CN.UTF-8/books/handbook/jails/chapter.xml head/zh_CN.UTF-8/books/handbook/kernelconfig/chapter.xml head/zh_CN.UTF-8/books/handbook/l10n/chapter.xml head/zh_CN.UTF-8/books/handbook/linuxemu/chapter.xml head/zh_CN.UTF-8/books/handbook/mac/chapter.xml head/zh_CN.UTF-8/books/handbook/mail/chapter.xml head/zh_CN.UTF-8/books/handbook/mirrors/chapter.xml head/zh_CN.UTF-8/books/handbook/multimedia/chapter.xml head/zh_CN.UTF-8/books/handbook/network-servers/chapter.xml head/zh_CN.UTF-8/books/handbook/pgpkeys/chapter.xml head/zh_CN.UTF-8/books/handbook/ports/chapter.xml head/zh_CN.UTF-8/books/handbook/ppp-and-slip/chapter.xml head/zh_CN.UTF-8/books/handbook/preface/preface.xml head/zh_CN.UTF-8/books/handbook/printing/chapter.xml head/zh_CN.UTF-8/books/handbook/security/chapter.xml head/zh_CN.UTF-8/books/handbook/serialcomms/chapter.xml head/zh_CN.UTF-8/books/handbook/txtfiles.ent head/zh_CN.UTF-8/books/handbook/users/chapter.xml head/zh_CN.UTF-8/books/handbook/vinum/chapter.xml head/zh_CN.UTF-8/books/handbook/virtualization/chapter.xml head/zh_CN.UTF-8/books/handbook/x11/chapter.xml head/zh_CN.UTF-8/books/porters-handbook/book.xml head/zh_CN.UTF-8/htdocs/Makefile head/zh_CN.UTF-8/htdocs/Makefile.inc head/zh_CN.UTF-8/htdocs/about.xml head/zh_CN.UTF-8/htdocs/advocacy/index.xml head/zh_CN.UTF-8/htdocs/advocacy/myths.xml head/zh_CN.UTF-8/htdocs/applications.xml head/zh_CN.UTF-8/htdocs/art.xml head/zh_CN.UTF-8/htdocs/availability.xml head/zh_CN.UTF-8/htdocs/community.xml head/zh_CN.UTF-8/htdocs/copyright/copyright.xml head/zh_CN.UTF-8/htdocs/copyright/daemon.xml head/zh_CN.UTF-8/htdocs/copyright/freebsd-doc-license.xml head/zh_CN.UTF-8/htdocs/copyright/freebsd-license.xml head/zh_CN.UTF-8/htdocs/copyright/license.xml head/zh_CN.UTF-8/htdocs/copyright/trademarks.xml head/zh_CN.UTF-8/htdocs/developers.xml head/zh_CN.UTF-8/htdocs/docs.xml head/zh_CN.UTF-8/htdocs/features.xml head/zh_CN.UTF-8/htdocs/index.xsl head/zh_CN.UTF-8/htdocs/internet.xml head/zh_CN.UTF-8/htdocs/logo.xml head/zh_CN.UTF-8/htdocs/mailto.xml head/zh_CN.UTF-8/htdocs/news/news.xml head/zh_CN.UTF-8/htdocs/news/pressreleases.xml head/zh_CN.UTF-8/htdocs/platforms/alpha.xml head/zh_CN.UTF-8/htdocs/platforms/amd64.xml head/zh_CN.UTF-8/htdocs/platforms/amd64/motherboards.xml head/zh_CN.UTF-8/htdocs/platforms/arm.xml head/zh_CN.UTF-8/htdocs/platforms/i386.xml head/zh_CN.UTF-8/htdocs/platforms/index.xml head/zh_CN.UTF-8/htdocs/releases/5.4R/errata.html head/zh_CN.UTF-8/htdocs/releases/5.4R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/5.4R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-ia64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/installation.xml head/zh_CN.UTF-8/htdocs/releases/5.4R/migration-guide.html head/zh_CN.UTF-8/htdocs/releases/5.4R/readme.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-ia64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/5.4R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/5.5R/errata.html head/zh_CN.UTF-8/htdocs/releases/5.5R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/5.5R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-ia64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/installation.xml head/zh_CN.UTF-8/htdocs/releases/5.5R/readme.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-ia64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/5.5R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/6.0R/errata.html head/zh_CN.UTF-8/htdocs/releases/6.0R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/6.0R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/installation.xml head/zh_CN.UTF-8/htdocs/releases/6.0R/readme.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.0R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/6.1R/errata.html head/zh_CN.UTF-8/htdocs/releases/6.1R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/6.1R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/installation.xml head/zh_CN.UTF-8/htdocs/releases/6.1R/readme.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.1R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/6.2R/errata.html head/zh_CN.UTF-8/htdocs/releases/6.2R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/6.2R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/installation.xml head/zh_CN.UTF-8/htdocs/releases/6.2R/readme.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-ia64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.2R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/6.3R/errata.html head/zh_CN.UTF-8/htdocs/releases/6.3R/hardware-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.3R/hardware-i386.html head/zh_CN.UTF-8/htdocs/releases/6.3R/hardware.xml head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-i386.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-powerpc.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.3R/installation.xml head/zh_CN.UTF-8/htdocs/releases/6.3R/readme.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-alpha.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-amd64.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-i386.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-pc98.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-powerpc.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes-sparc64.html head/zh_CN.UTF-8/htdocs/releases/6.3R/relnotes.xml head/zh_CN.UTF-8/htdocs/releases/7.0R/errata.html head/zh_CN.UTF-8/htdocs/releases/7.0R/hardware.html head/zh_CN.UTF-8/htdocs/releases/7.0R/readme.html head/zh_CN.UTF-8/htdocs/releases/7.0R/relnotes.html head/zh_CN.UTF-8/htdocs/releases/7.1R/errata.html head/zh_CN.UTF-8/htdocs/releases/7.1R/hardware.html head/zh_CN.UTF-8/htdocs/releases/7.1R/readme.html head/zh_CN.UTF-8/htdocs/releases/7.1R/relnotes.html head/zh_CN.UTF-8/htdocs/releases/7.2R/errata.html head/zh_CN.UTF-8/htdocs/releases/7.2R/hardware.html head/zh_CN.UTF-8/htdocs/releases/7.2R/readme.html head/zh_CN.UTF-8/htdocs/releases/7.2R/relnotes-detailed.html head/zh_CN.UTF-8/htdocs/releases/index.xml head/zh_CN.UTF-8/htdocs/relnotes.xml head/zh_CN.UTF-8/htdocs/security/charter.xml head/zh_CN.UTF-8/htdocs/security/mkindex.xsl head/zh_CN.UTF-8/htdocs/security/security.xml head/zh_CN.UTF-8/htdocs/send-pr.xml head/zh_CN.UTF-8/htdocs/support.xml head/zh_CN.UTF-8/htdocs/where.xml head/zh_CN.UTF-8/share/xml/authors-in-author-tag.ent head/zh_CN.UTF-8/share/xml/authors.ent head/zh_CN.UTF-8/share/xml/freebsd-fo.xsl head/zh_CN.UTF-8/share/xml/freebsd-xhtml.xsl head/zh_CN.UTF-8/share/xml/glossary.ent head/zh_CN.UTF-8/share/xml/header.l10n.ent head/zh_CN.UTF-8/share/xml/l10n.ent head/zh_CN.UTF-8/share/xml/libcommon.xsl head/zh_CN.UTF-8/share/xml/mailing-lists.ent head/zh_CN.UTF-8/share/xml/mirrors-local.xsl head/zh_CN.UTF-8/share/xml/navibar.l10n.ent head/zh_CN.UTF-8/share/xml/news.xml head/zh_CN.UTF-8/share/xml/press.xml head/zh_CN.UTF-8/share/xml/release.l10n.ent (contents, props changed) head/zh_CN.UTF-8/share/xml/teams.ent head/zh_CN.UTF-8/share/xml/trademarks.ent head/zh_CN.UTF-8/share/xml/transtable-local.xsl head/zh_CN.UTF-8/share/xml/transtable.xml Modified: head/Makefile ============================================================================== --- head/Makefile Thu Nov 14 00:18:50 2013 (r43187) +++ head/Makefile Thu Nov 14 00:20:51 2013 (r43188) @@ -27,7 +27,7 @@ SUBDIR+= pt_BR.ISO8859-1 SUBDIR+= ru_RU.KOI8-R SUBDIR+= sr_YU.ISO8859-2 SUBDIR+= tr_TR.ISO8859-9 -SUBDIR+= zh_CN.GB2312 +SUBDIR+= zh_CN.UTF-8 SUBDIR+= zh_TW.Big5 .endif Modified: head/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/faq/book.xml Thu Nov 14 00:18:50 2013 (r43187) +++ head/en_US.ISO8859-1/books/faq/book.xml Thu Nov 14 00:20:51 2013 (r43188) @@ -729,9 +729,9 @@ </row> <row> - <entry><literal>zh_CN.GB2312</literal></entry> + <entry><literal>zh_CN.UTF-8</literal></entry> - <entry>Simplified Chinese (China, GB2312 + <entry>Simplified Chinese (China, UTF-8 encoding)</entry> </row> Modified: head/en_US.ISO8859-1/htdocs/Makefile ============================================================================== --- head/en_US.ISO8859-1/htdocs/Makefile Thu Nov 14 00:18:50 2013 (r43187) +++ head/en_US.ISO8859-1/htdocs/Makefile Thu Nov 14 00:20:51 2013 (r43188) @@ -102,7 +102,7 @@ WEB_LANG= da_DK.ISO8859-1 \ nl_NL.ISO8859-1 \ pt_BR.ISO8859-1 \ ru_RU.KOI8-R \ - zh_CN.GB2312 \ + zh_CN.UTF-8 \ zh_TW.Big5 .endif .if !defined(ENGLISH_ONLY) || empty(ENGLISH_ONLY) Modified: head/zh_CN.UTF-8/articles/Makefile.inc ============================================================================== --- head/zh_CN.GB2312/articles/Makefile.inc Wed Nov 13 20:49:50 2013 (r43186) +++ head/zh_CN.UTF-8/articles/Makefile.inc Thu Nov 14 00:20:51 2013 (r43188) @@ -5,4 +5,4 @@ # $FreeBSD$ # -DESTDIR?= ${DOCDIR}/zh_CN.GB2312/articles/${.CURDIR:T} +DESTDIR?= ${DOCDIR}/zh_CN.UTF-8/articles/${.CURDIR:T} Modified: head/zh_CN.UTF-8/articles/contributing/article.xml ============================================================================== --- head/zh_CN.GB2312/articles/contributing/article.xml Wed Nov 13 20:49:50 2013 (r43186) +++ head/zh_CN.UTF-8/articles/contributing/article.xml Thu Nov 14 00:20:51 2013 (r43188) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="gb2312"?> +<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">; <!-- @@ -8,16 +8,16 @@ Original Revision: 1.511 --> <article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="zh_cn"> - <info><title>Ϊ FreeBSD ṩ</title> + <info><title>为 FreeBSD 提供帮助</title> <abstract> - <para>Ϊ˻֯ϣΪFreeBSDĿṩ - ڱҵʵķ</para> + <para>无论是作为个人还是组织机构，如果您希望为FreeBSD项目提供帮助， + 都可以在本文中找到合适的方法。</para> </abstract> <authorgroup> - <author><personname><firstname>Jordan</firstname><surname>Hubbard</surname></personname><contrib>ԭ</contrib></author> + <author><personname><firstname>Jordan</firstname><surname>Hubbard</surname></personname><contrib>原著</contrib></author> </authorgroup> <legalnotice xml:id="trademarks" role="trademarks"> @@ -32,368 +32,368 @@ </info> - <indexterm><primary> </primary></indexterm> + <indexterm><primary>贡献 </primary></indexterm> - <para>ϣ FreeBSD Ŀʲô ̫ˣ ǻӭ FreeBSD - <emphasis></emphasis> ûĹײŵԷչ׳ġ - DzdzлĹףңЩ FreeBSD ijչҲҪ</para> - - <para>ҲIJͬ ȲһɫijԱ Ҳ - FreeBSD ŶӳԱкܺõ˽ ǻһͬʵĶԴĹ - FreeBSD ĿԱ鲼ȫ Ҽר죬 ֲҲdz㷺 - ÿ죬 ǶԳĹû㹻֣ - ʱӭİ</para> - - <para>FreeBSD ĿһIJϵͳ - ֻһں˻һЩɢĹ߰ ˣ ǵ - <filename>TODO</filename> бָĹ - ĵûԡʾ ϵͳװ߶רҵں˿ - ļˮƽΣ º Ŀ</para> - - <para>ǹº FreeBSD عҵϵ - ҪһЩչʹIJƷתô - ᷢǺӦ رϡŹֵġ - Ƿصֵҵ ɣ - ҲеijЩЭ - ŬƾеĹ ۺάĿ - ϣܸһλᡣ</para> + <para>您希望给 FreeBSD 项目做点什么吗？ 太好了， 我们欢迎您。 FreeBSD 正是 + <emphasis>依靠</emphasis> 广大用户的贡献才得以发展壮大的。 + 我们不仅非常感谢您所做的贡献，而且，这些工作对于 FreeBSD 的持续发展也至关重要。</para> + + <para>也许与您想象的不同， 您既不必是一名出色的程序员， 也无须和 + FreeBSD 核心团队成员有很好的私交， 我们会一视同仁的对待您的工作。 + FreeBSD 的开发人员遍布全球， 大家技术专长各异， 年龄分布也非常广泛。 + 每天， 我们都在面对持续增长的工作而苦于没有足够的人手， + 因此我们随时欢迎您的帮助。</para> + + <para>FreeBSD 项目处理的是一个完整的操作系统环境， + 而不只是一个内核或是一些零散的工具包。 因此， 我们的 + <filename>TODO</filename> 任务列表里包含各种各样的工作， + 从文档、用户测试、演示， 到系统安装程序和高度专业的内核开发。 + 因此无论您的技术水平如何， 从事何种领域， 都可以帮助这个项目。</para> + + <para>我们鼓励从事和 FreeBSD 相关工作的企业和我们联系。 + 您需要一些特殊的扩展来使您的产品运转起来么？ + 您会发现我们很乐意答应您的请求， 除非是特别稀奇古怪的。 + 您是否正从事相关的增值业务？ 让我们来帮助您吧， + 我们也许可以在其中的某些方面相互协作。 + 自由软件世界正在努力打破旧有的关于软件开发、 销售和维护的框框， + 我们希望恳请您至少能给它一次机会。</para> <sect1 xml:id="contrib-what"> - <title>ǵ</title> + <title>我们的需求</title> - <para>гһЩҪɵĿ - ǻϿԱͬ <filename>TODO</filename>(б) - б ԼûҪ</para> + <para>下面列出了一些需要完成的任务和子项目， + 它们基本上可以被等同于 <filename>TODO</filename>(任务列表) + 列表， 以及用户的要求。</para> <sect2 xml:id="non-programmer-tasks"> - <title>ڽеķǿ</title> + <title>正在进行中的非开发任务</title> - <para>ܶμFreeBSDĿ˲dzԱ - Ŀĵдߡ ҳʦ Լ֧Ա - Щ־Ը˵ ֻҪһЩʱ䣬 - ҾѧϰԸ</para> + <para>很多参加FreeBSD项目的人不是程序员。 + 这个项目里有文档撰写者、 网页设计师、 以及技术支持人员。 + 对于这些志愿者来说， 他们只需要贡献一些时间， + 并且具有学习的意愿。</para> <orderedlist> <listitem> - <para>ԾͨFAQֲᣬ ˷Ľͣ - ǹʱ֪ʶ ȫȷĵط ǡ - ˳ְǸĹǾ - (SGMLʵѧ Ҳֱύ - ASCII İ汾)</para> + <para>您可以经常通读FAQ和手册， 如果您发现了繁琐的解释， + 或者是过时的知识， 甚至完全不正确的地方， 都请告诉我们。 + 如果您能顺手把他们改过来那就更好了 + (SGML其实并不难学， 但我们也不反对您直接提交 + ASCII 的版本)。</para> </listitem> <listitem> - <para>ǰ FreeBSD ĵĸ - ĸ汾Ѿˣ - ҲԷһЩĵЩеĵǷ¸¹ġ - ȼ FreeBSD ĵƻй <link xlink:href="&url.books.fdp-primer;/translations.html">ij</link> - μӷ빤˵Ҫ¾սе FreeBSD ĵ - Ϊһ־Ըߣ ٹȫȡԸ һij˿ʼˣ - ˼һ뵽Щ - ֻʱ߾ȥ벿ĵ - ȥ밲װָϡ</para> + <para>帮助我们把 FreeBSD 文档翻译成您的母语。 + 如果您的母语版本已经存在了， + 您也可以翻译一些其他的文档或者检查那些已有的文档是否是最新更新过的。 + 您可以先简单看看 FreeBSD 文档计划中有关 <link xlink:href="&url.books.fdp-primer;/translations.html">翻译的常见问题</link>。 + 参加翻译工作并不是说您要孤军奋战翻译所有的 FreeBSD 文档。 + 作为一个志愿者， 做多少工作完全取决于您的意愿。 一旦某个人开始翻译了， + 其他人几乎一定会参与到这些工作中来。 + 如果您只有有限的时间或者精力去翻译部分文档， + 您可以首先去翻译安装指南。</para> </listitem> <listitem> - <para>Ķ &a.questions; żһ &ng.misc; - (йɵ) ˷רҵ֪ʶ - ǽһõ飻 - ЩʱѧһЩ¶ - Щ̳ʱҲΪṩһЩмֵ⡣</para> + <para>阅读 &a.questions; 并偶尔看一看 &ng.misc; + (甚至有规律地这样做)。 与别人分享您的专业知识， + 并帮助他们解决问题是一件令人愉悦的事情； + 有些时候您甚至可以在这个过程中学到一些新东西！ + 这些论坛有时也会为您提供一些有价值的主意。</para> </listitem> </orderedlist> </sect2> <sect2 xml:id="ongoing-programmer-tasks"> - <title>ڽеĿ</title> - <para>ĴҪͶɹ۵ʱ䣬 - Ҫ FreeBSD ں˷зḻ֪ʶ ߶Ҫ - ȻҲкܶҪҲһ - <quote>ĩԱ</quote> ͿԸꡣ</para> + <title>正在进行的开发任务</title> + <para>列在这里的大部分任务都需要您投入可观的时间， + 或者需要您在 FreeBSD 内核方面有丰富的知识， 或者两者都要。 + 当然这里也有很多重要的任务也许您一个 + <quote>周末开发人员</quote> 就可以干完。</para> <orderedlist> <listitem> - <para> FreeBSD-CURRENT 汾һٵ - Internet· Է <systemitem class="fqdomainname">current.FreeBSD.org</systemitem> - ÿһ°汾 — пգ - ԸһݲҰװ - ʲô⣬ǡ</para> + <para>如果您正在运行 FreeBSD-CURRENT 版本并且有一条高速的 + Internet接入线路， 您可以访问 <systemitem class="fqdomainname">current.FreeBSD.org</systemitem>， + 这里每天会有一个新版本 — 如果您有空， + 您可以隔三岔五地下载一份并且安装它， + 其间如果出了什么问题，请告诉我们。</para> </listitem> <listitem> - <para>Ķ &a.bugs; ܻΪЩṩнۣ - ߰æһЩ ⣬ - ԳеһЩ⡣</para> + <para>阅读 &a.bugs;。 您可能会为这些问题提供具有建设性意义的评论， + 或者帮忙测试一些补丁。 此外， + 您甚至可以尝试修正其中的一些问题。</para> </listitem> <listitem> - <para>֪һЩѾ -CURRENT ϳɹؽУ - ھһʱ֮Ȼûкϲ -STABLE - (ͨ 2) ص committer һòʾš</para> + <para>如果您知道有一些修正已经在 -CURRENT 上成功地进行， + 但在经过一段时间之后仍然没有合并到 -STABLE + (通常是 2周左右)， 给相关的 committer 发一封礼貌的提示信。</para> </listitem> <listitem> - <para>뵽Դе - <filename>src/contrib</filename> Ŀ¼</para> + <para>将第三方软件加入到源代码中的 + <filename>src/contrib</filename> 目录。</para> </listitem> <listitem> - <para>ȷ <filename>src/contrib</filename> - еĴµ</para> + <para>确保 <filename>src/contrib</filename> + 中的代码是最新的</para> </listitem> <listitem> - <para>Ըߵľ漶Դ (һԴ) - Щ档</para> + <para>以更高的警告级别构建源代码 (或一部分源代码) + 并清理这些警告。</para> </listitem> <listitem> - <para>Щ ports ʹùʱĶ - <function>gets()</function> - <filename>malloc.h</filename> ľ档</para> + <para>更新那些在 ports 中使用过时的东西， + 例如 <function>gets()</function> 或包含 + <filename>malloc.h</filename> 所产生的警告。</para> </listitem> <listitem> - <para> ports һЩ - &os; ĸĶ IJظԭ - (´ʱĹһЩ)</para> + <para>如果您制作了 ports， 并进行了一些针对 + &os; 的改动， 将您的补丁发回给原作者 + (这样下次升级时您的工作会变得轻松一些)。</para> </listitem> <listitem> - <para>ȡһʽı &posix; ĸ - <link xlink:href="&url.base;/projects/c99/index.html">FreeBSD - C99 & POSIX ˳ӦĿ</link> վϵõصӡ - FreeBSD ΪͬбȽϡ ͬ - رЩϸڵطС죬 뷢һ PR (ⱨ) - ܣ ָ PR ύ - Ϊ⣬ - ҪµĿǡ</para> + <para>获取一份正式的标准， 如 &posix; 的副本。 + 您可以在 <link xlink:href="&url.base;/projects/c99/index.html">FreeBSD + C99 & POSIX 标准顺应项目</link> 网站上得到相关的链接。 + 将 FreeBSD 的行为同标准进行比较。 如果与标准不同， + 特别是那些细节地方的微小差异， 请发送一个关于它的 PR (问题报告)。 + 如果可能， 请指出如何修正它， 并随 PR 提交补丁。 + 如果您认为标准有问题， + 请向标准化团体要求对其进行重新的考虑。</para> </listitem> <listitem> - <para>Ϊбݣ</para> + <para>为这份列表建议更多的内容！</para> </listitem> </orderedlist> </sect2> <sect2> - <title>鿴 PR ݿ</title> + <title>查看整个 PR 数据库</title> - <indexterm><primary>ⱨݿ</primary></indexterm> + <indexterm><primary>问题报告数据库</primary></indexterm> <para><link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">FreeBSD - PR б</link> չʾеǰڻԾ״̬ⱨ棬 Լ - FreeBSD ûύĸĽ顣 PR - ݿͬʱ˿ԱͷǿԱ - 鿴Щδ PR ǷȤ - пһЩǷdz⣬ - ֻҪһȷ PR ȷġ һЩܻdzӣ - ȫûаκ</para> - - <para>ȿһЩû˽ֵ PR - PR Ѿˣ ܹģ - ԸǸ˷ţ ѯǷṩ — - ǿѾ˿ɹԵIJ һЩɹ۵</para> + PR 列表</link> 展示了所有当前处于活跃状态的问题报告， 以及由 + FreeBSD 用户提交的改进建议。 PR + 数据库同时包括了开发人员和非开发人员的任务。 + 查看那些尚未解决的 PR， 并看看是否有您感兴趣的任务。 + 这其中可能有一些是非常简单的问题， + 只需要看一看并确认 PR 是正确的。 另外一些可能会非常复杂， + 或者完全没有包括任何修正。</para> + + <para>首先看一看那些还没有人接手的 PR。 + 如果 PR 已经分配给了其它人， 但看起来是您能够处理的， + 您可以给那个人发信， 并询问您是否可以提供帮助 — + 他们可能已经有了可供测试的补丁， 或有一些可供讨论的意见。</para> </sect2> <sect2> - <title> <quote></quote> ҳĿ</title> + <title>从 <quote>点子</quote> 网页上认领项目</title> <para><link xlink:href="&url.base;/projects/ideas/">&os; - ־ԸĿ͵嵥</link> ҲṩԸΪ - &os; Ŀǵġ - 嵥һֱڱڸţ - ˶ԳԱͷdzԱõÿĿϢ</para> + 志愿者项目和点子清单</link> 也是提供给愿意为 + &os; 项目做出贡献的人们的。 + 这张清单一直在被定期更新着， + 包含了对程序员和非程序员有用的每个项目的信息。</para> </sect2> </sect1> <sect1 xml:id="contrib-how"> - <title>ṩ</title> + <title>如何提供帮助</title> - <para>ĽϵͳϿԷΪ 5 ࣺ</para> + <para>帮助改进系统基本上可以分为 5 类：</para> <sect2 xml:id="contrib-general"> - <title>һע</title> + <title>错误报告和一般的注解</title> - <para>ͨ <emphasis>һϵ</emphasis> - 뷨ͽӦ÷ &a.hackers; - ͬأ ЩȤ (Ȼ - ͬʱҪܹ <emphasis></emphasis> ʼ) - ԿǶ &a.hackers; - μ <link xlink:href="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">FreeBSD - ʹֲ</link> ˽ʼб - Լʼбϸ</para> - - <para> bug ҪύijЩģ - ͨ &man.send-pr.1; ʹ - <link xlink:href="&url.base;/send-pr.html"> WEB - ύҳ</link> ύ д bug ÿһ - һ˵ ǽ bug ֱӸϲ 65KB - ֱӦõԴϣ ڱ - synopsis һд <literal>[PATCH]</literal> - ڸʱ <emphasis>Ҫ</emphasis> - ͨƺճУ Ϊ tab ɿո - ܾܿͲˡ 20KB ܶ࣬ - Ӧǽѹ (ʹ &man.gzip.1; &man.bzip2.1;) - ֮ &man.uuencode.1; б֮ٷŽⱨС</para> - - <para>һ汻浵 յһȷʼԼһ¼ٱš - 뱣ţ Ϊ֮ʹţ - ʼ &a.bugfollowup; - ṩڸ¼ĽһϢ ҪǽŷŵʼıУ - <literal>"Re: - kern/3377"</literal> - ͬһһӦַͨʽύ</para> - - <para>һʱ֮Ȼûյȷ ( 3 - 1 ܣ ȡʼ) - ijԭʹ &man.send-pr.1; - ԷŸ &a.bugs; Ҫ˴</para> + <para>通常， <emphasis>一般意义上的</emphasis> + 技术想法和建议应该发到 &a.hackers;。 + 同样地， 对于这些东西有兴趣的人 (当然， + 他们同时还要能够容忍 <emphasis>大量的</emphasis> 邮件！) + 可以考虑订阅 &a.hackers;。 + 参见 <link xlink:href="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">FreeBSD + 使用手册</link> 以了解关于这个邮件列表， + 以及其它邮件列表的详细情况。</para> + + <para>如果您发现了 bug 或者想要提交某些修改， + 请通过 &man.send-pr.1; 程序或使用 + <link xlink:href="&url.base;/send-pr.html">基于 WEB + 的提交页面</link> 来提交。 请试着填写 bug 报告的每一项。 + 一般来说， 我们建议在 bug 报告中直接附上补丁， 除非它超过了 65KB。 + 如果补丁可以直接应用到源代码上， 则建议您在报告的 + synopsis 一栏写上 <literal>[PATCH]</literal>。 + 在附带补丁时， 请 <emphasis>不要</emphasis> + 通过复制和粘贴来进行， 因为这样做会把 tab 变成空格， + 结果补丁很可能就不能用了。 如果补丁超过 20KB 很多， + 应考虑将其压缩 (例如使用 &man.gzip.1; 或 &man.bzip2.1;) + 之后用 &man.uuencode.1; 进行编码之后再放进您的问题报告中。</para> + + <para>一旦报告被存档， 您会收到一封确认邮件以及一个事件追踪编号。 + 请保留这个编号， 因为您可以在之后使用这个编号， + 发邮件到 &a.bugfollowup; + 来提供关于该事件的进一步信息。 您需要做的是将编号放到邮件的标题中， + 例如 <literal>"Re: + kern/3377"</literal>。 + 关于同一问题更进一步的情况应该通过这种方式来提交。</para> + + <para>如果您在一段时间之后仍然没有收到确认信 (超过 3 + 天甚至 1 周， 这取决于您的邮件服务) + 或者由于某种原因无法使用 &man.send-pr.1; 命令， + 则可以发信给 &a.bugs; 要求别人代您发送它。</para> - <para>μ <link xlink:href="&url.articles.problem-reports;/article.html">ƪ</link> - ˽дõⱨ档</para> + <para>请参见 <link xlink:href="&url.articles.problem-reports;/article.html">这篇文章</link> + 了解如何撰写好的问题报告。</para> </sect2> <sect2> - <title>ĵ</title> + <title>对于文档的修订</title> - <indexterm><primary>ύĵ</primary></indexterm> + <indexterm><primary>提交文档</primary></indexterm> - <para>ĵ &a.doc; 顣 - μ <link xlink:href="&url.books.fdp-primer;/index.html">FreeBSD - ĵƻ</link> ָ - 밴 <xref linkend="contrib-general"/> нܵķʹ &man.send-pr.1; - µĵ߶ĵ (ǺСĸĽҲǻӭģ)</para> + <para>对于文档的修改由 &a.doc; 来审查。 + 请参见 <link xlink:href="&url.books.fdp-primer;/index.html">FreeBSD + 文档计划初级读本</link> 来获得完整的指导。 + 请按照 <xref linkend="contrib-general"/> 中介绍的方法使用 &man.send-pr.1; + 来发送新的文档或者对于现有文档的完善 (哪怕是很小的改进也是欢迎的！)。</para> </sect2> <sect2> - <title>Դ</title> + <title>对于现有源代码的修改</title> <indexterm><primary>FreeBSD-CURRENT</primary></indexterm> - <para>дϽĻӹij̶ֳҪ༼ɵ飬 - һĿǰ FreeBSD Ŀ״˽йء - жַʽԵõ <quote>FreeBSD-CURRENT</quote> - FreeBSD 汾 ͨ˽Ŀ - μ <link xlink:href=" &url.books.handbook;/current-stable.html">FreeBSD - ʹֲ</link> ˽ʹ FreeBSD-CURRENT Ľһ顣</para> - - <para>ھɵĴϽģ ͨڴѾʱ - µĿ汾̫¼ɵ FreeBSD С - &a.announce; Լ &a.current; ʼб - ͨ˽ĿǰĿ״̬</para> - - <para>˵ܹھµĴģ - һҪеĵIJļ - FreeBSD άԱ ͨ &man.diff.1; - ɡ</para> - - <para>ύʱƼ &man.diff.1; ʽһ² (unified diff) - ͨ <command>diff - -u</command> ɡ ˴Ĵ룬 - ʹ <command>diff -c</command> ɵĸʽ (context diff) - IJܸĶ Ƽʹá</para> + <para>在现有代码上进行修改或增加功能在某种程度上是需要更多技巧的事情， + 并且还和您对于目前 FreeBSD 的开发现状的了解有关。 + 有多种方式可以得到被称作 <quote>FreeBSD-CURRENT</quote> + 的 FreeBSD 开发版本， 您可以通过它来了解最近的开发情况。 + 请参见 <link xlink:href=" &url.books.handbook;/current-stable.html">FreeBSD + 使用手册</link> 来了解使用 FreeBSD-CURRENT 的进一步详情。</para> + + <para>在旧的代码上进行修改， 则通常可能由于代码已经过时， + 或与新的开发版本差异太大而无法被重新集成到 FreeBSD 中。 + 如果您订阅了 &a.announce; 以及 &a.current; 邮件列表， + 则可以通过它们来大体了解目前的开发状态。</para> + + <para>假如说您能够基于尽可能新的代码来完成您的修改， + 则下一步要做的事情就是生成您所进行的修改的差异文件， + 并将它发给 FreeBSD 的维护人员。 这项工作可以通过 &man.diff.1; + 命令来完成。</para> + + <para>提交补丁时推荐的 &man.diff.1; 格式是一致差异 (unified diff)， + 它可以通过 <command>diff + -u</command> 来生成。 不过， 如果您修改了大量的代码， + 则使用 <command>diff -c</command> 来生成的上下文格式 (context diff) + 的差异可能更容易阅读， 因而推荐使用。</para> <indexterm> <primary><command>diff</command></primary> </indexterm> - <para>磺</para> + <para>例如：</para> <screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen> - <para></para> + <para>或者</para> <screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen> - <para>ֱɸļĿ¼ṹ context diff</para> + <para>将分别生成给定文件或目录结构的 context diff。</para> - <para>Ƶأ</para> + <para>类似地，</para> <screen>&prompt.user; <userinput>diff -u oldfile newfile</userinput></screen> - <para></para> + <para>或</para> <screen>&prompt.user; <userinput>diff -u -r olddir newdir</userinput></screen> - <para>ǰƣ õĸʽ unified diff</para> + <para>的作用与前面的类似， 但采用的格式是 unified diff。</para> - <para>μ &man.diff.1; ֲ˽ϸڡ</para> + <para>请参见 &man.diff.1; 联机手册了解更多细节。</para> - <para>һʹ &man.diff.1; ˲켯 (ʹ - &man.patch.1; һ) Ϳύǣ - Ա㱻 FreeBSD ¼ ͨʹ <xref linkend="contrib-general"/> - ܵ &man.send-pr.1; Ϳ - <emphasis>Ҫ</emphasis> ֻǰѲ켯 &a.hackers; - ǿܻᱻ ǻdzмύ - (һ־ԸĿ) ΪǶæ - ʱһܹ⣬ PR - ݿ⽫һֱЩ¼ - ֻҪʱǾܱˡ - ⱨа һҪڱ - <literal>[PATCH]</literal> ǿһ¡</para> + <para>一旦您使用 &man.diff.1; 生成了差异集 (可以使用 + &man.patch.1; 命令来测试一下)， 就可以提交它们， + 以便被 FreeBSD 收录。 通过使用 <xref linkend="contrib-general"/> + 中所介绍的 &man.send-pr.1; 程序就可以完成这项工作。 + <emphasis>不要</emphasis> 只是把差异集发到 &a.hackers;， + 否则它们可能会被丢掉！ 我们会非常感激您提交的修改 + (这是一个志愿者项目！)； 因为我们都很忙， + 因此有时不一定能够立即修正问题， 但 PR + 数据库将一直保持着这些记录， + 因此只要有人有了时间它们就能被改正了。 + 如果您的问题报告中包括补丁， 一定不要忘了在标题上用 + <literal>[PATCH]</literal> 来强调一下。</para> <indexterm> <primary><command>uuencode</command></primary> </indexterm> - <para>Ϊ (ӡ ɾļ) - Կʹ - <command>tar</command> ļ Ȼ &man.uuencode.1; - 롣 Ҳӭ &man.shar.1; İ</para> - - <para>ĿܴDZڵ飬 磬 - ȷ֮صİȨ⣬ ߸оҪϸĸſԷǣ - Ӧֱӷ &a.core; ͨ &man.send-pr.1; ͡ - &a.core; һС飬 ԱĴ FreeBSD ճ - Ҫעǣ СҲ <emphasis>æ</emphasis> - ֻڷdzҪʱӦдš</para> + <para>如果您认为合适 (例如您添加、 删除或重命名了文件)， + 还可以考虑使用 + <command>tar</command> 来将文件打包， 然后用 &man.uuencode.1; + 来编码。 我们也欢迎用 &man.shar.1; 创建的包。</para> + + <para>如果您的修改可能存在潜在的争议， 例如， + 您不确定与之相关的版权问题， 或者感觉需要经过更严格的复审才可以发布它们， + 则应直接发给 &a.core;， 而不是通过 &man.send-pr.1; 来发送。 + &a.core; 是一个小组， 其成员更多的从事 FreeBSD 的日常工作。 + 需要注意的是， 这个小组也因此 <emphasis>很忙</emphasis>， + 因此只有在非常必要的时候才应给他们写信。</para> - <para>ο &man.intro.9; &man.style.9; ˽ڱϰߺԼ顣 - ˽ЩԼ ˵Ǽİ</para> + <para>请参考 &man.intro.9; 和 &man.style.9; 以了解关于编码习惯和约定的详情。 + 如果您了解这些约定， 则对我们来说将是极大的帮助。</para> </sect2> <sect2> - <title>´Ҫֵ</title> + <title>新代码或重要的增值软件包</title> - <para>ṩģϴĴ룬 Ϊ FreeBSD Ҫ¹ܣ - ܱ뽫ͨ uuencode б룬 ij Web - FTP վ㣬 Աܹõ ûķ - 뵽ص FreeBSD ʼб ǷԸǡ</para> + <para>如果您打算提供规模较大的代码， 或者为 FreeBSD 增加重要的新功能， + 则可能必须将它们通过 uuencode 进行编码， 或传到某个 Web 或 + FTP 站点， 以便更多的人能够得到它。 如果您没有这样的服务器， + 请到相关的 FreeBSD 邮件列表提出， 看看是否有人愿意帮您放置它们。</para> - <para>ڴĴԣ ڰȨ϶ᱻ - FreeBSD ϵͳܹʹõİȨ</para> + <para>对于大量的代码而言， 关于版权的问题肯定会被提出。 + FreeBSD 基本系统中能够使用的版权声明包括：</para> <orderedlist> <listitem> - <para>BSD<indexterm><primary>BSD Ȩ</primary></indexterm> Ȩ ʹȨĴ룬 - Ϊ <quote>Ӷ</quote> ܹҵҵʹá - FreeBSD ҵ˾ʹĴ룬 ෴ - ǻعҵ˾ʹǵĴ룬 - Ȼ հһִ¾ FreeBSD - ˡ</para> + <para>BSD<indexterm><primary>BSD 版权声明</primary></indexterm> 版权。 我们倾向于使用这类授权的代码， + 因为它 <quote>不附加多余的条件</quote>， 因而更能够吸引商业企业使用。 + FreeBSD 并不反对商业公司使用它的代码， 相反， + 我们积极地鼓励商业公司使用我们的代码， + 当然， 如果它们最终把一部分代码重新捐赠给 FreeBSD + 就更好了。</para> </listitem> <listitem> - <para>GNU General Public License<indexterm><primary>GPL</primary><see>GNU General Public License</see></indexterm><indexterm><primary>GNU General Public License</primary></indexterm> <quote>GPL</quote> - DzܻӭʹȨĴ룬 - Ϊҵ˾ʹҪĹ ںܶʹ - GPL ȨĴĿǰ ( - ıŰȵ) ܾʹвȨǺܲǵġ - GPL ȨĴᱻŵԴһЩרŵλã - <filename>/sys/gnu</filename> - <filename>/usr/src/gnu</filename> - ԷЩʹ GPL ܻǴʶ</para> + <para>GNU General Public License，<indexterm><primary>GPL</primary><see>GNU General Public License</see></indexterm><indexterm><primary>GNU General Public License</primary></indexterm> 或简称 <quote>GPL</quote>。 + 我们并不很欢迎使用这样授权的代码， + 因为商业公司使用它需要做更多的工作。 不过， 由于很多使用 + GPL 授权的代码目前是无法避免的 (编译器、 汇编器， + 文本排版程序等等)， 拒绝使用所有采用这样授权的软件是很不明智的。 + 采用 GPL 授权的代码会被放到源代码的一些专门的位置， 例如 + <filename>/sys/gnu</filename> 或 + <filename>/usr/src/gnu</filename>， + 以方便那些使用 GPL 代码可能会给他们带来问题的人识别。</para> </listitem> </orderedlist> - <para>ʹȨĴڽ FreeBSD ֮ǰ뾭صĸͿǡ - ðƵҵȨĴ룬 һ˵ᱻܾ - ǹЩͨԼǡ</para> - - <para>Ҫijɹϼ <quote>BSDʽ</quote> İȨ - ıŵÿһԴļʼ֣ - ʵ滻 <literal>%%</literal> ֮֡</para> + <para>使用其它授权的代码在进入 FreeBSD 之前必须经过慎重的复审和考虑。 + 采用包含严厉限制的商业授权的代码， 一般来说会被拒绝， + 但我们鼓励这些代码的作者通过自己的渠道来发布它们。</para> + + <para>要在您的成果上加入 <quote>BSD式</quote> 的版权， + 请把下列文本放到每一个源文件的最开始部分， + 并用适当的文字替换 <literal>%%</literal> 之间的文字。</para> <programlisting>Copyright (c) %%proper_years_here%% %%your_name_here%%, %%your_state%% %%your_zip%%. @@ -422,30 +422,30 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE PO $Id$</programlisting> - <para>Ϊ˷ʹã + <para>为了方便您的使用， 在 <filename>/usr/share/examples/etc/bsd-style-copyright</filename> - ҲҵȨĸ</para> + 也可以找到此授权的副本。</para> </sect2> <sect2> - <title>ʽ Ӳ Internet </title> + <title>资金、 硬件或 Internet 接入</title> - <para>ǷdzԸܸʽľ Խһչ FreeBSD - Project ҵ Ϊ֧֣ - ־ԸŬܹиijɾͣ - ӲҲdzҪ Ϊܹӿֵ֧Ӳ࣬ - еĺܶ˲û㹻ʽЩӲ</para> + <para>我们非常愿意接受各种形式的捐赠， 以进一步拓展 FreeBSD + Project 的事业， 因为有您的支持， + 像我们这样的志愿者努力才能够有更大的成就！ + 捐赠硬件也非常重要， 因为这样能够帮助我们增加可以支持的硬件种类， + 而我们中的很多人并没有足够的资金来购置这些硬件。</para> <sect3 xml:id="donations"> - <title></title> + <title>捐款</title> - <para>FreeBSD һӪġ п˰ȨĻᣬ - ĿΪ FreeBSD Project ܹɸӳԶĿꡣ - Ϊ 501(c)3 ʵ壬 һԻϽ˰ - Լ˰ ͨڿ˰ʵо - ۵Ӧ˰ֵĽ</para> + <para>FreeBSD 基金会是一个非营利的、 有课税豁免权的基金会， + 建立这个基金会的目标是为了让 FreeBSD Project 能够达成更加长远的目标。 + 作为 501(c)3 实体， 一般而言基金会可以免予上缴美国联邦收入税， + 以及科罗拉多州收入税。 通常对于课税豁免的实体进行捐赠， + 可以折抵联邦收入中应课税部分的金额。</para> - <para>֧Ʊ + <para>您可以把支票寄往： <address> The FreeBSD Foundation <street>7321 Brockway Dr.</street> @@ -454,31 +454,31 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE PO </address> </para> - <para>FreeBSD ڿͨ PayPal Ͻܾ - <link xlink:href="http://www.freebsdfoundation.org">web - վ</link></para> - - <para> FreeBSD ĸ飬 <link xlink:href="http://people.FreeBSD.org/~jdp/foundation/announcement.html">FreeBSD - -- </link> ҵ Ҫᣬ - 뷢͵ʼ - <email>bod@FreeBSDFoundation.org</email></para> + <para>FreeBSD 基金会现在可以通过 PayPal 从网上接受捐款。 + 如果您想向基金会捐款， 请访问它的 <link xlink:href="http://www.freebsdfoundation.org">web + 站点</link>。</para> + + <para>关于 FreeBSD 基金会的更多详情， 可以在 <link xlink:href="http://people.FreeBSD.org/~jdp/foundation/announcement.html">FreeBSD + 基金会 -- 介绍</link> 找到。 要联络基金会， + 请发送电子邮件到 + <email>bod@FreeBSDFoundation.org</email>。</para> </sect3> <sect3> - <title>Ӳ</title> - <indexterm><primary></primary></indexterm> + <title>捐赠硬件</title> + <indexterm><primary>捐赠</primary></indexterm> - <para>FreeBSD ƻӭκ˾ʹõӲ - ȤӲ ϵ <link xlink:href="&url.base;/donations/">˰칫</link></para> + <para>FreeBSD 计划欢迎任何人捐赠可以使用的硬件。 + 如果您有兴趣捐赠硬件， 请联系 <link xlink:href="&url.base;/donations/">捐赠联络人办公室</link>。</para> </sect3> <sect3> - <title> Internet </title> + <title>捐赠 Internet 接入</title> - <para>ǻӭµ FTP WWW - <command>cvsup</command> ϣΪľ - μ <link xlink:href="&url.articles.hubs;/index.html">μ FreeBSD </link> - һģ ˽һ</para> + <para>我们欢迎新的 FTP、 WWW 或 + <command>cvsup</command> 镜像。 如果您希望成为这样的镜像， + 请参见 <link xlink:href="&url.articles.hubs;/index.html">如何架设 FreeBSD 镜像</link> + 一文， 以了解进一步的情况。</para> </sect3> </sect2> </sect1> Modified: head/zh_CN.UTF-8/articles/cvs-freebsd/article.xml ============================================================================== --- head/zh_CN.GB2312/articles/cvs-freebsd/article.xml Wed Nov 13 20:49:50 2013 (r43186) +++ head/zh_CN.UTF-8/articles/cvs-freebsd/article.xml Thu Nov 14 00:20:51 2013 (r43188) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="gb2312"?> +<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">; <!-- @@ -9,7 +9,7 @@ Original Revision: 1.17 --> <article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="zh_cn"> - <info><title> CVS (repository) - FreeBSD ķʽ</title> + <info><title>建立 CVS 储存库 (repository) - 以 FreeBSD 的方式</title> <author><personname><firstname>Stijn</firstname><surname>Hoop</surname></personname><affiliation> @@ -33,529 +33,529 @@ </legalnotice> <abstract> - <para>ļʹú FreeBSD Ŀͬű CVS IJ衣 - ͱ CVS Ĵ֮ŵ㣬 - ṩ˸Դϸȷʿƣ - ܹΪÿһεύɺͷĵʼ</para> + <para>这份文件描述了使用和 FreeBSD 项目相同的命令脚本来建立 CVS 储存库的步骤。 + 这和标准 CVS 建立的储存库相较之下有许多优点， + 它提供了更多对于源代码树的细粒度访问控制， + 并能够为每一次的提交生成和发出易读的电子邮件。</para> </abstract> </info> <sect1 xml:id="introduction"> - <title></title> + <title>简介</title> - <para>ĿԴĿʹ <application>CVS</application> - ΪǵԴϵͳ <application>CVS</application> ŵ㣬 - Ҳвݵ覴úȱ㡣 - ֮һԭǺĿ߷ԴܻѸٳΪϵͳĶΣ - رǵϣݵԴһĴȡʱ</para> - - <para>FreeBSD ڶʹ <application>CVS</application> Ŀ֮һ - ΪпĿԱ鲼ȫ硣 - дһЩűʹùøס - Щű &a.joe; Ҹ - ʹĿٴʹЩűס - ļʹЩµűķ</para> + <para>大多数的开放源代码软件项目都使用 <application>CVS</application> + 作为它们的源代码控制系统。 尽管 <application>CVS</application> 有许多的优点， + 但它也有部份的瑕疵和缺点。 + 其中之一的原因是和其它的开发者分享源代码树可能会迅速成为系统管理的恶梦， + 特别是当有人希望保护部份的源代码树免受于一般的存取时。</para> + + <para>FreeBSD 是众多使用 <application>CVS</application> 的项目之一， + 因为基于它进行开发的开发人员遍布于全世界。 + 他们撰写了一些命令脚本使得管理储存库变得更加容易。 + 最近这些命令脚本由 &a.joe; 重新整理过且更标准化， + 使得在其它的项目上再次使用这些命令脚本会更加容易。 + 本文件将描述使用这些新的命令脚本的方法。</para> - <para>ΪʹļеϢã ҪϤ <application>CVS</application> - Ļʽ</para> + <para>为了使本文件中的信息对您有用， 您需要首先熟悉 <application>CVS</application> + 的基本操作方式。</para> </sect1> <sect1 xml:id="first-setup"> - <title></title> + <title>基本配置</title> <warning> - <para>õķʽһȫµĴִЩ裬 - ȷ˽еĺ ͬʱ ȷҿɶϱݣ</para> + <para>最好的方式是在一个全新的储存库中执行这些步骤， + 并确定你了解所有的后果。 同时， 请确定你有最新且可读的资料备份！</para> </warning> <sect2> - <title>ʼ</title> + <title>初始化储存库</title> - <para>ҪǽһµĴ⣬ ִ - <application>CVS</application> ʼ</para> + <para>首先要做的是建立一个新的储存库， 执行下列命令告诉 + <application>CVS</application> 建立并初始化：</para> <screen>&prompt.user; <userinput>cvs -d path-to-repository init</userinput></screen> - <para> <application>CVS</application> - <filename>CVSROOT</filename> Ŀ¼ - Ŀ¼еļ</para> + <para>这命令告诉 <application>CVS</application> 建立 + <filename>CVSROOT</filename> 的目录， + 这个目录里放置了所有的配置文件。</para> </sect2> <sect2> - <title>ôû</title> + <title>配置储存库的用户组</title> - <para>ǽһӵиôû飬 - еĿ߱û飬 Dzܹȡô⡣ - Ǽû FreeBSD ڲõ - <literal>ncvs</literal></para> + <para>现在我们将建立一个拥有该储存库的用户组， + 所有的开发者必须加入这个用户组， 这样他们才能够存取该储存库。 + 我们假设用户组名称是以 FreeBSD 内部所采用的 + <literal>ncvs</literal>。</para> <screen>&prompt.root; <userinput>pw groupadd ncvs</userinput></screen> - <para>Ҫʹ &man.chown.8; Ŀ¼ָոû飺</para> + <para>接着你需要使用 &man.chown.8; 将目录所有者指定给刚刚新增的用户组：</para> <screen>&prompt.root; <userinput>chown -R :ncvs path-to-your-repository</userinput></screen> - <para>һ ûʵûɵû Ͳܹдô⡣</para> + <para>如此一来， 没有适当的用户组许可的用户， 就不再能够写入该储存库。</para> </sect2> <sect2> - <title>ȡԴļ</title> + <title>取回源文件</title> - <para>Ҫ FreeBSD ȡ <filename>CVSROOT</filename> Ŀ¼ - FreeBSD CVS վȡػķ <link xlink:href="&url.books.handbook;/anoncvs.html"> ʹֲ е½</link> - øϢ ǼȡصļͬĿ¼µ - <filename>CVSROOT-freebsd</filename> Ŀ¼С</para> + <para>现在你需要从 FreeBSD 储存库中取回 <filename>CVSROOT</filename> 目录， + 从 FreeBSD 匿名的 CVS 镜像站来取回会是最简单的方法。请查阅 <link xlink:href="&url.books.handbook;/anoncvs.html">在 使用手册 中的相关章节</link> + 来获得更多信息。 我们假设取回的文件存放在相同目录下的 + <filename>CVSROOT-freebsd</filename> 目录中。</para> </sect2> <sect2> - <title> FreeBSD ű</title> + <title>复制 FreeBSD 的命令脚本</title> - <para>Ҫ FreeBSD <filename>CVSROOT</filename> - ļĴС Ϥ <application>CVS</application> - Ҳֱӻ (import) Щű - Ӷδ°ʱа汾ͬ ʵ - <application>CVS</application> ȱ㣺 ļ - <filename>CVSROOT</filename> ʱ ļ - ΪҪϳЩļ 㻹ҪڻǺһһύ ʧȥ - <literal>cvs import</literal> ļֵ ˣ ƼķֱӽЩűƹȥ</para> - - <para>˽ЩҲûйϵ — ΪĽһġ - Ȼ (checkout) <filename>CVSROOT</filename> - ȻƸոȡص FreeBSD ļصĿ¼Уδ䶯</para> + <para>接下来我们要复制 FreeBSD <filename>CVSROOT</filename> + 里的文件到你的储存库中。 如果你熟悉 <application>CVS</application>， + 你也许会想你可以直接汇入 (import) 这些命令脚本， + 从而更容易地在未来有新版时进行版本同步； 不过，事实是 + <application>CVS</application> 在这个部份有缺点： 当汇入文件到 + <filename>CVSROOT</filename> 时， 它并不会更新配置文件。 + 为了要认出这些文件， 你还需要在汇入它们后一一重新提交， 这就失去了 + <literal>cvs import</literal> 的价值。 因此， 推荐的方法是直接将这些命令脚本复制过去。</para> + + <para>如果您不了解这些操作也没有关系 — 因为最后的结果都是一样的。 + 首先汇出 (checkout) 你的 <filename>CVSROOT</filename>， + 然后复制刚刚取回的 FreeBSD 文件到本地的目录中（尚未变动过）：</para> <screen>&prompt.user; <userinput>cvs -d path-to-your-repository checkout CVSROOT</userinput> &prompt.user; <userinput>cd CVSROOT</userinput> &prompt.user; <userinput>cp ../CVSROOT-freebsd/* .</userinput> &prompt.user; <userinput>cvs add *</userinput></screen> - <para>ע⣺ ܻܿõһιijЩĿ¼ûбƵľ棬ģ - 㲢ҪõЩĿ¼</para> + <para>注意： 你很可能会得到一段关于某些目录没有被复制的警告，这是正常的， + 你并不需要用到这些目录。</para> </sect2> <sect2> - <title>ű˵</title> + <title>命令脚本说明</title> - <para>ĹĿ¼ FreeBSD ĿǵĴʹõűĸ - ÿļĽܡ</para> + <para>现在你的工作目录中有了完整 FreeBSD 项目在他们的储存库中使用的命令脚本的副本， + 以下是每个文件简单的介绍。</para> <itemizedlist> <listitem> - <para><filename>access</filename> - ļԤİװûбõ - <link linkend="freebsdspecific">FreeBSD ר</link> - ƴĴȡġ 㲻ϣʹõĻ - ɾļ</para> + <para><filename>access</filename> - 此文件在预设的安装中没有被用到。 + 它是在 <link linkend="freebsdspecific">FreeBSD 的专用配置</link> + 中用来控制储存库的存取的。 如果你不希望使用这个配置的话， + 则可以删除这个文件。</para> </listitem> <listitem> - <para><filename>avail</filename> - ļƴĴȡ - ڴļָȡû飬 - ҲĿ¼ļܾύ - ӦõΪĴнûĿ¼</para> + <para><filename>avail</filename> - 此文件控制储存库的存取。 + 在此文件中你可以指定允许存取储存库的用户组， + 也可以针对目录或文件来拒绝提交。 + 你应该调整为在你的储存库中将包含的用户组和目录。</para> </listitem> <listitem> - <para><filename>cfg.pm</filename> - ļ˵ݣṩԤá - <emphasis></emphasis> ӦĴļ Ӧĵ÷ŵ - <filename>cfg_local.pm</filename></para> + <para><filename>cfg.pm</filename> - 此文件说明了配置内容，并提供预设的配置。 + 你 <emphasis>不</emphasis> 应修改此文件， 而应将修改的配置放到 + <filename>cfg_local.pm</filename>。</para> </listitem> <listitem> - <para><filename>cfg_local.pm</filename> - ļеϵͳֵ - Ӧڴ˵ã ύʼҪĵġ - Щϵʹ߿ύȵȡ ϢԺᵽ</para> + <para><filename>cfg_local.pm</filename> - 此文件包含所有的系统配置值。 + 你应该配置所有列在此的配置， 例如提交的邮件要寄到哪、 + 在哪些主机上的使用者可以提交等等。 更多的相关信息在稍后会提到。</para> </listitem> *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201311140020.rAE0KqHZ062339>