兄弟们有没有兴趣翻译一下ArchWiKi上的文档？

xiaoma

Downgrade packages
Q: 我正在运行pacman -Syu，XYZ包已从M版升级到了N版。在我的计算机上，新版的包不能正常工作。我如何将此包降回老的M版呢？
A: 现在pacman还不支持降级某个包。你只能安装最新的包。这是Arch的滚动升级系统的影响之一。

你可以仔细检查/var/cache/pacman/pkg目录，看看老版本的包是否还在那儿（如果你最近没有运行pacman -Scc话，应该还在）。如果老版本的包在，你可以这样安装：pacman -U pkgname-olderpkgver.pkg.tar.gz
你还可以从下面的链接中查找老版本的包：
ftp://ftp.tu-chemnitz.de/pub/lin ... ributions/archlinux

如果老版本的包不在了，你可能需要自己编译了。这样你可能需要相应的PKGBUILD文件。你可以自己修改ABS提供的PKGBUILD文件（译注：在/arv/abs目录中找找），也可以访问http://www.archlinux.org/packages.php，搜索你要降级的包。如果找到，点击"View CVS entries"，选择你要的老版本的diff。如果你选的是"side by side"的diff，你可以拷贝＆粘贴整个PKGBUILD，然后makepkg。参见 ABS - the Arch Build System（已译）。

xiaoma

Faster Compiling with Makepkg
这儿有一个奇妙的gcc工具，叫做ccache。你可以在这儿访问它的主页http://ccache.samba.org。
如果你经常一遍一遍地编译相同的程序——比如，尝试不同的kernel补丁，或者测试你自己开发的程序——那么，对你来说，ccache就太完美了。它将在第一遍编译时多花几秒钟，但接下来就会快得多得多。很明显，它不是适合每个人的。
不管怎样，Arch软件包的Extra库中也有ccache了。
        pacman -S ccache
现在，加速编译C代码，使用"ccache gcc"或"ccache g++"代替"gcc"或"g++" 你也可以配置makepkg使用ccache，只需在你的/etc/makepkg.conf中加入下面几行：
        export CC="ccache gcc"
        export CPP="ccache cpp"
        export CXX="ccache g++"
享受快速编译的乐趣吧！

xiaoma

Getting Testing PKGBUILDs
测试用的包有点特殊，它并不像其他软件包那样是一个CVS软件包库。它仅仅是个标记，可以被用在任何官方软件库中。那么，在我使ABS能够聪明地检测测试包之前，你可以按如下方法手工去做：
1.建立/etc/abs/supfile.testing文件

        *default host=cvs.archlinux.org

        *default release=cvs
        *default delete
        *default use-rel-suffix
        *default compress
        *default tag=TESTING

        arch
        extra

2.手动运行cvsup：

        # mkdir /var/abs/testing
        # cd /var/abs/testing
        # cvsup -L 1 -r 0 -g -b /var/abs/testing -c .sup /etc/abs/supfile.testing

这就可以了（感谢Apeiro）

xiaoma

Local repository HOW-TO
本文概述了如何通过LAN共享Arch Linux的软件包。更好的办法是使用ABS和gensync建立本地软件包库（http://wiki.archlinux.org/index. ... ABS%20and%20gensync，此文已译），在LAN通过NFS或FTP访问。本文将详细介绍这一过程。原来的HOWO（译注：疑为HOWTO）将暂存在下面。

在局域网内共享你下载的软件包，以节约带宽、磁盘空间和时间。
"pacman -Sy"将同步本地软件库
"pacman -S pkgname"将试图在本地服务器上下载软件包，并安装软件。如果软件包不存在，它将从/etc/pacman.conf文件的服务器列表中选择下一个服务器，下载软件包并存储在本地服务器上。
"alsync"将根据ftp.archlinux.org升级本地服务器的数据。

例子：我的网络
serverip=192.168.14.3
network=192.168.14.0/255.255.255.0
根据你的情况调整一下。


1. 服务端
在服务器上建立NFS共享，并给予所有LAN上的用户以读写权限。
如果服务器上运行的是archlinux，你可以这样做：

        pacman -S portmap
        pacman -S nfs-utils

编辑/etc/exports
加入

        /var/cache/pacman/pkg  192.168.14.0/255.255.255.0(rw,no_root_squash,sync)

并在/etc/rc.conf文件的DAEMONS中加入portmap，nfslock和nfsd

        /etc/rc.d/portmap start
        /etc/rc.d/nfslock start
        /etc/rc.d/nfsd start
运行"exportfs"检查NFS。

2. 所有的客户端
将/var/cache/pacman/pkg改名为/var/cache/pacman/pkgorg
建立新的/var/cache/pacman/pkg，并将NFS共享挂到这儿。

        mount -o rw,nolock 192.168.14.3:/var/cache/pacman/pkg /var/cache/pacman/pkg

如果你希望在客户端重启时自动挂载，请将下行加入/etc/fstab
        192.168.14.3:/var/cache/pacman/pkg /var/cache/pacman/pkg    nfs    rw,nolock
运行"mount -a"，运行"df"检查挂载情况。
删除客户端上已下载的所有软件包，并将/var/cache/pacman/pkgorg改名为/var/cache/pacman/pkg（又改回来）

编辑/etc/pacman.conf，如下：

{current}
Server = file:///var/cache/pacman/pkg

     ** and after **
{extra}
Server = file:///var/cache/pacman/pkg

3. 将本地软件包库与官方同步
"alsync"将连接、登录并更新本地的NFS软件包数据库

        pacman -S openssl
        pacman -S wget
建立/bin/alsync并加入以下几行：
***** content of alsync *********************
cd /var/cache/pacman/pkg
wget -N ftp://ftp.archlinux.org/current/*.db.*
wget -N ftp://ftp.archlinux.org/extra/*.db.*
********* end ******************************
然后，改变权限
        chmod 777 /bin/alsync
并将此文件拷贝到所有客户端

在第一个客户端上以root身份登录，并运行：
        alsync
        pacman -Sy
        pacman -S new-pkgname
在第二个客户端上运行：
        pacman -Sy
        pacman -S new-pkgname

xiaoma

Making a custom package cd
如果你想通过CD光盘，从一台Arch linux计算机上拷贝一些软件包到另一台（例如，Internet连接很慢），那么按下面的方法去做吧：
1.按照Custom local repository with ABS and gensync（已译）上的方法建立软件包库。从已升过级的系统的/var/cache/pacman/pkg目录中拷贝软件包。
2.将软件包库制成iso文件，并刻入CD-R或CD-RW盘中。
3.将此光盘挂到第二台Arch Linux机器上。
4.在/etc/pacman.conf中加入自制的软件包库的位置:
        [mycd]
        Server = file:///mnt/cd/pkg
另一种选择就是将CD中的文件直接拷入第二台机子的/var/cache/pacman/pkg目录中。如果文件都是最新的话，pacman就直接从这儿取得软件包，而不是从网上下载了。
另一种办法就是自制一个安装光盘，详见http://bbs.archlinux.org/viewtopic.php?t=1387。

xiaoma

Patching in ABS Howto
有相当多的关于使用ABS时，如何自己制作软件包的补丁及如何使用补丁的问题。本文将大致讲述其步骤及必要的条件。http://www.kegel.com/academy/opensource.html也有很多关于补丁文件的信息。


制作补丁

如果你正在使用从别处得到的补丁（比如，下载的kernel补丁），你可以跳过本节，直接阅读下一节。但如果你想编辑源代码、makefile、配置文件等，你可能会需要制作补丁。
注意：如果你仅仅需要改动一个文件的一两行（比如，一个makefile），或许你更应该研究一下sed。
制作软件包的补丁牵涉到建立两个版本的软件包，编辑新包并就两个文件建立标准的diff。当建立软件包时，可按以下方法来进行：
1.将下载的源文件名加入你要建立的PKGBUILD文件的source列表中。当然，如果你是修改一个软件包，得仔细一点。
2.建立一个空的build函数（只有一行echo的最好）。如果你在修改PKGBUILD文件，最好注释掉build函数中的一些语句。因为可能要运行makepkg好几次，你可能不想花时间去建一个没用的包。
3.运行makepkg，这将会下载你将在src目录中修改的源代码。
4.进入src目录。正常情况下，这儿已生成一个包含已解压文件的目录（有时会只有一个文件，但diff仍旧可以工作）。你应该为这些目录做两个备份——一个用来备份，别碰它；另一个用来生成新版本的包，并以此来做补丁。你可以分别为这两份拷贝命名为package.pristine和package.new或是其他类似的名称。
5.进入package.new目录，编辑需改动的文件。如何改动取决于补丁的制作，可能是纠正Makefile的路径，可能是改正源码中的错误（例如，gcc 3.4）等等。你也可以修改package.new的子目录中的文件。不要执行会在package.new目录中建立一堆新文件的命令，也就是说，不要为了确认你的修改而编译程序。问题在于，所有的新文件都将被包含在补丁中，显然，你要的并不是这个。应该将补丁应用在另一个目录中（不是备份的package.pristine），或者手动为其打上补丁，也可以在PKGBUILD中实现打补丁，并在这个目录中测试。
6.回到src目录。
7.运行diff -aur package.pristine package.new。这将以标准的diff格式输出你所做的修改。你可以检查以确信补丁的正确。
8.运行diff -aur package.pristine package.new > package.patch，将所有的改变输出到名为package.patch的文件中。这就是我们要的补丁文件。你现在就可以将这些改变应用到原目录中去，以证实其可以完好地运行。你还应该检查，以确信补丁中没有包含任何无关的信息。例如，你不希望补丁将文件中的所有的tab转换成空格，但你的文本编辑在幕后这么做了。你可以用文本编辑器来编辑补丁文件，或者，更安全一点，编辑源文件，重新生成补丁（不会偶然地将错误带入补丁文件）。


应用补丁

本节将概述如何在PKGBUILD文件中的build函数中应用自己制作的或下载的补丁文件。步骤如下：
1.在PKGBUILD文件的source列表中加入补丁文件名。如果补丁文件可以下载，你可以将其URL加入其中，它会被自动下载并放入src目录。如果是你自己制作的补丁，或者无处可下，你应该将补丁文件与PKGBUILD文件放在同一目录中，并直接将补丁文件名放在source列表中。如果你发布了PKGBUILD文件，你应该同时发布补丁文件。
2.建立PKGBUILD文件中的build函数。大多数情况下，第一件事就是打补丁，但你应该知道何时打补丁是最合适的。
3.第一步是进入需打补丁的目录（这是在build函数中，而不是在你的终端里！你要的是自动打上补丁）。你可以像这样进入目录cd $startdir/src/$pkgname-$pkgver或使用类似的命令。$pkgname-$pkgver通常就是下载的源文件解压后的目录名，但并不总是这样。
4.现在，你只才有可能在此目录中简单地应用补丁就可以了。非常简单，在build函数中加入patch -p1 -i ../pkgname.patch就可以了，将pkgname.patch用包含diff的文件名代替（因为这个文件的名字出现在PKGBUILD文件的source列表中，它将被自动拷入src目录）。
5.运行makepkg（这回是在终端里了）。如果一切顺利，补丁就自动打上了，你的新包也会包含你所修改的部分了。如果有问题，你就要试试patch命令的-p选项了，具体可以看一看patch的手册页。


一般地，一切将如下所述。如果diff文件是用来为myversion/目录下的filey文件打补丁的，那么diff文件就会作用于myversion/file。你会在yourversion/目录中运行（因为在PKGBUILD中已进入此目录了），所以当打完补丁后，你希望它作用于file文件，忽略myversion/部分。-p1选项会这么做，从路径中拿掉一个目录。不管怎样，如果开发者为myfiles/myversion打补丁，你就需要忽略两个目录，那么就使用-p2选项。
如果你没有使用-p选项，它将忽略所有目录结构。如果所有文件都在一个目录的话，一切OK。但是，当补丁是基于myversion/目录建立的，并且有一个修改后的文件为myversion/src/file，如果你在yourversion目录中运行不带-p选项的patch命令，它将试图为yourversion/file打补丁。
大多数开发者是从需打补丁的父目录制作补丁文件，所以通常情况下，使用-p1就对了。

xiaoma

The Arch package making HOW-TO - with guidelines
ABS - the Arch Build System（已译）这篇文章是一篇很好的关于建立或修改Arch Linux软件包所需的工具和文件的概述。如果你想自己建立或重新编译软件包，这差不多就是你所需知道的一切了。但无论如何，如果你想自己建立一个新的软件包，这儿还有一些额外的指导方针你需要知道。本文假设你已读过并理解了ABS的相关描述。
你将建立一个软件包所需的所有信息保存在PKGBUILD文件中。当你运行makepkg时，它将在当前工作目录中查找PKGBUILD文件，根据其中的指令编译软件。在成功完成编译后，二进制文件及一些信息，如包的版本、依赖关系等都被压缩存放在名如name.pkg.tar.gz的软件包中。这个包可以用pacman -Up <package file>来干净地安装。
PKGBUILD文件包含了建立软件包所需的全部指令，从形式上说，BASH可以直接解释这些指令（别担心，这些小线索有用）。这些变量的含义已在ABS - the Arch Build System一文中解释过了，但更重要的、易混淆的将在此再次说明。在建立新的软件包之前，你需要建立一个空的工作目录，建议这样命名：/var/abs/local/<KGNAME>。这样可以完美地融入标准ABS树，但又不会在你同步ABS树被CVSUP所改动。进入此目录，并建立一个PKGBUILD文件——或者从/var/abs/PKGBUILD.proto拷贝一个模板，或者从其他包中拷贝该文件。当你只是想修改、补充几个选项而不是建立一个全新的文件时，后者显然有用得多。不管怎样，现在你需要一个PKGBUILD文件。
现在，打开这个文件，根据你要建立的包设置这些变量的值：

pkgname
        将此变量设置成软件包的名称。不能包含连字符，即“-”，但你可以用下划线代替。习惯上都是用小写字母来命名。并不强求如此，但这样做有好处。软件包的名称与你的工作目录名相同，并且与你要下载的包含的软件源代码的tar.gz文件名也相同。
pkgver
        将此变量设置成软件包的版本。可以包括字母、数字及句点。它依赖于你要打包的软件的版本体系（major.minor.bugfix, major.date等）。而且你应该紧跟其源码文件包中的版本号，以使下一步工作更轻松且更灵活。
pkgrel
        此变量初始值应为1，且随每次发布软件包而递增。目的是为了区分连续发布的同版本的软件包。有时，第一次发布的软件包有问题或缺少某一功能，当你做好第二个发布版时，你应该将pkgrel加1，这样，pacman就知道需要重新安装此包。当新版本（不是发布号）的软件包发布时，你应该将pkgrel重新设为1。
depends
        此变量通常包含一组以空格分开的软件包名，在安装该包之前，应先安装这一组软件包。软件包名也可以放在单引号里，以避免可能产生的shell引用问题。而这一组软件包名应以圆括号括起来。有的程序需要“最低版本支持”，如果那样的话，你应该想使用数学符号“大于或等于”，并将整个条件用引号引起来。举个例子，该包需要glibc包，而且slang库不能低于1.8.0版：depends=('glibc' 'slang>=1.8.0')
source
        此变量应包括一组建立软件包所需的文件名，并且至少包含软件源代码的位置——很多都是用双引号引起来的完整的HTTP或FTP定位。PKGBUILD文件的模板显示了如何有效使用先前定义的pkgname、pkgver。如果你需要的文件不能从网上下载，例如，自己做的patch，你可以将这些文件放入PKGBUILD所在目录，然后在此处加上文件名即可。所有加在这儿的路径都是相对路径——相对于PKGBUILD的所在目录。在正式建立软件包之前，这儿所提到的文件都要被下载下来或检查是否存在，如果有任何一个文件不存在，makepkg是不会进行处理的。
md5sums
        一组源文件的md5校验和——放在引号内，以空格分开。所有source中的文件，其md5 hash值将自动生成并与该组中的值相比较，顺序与source中的一样。源文件本身的顺序并不重要，重要的是其md5sums的顺序——makepkg并不会去猜哪个md5sum是哪个源文件的，当出现不符量，它只会给出错误信息。在source设好后，在PKGBULID所在的目录中，你可以很轻松地用makepkg -g产生这一组md5sum。makepkg -g >> PKGBUILD会将产生的md5sums追加在PKGBUILD文件末尾，你可以将最后的几行移动到文件的适当位置。

现在，你已设好了软件的一些信息——哪儿能下到源文件，包的名称是什么等等。下一步就是如何写出指令去编译、安装你想要打包的程序。一般来讲，在你开始自动打包处理之前，你至少要手动做一次，除非，你很清楚在此之前你所做的一切。但不管怎样你都应该首先说读读这个。很不幸的是，尽管很多程序都可以以“三步曲”——"./configure; make; make install"来安装，但这不是万能的。如果你必须要打补丁才能使之正常工作的话，你的包将变得很丑陋。单凭经验的方法：如果你不能从源码编译程序并将其安装到一个指定的临时子目录下的话，就别去尝试打包了。makepkg中没有能帮你解决源码问题的魔法小精灵。

也就是说，你应该下载源码包，解压，记下所有有关编译、安装的命令。PKGBUILD文件中的build函数将精确地重复这一步骤，并在编译完成后将一切捆在一起。

现在你可能需要编辑build函数。其实，它用的只是普通的shell命令——遵循bash语法。该函数的基本目的就是自动编译好程序，并且将其安装到新建的软件包目录，使makepkg可以轻松地打包，而不是要将所需的文件从你的系统中一个一个地找出来。

一般来说，build函数的第一步就是进入源文件解压后生成的目录。你可以使用$startdir——它代表PKGBUILD所在的目录。你也可以使用之前设置的$pkgname和$pkgver变量。例如，根据makepkg解压生成的目录，build函数的第一个命令可能就是cd $startdir/src/$pkgname-$pkgver，通常都会是这样，除非程序的作者是一个非常非常古怪的人。

编译程序就比较难一点了。我想，你应该设法手工编译。因为你不大可能将所有可能需要的步骤都包括进来。这就是希望程序的作者写README和INSTALL文件的原因。

现在，你就在这个目录中，你需要给出命令以编译程序。简单时，你只要使用./configure; make，尽管有很多变化——包括ant build或具体的编译软件的gcc命令。简单地说，软件可能不是以源码形式发布，而你必须用sh installer.run的形式运行。你可能需要多研究一下（读README，INSTALL，手册页，可能还要看一看如gentoo的ebuilds，甚至是MAKEFILE或源代码），使其可以正常使用。在某些极端情况下，你可能要修改源代码才能使之正常工作。不管怎样，makepkg需要完全独立地工作——不需要用户的输入。因此，如果你需要编辑Makefile，你应该自己做一个patch，并写在build函数中。或者你必须在build函数中加上sed命令。

好的一面就是，如果你已手动编译了整个软件，你只需将你所用的命令列下来就OK了。由于很多软件倾向于安装在/usr/local中，但Archlinux习惯上将软件安装在/usr中，你应该传递相应参数至configure或make命令，仔细一点。PKGBUILD的模板提供了这样的一个例子。 这可能与你的实际情况有点差异，但不管怎样，你还有一些工作要做。

build函数的下一步工作就是将已编译好的文件放在一个目录中，以方便makepkg将他们打包。这个目录就是pkg目录，它将被软件的安装进程当成你的系统的根目录。所有将被安装进你的系统的根目录的文件，实际上都会安装在pkg目录中的相同的目录结构中（也就是说，你如果要将myprog这个文件安装到/usr/bin中，它实际上是被安装到$startdir/pkg/usr/bin）。幸运的是，只有一小部分软件需要用户手工拷贝大量文件，但他们也提供某些安装程序来自动完成这一工作——通常都是通过调用"make install"来实现。这很危险，但不管怎样，你会发现如何告知安装进程不要将文件安装到系统的根目录，而是安装到$startdir/pkg。否则，你将发现，最终你得到的只是一空的软件包，而你所要打包的文件已“正确地”安装到了你的系统中。很多时候，你都必须像模板文件中那样在调用"make install"时，加上prefix参数。但这也很可能使程序以完全不同的途径来打包，下面还有一些提示：

a.有时，configure脚本接受prefix参数——用来告知将文件安装在何处。例如，你会看到这样的配置：./configure --prefix=$startdir/pkg/usr。
b.有时，可以传递PREFIX选项给make install命令。这种情况下，有时是设置变量，有时是嵌入命令中。更糟的是，你可能必须编辑Makefile（如果软件使用ant的话，就要编辑ant build/properties）。可以使用sed或自己制作补丁。
c.可能也有允许指定安装目录的安装脚本存在。
d.还有一些软件是可以在单独一个目录中运行的。这时只需将其简单地拷入$startdir/pkg/opt即可。

就像你可能猜想的那样，你所知道的与你的经验是必不可少的。特别是在你浏览ABS树内的PKGBUILD文件时，这些知识与经验会很用的，因为有些文件是测试用的，其中可能包括一些有用的小窍门或是恶作剧。

安装程序时常会很小心地在pkg目录下建立子目录，如果它没有建立相应的子目录，你就会在安装过程中收到许多诸如文件拷贝到不存在的子目录中的错误信息。如果那样的话，在运行安装程序之前，你应该在build函数中加入相应的mkdir命令。实际的目录结构是和软件包相关的，有些程序需要将文件拷入/etc或/usr，有些可能需要使用/bin或/opt。大多数的软件需要建立数个目录，你可以使用mkdir -p $startdir/pkg/OTHER/DIRS/AS/NEEDED，“OTHER/DIRS/AS/NEEDED”代表系统根目录下的目录结构。

当你开始写PKGBUILD文件中的build函数时，你需要不停地测试以排除bug。你可以在PKGBUILD所在的目录中运行makepkg来测试。通过一个适当格式的PKGBUILD，很容易就可以创建一个软件包。但如果使用坏掉的或未完成的，这将导致错误。希望这仅仅是个描述性的错误！

如果makepkg成功运行完成，它将在你的工作目录中产生一个新得有点闪闪发亮的名为$pkgname-$pkgver.pkg.tar.gz文件。这是一个pacman可安装的软件包，可以通过pacman -U 或pacman -A 来安装或更新，也可以加入到本地或远程的软件包库中。注意，这只意味着软件包已建立，并不意味着它一定可用！如果你不恰当地使用了prefix参数，包中可能只包含目录结构而没有一个文件！你可以使用pacman的查询功能，显示出其中包含的文件清单及其依赖关系，并可与你认为正确的相比较。"pacman -Qlp <package file>"和"pacman -Qip <package file>"可以完成这个工作。

如果包看起来很正常，那就是你所要做的。不管怎样，如果你决定发布软件包或PKGBUILD，你应该强制你自己检查、再检查、再再检查其内容及依赖关系。检查时，应列出所有你的软件包所依赖的包的列表。但depends中只需列出第一层依赖关系即可。这就是说你不必在软件包把所有依赖的包都列进去。如果你的软件所依赖的包中已列出了它所依赖的包——尽管这个包你也需要，但你不必在你的软件包中列出来。

例如，gtk2依赖于glib2。列出所有需要的开源C程序，你会发现，gtk2出需要glibc。但glibc不必出现在gtk2的依赖包的名单中，因为glibc是glib2的依赖包，而glib2已经列在gtk2的依赖包的名单中了。

有很多工具可用来检查依赖关系，其中就包括Jason Chu的大名鼎鼎的namcap（在线安装：pacman -Sy namcap），还有神秘的ldd。读一读这些程序的手册页及本文结尾处的链接。你应该通读程序的文档及其WEB页（仔细的开发者会提供“dependencies”说明，这会很有帮助的）。

同时也要保证软件包可以完美地运行！发布一个包含所有必需文件的包，但因为其中隐蔽的选项不能很好地工作，这确实是一件令人恼火的事！但如果你只是自编自用，你完全不必太过担心质量保证这一步，因为只有你一个需要忍受其中的错误。

总结：
   1. 下载你想打包的程序的源码
   2. 尝试将其安装到指定的目录
   3. 将/var/abs/PKGBUILD.proto拷入临时工作目录并改名为PKGBUILD
   4. 根据你的需要编辑PKGBUILD
   5. 运行makepkg，并检查生成的包是否正确
   6. 如果软件包有问题，重复最后两步

更多信息参见以下链接：
# makepkg man page(http://www.archlinux.org/pacman/makepkg.8.html)
# guidelines(http://www.archlinux.org/docs/en ... l-guide.html#SEC5.4)
# link in the faq(http://www.archlinux.org/docs/en ... 0062000000000000000)
# about dependencies(http://bbs.archlinux.org/viewtopic.php?t=4)
# makepkg tutorial(http://bbs.archlinux.org/viewtopic.php?t=1590)
# ABS - the Arch Build System(http://wiki.archlinux.org/index. ... ch%20Build%20System)

ygw_ycf

最新的文档已不需要建立sound用户组了，已建立了一个audio， 把用户加入audio组即可。