doc/index.txt

   1 Pacman Home Page
   2 ================
   3
   4 A simple library-based package manager.
   5
   6 Introduction
   7 ------------
   8 pacman is a utility which manages software packages in Linux. It uses simple
   9 compressed files as a package format, and maintains a text-based package
  10 database (more of a hierarchy), just in case some hand tweaking is necessary.
  11
  12 pacman does not strive to "do everything." It will add, remove and upgrade
  13 packages in the system, and it will allow you to query the package database for
  14 installed packages, files and owners. It also attempts to handle dependencies
  15 automatically and can download packages from a remote server.
  16
  17 History
  18 ~~~~~~~
  19 Version 2.0 of pacman introduced the ability to sync packages (the '\--sync'
  20 option) with a master server through the use of package databases. Prior to
  21 this, packages would have to be installed manually using the '\--add' and
  22 '\--upgrade' operations.
  23
  24 Version 3.0 was the switch to a two-part pacman- a backend named libalpm
  25 (library for Arch Linux Package Management), and the familiar pacman frontend.
  26 Speed in many cases was improved, along with dependency and conflict resolution
  27 being able to handle a much wider variety of cases. The switch to a
  28 library-based program should also make it easier in the future to develop
  29 alternative front ends.
  30
  31 Version 4.0 added package signing and verification capabilities to the entire
  32 makepkg/repo-add/pacman toolchain via GNUPG and GPGME.
  33
  34 Documentation
  35 -------------
  36
  37 Manpages
  38 ~~~~~~~~
  39 There are several manpages available for the programs, utilities, and
  40 configuration files dealing with pacman.
  41
  42 * linkman:PKGBUILD[5]
  43 * linkman:libalpm[3]
  44 * linkman:makepkg[8]
  45 * linkman:makepkg.conf[5]
  46 * linkman:pacman[8]
  47 * linkman:pacman-key[8]
  48 * linkman:pacman.conf[5]
  49 * linkman:pkgdelta[8]
  50 * linkman:repo-add[8]
  51 * linkman:vercmp[8]
  52
  53 Changelog
  54 ~~~~~~~~~
  55 For a good idea of what is going on in pacman development, take a look at the
  56 link:http://projects.archlinux.org/pacman.git/[Git summary page] for the
  57 project.
  58
  59 See the most recent
  60 link:http://projects.archlinux.org/pacman.git/tree/NEWS[NEWS]
  61 file for a not-as-frequently-updated list of changes. However, this should
  62 contain the biggest changes in a format more concise than the commit log.
  63
  64
  65 Releases
  66 --------
  67
  68 [frame="none",grid="none",options="autowidth",cols="3*a"]
  69 |======
  70 |
  71 [frame="topbot",grid="none",options="header,autowidth"]
  72 !======
  73 !Version !Date
  74 !4.0.3 !2011-04-07
  75 !4.0.2 !2011-02-11
  76 !4.0.1 !2011-11-20
  77 !4.0.0 !2011-10-13
  78 !4.0.0rc2 !2011-09-22
  79 !4.0.0rc1 !2011-08-11
  80 !3.5.4 !2011-08-10
  81 !3.5.3 !2011-06-07
  82 !3.5.2 !2011-04-18
  83 !3.5.1 !2011-03-23
  84 !3.5.0 !2011-03-16
  85 !3.4.3 !2011-01-22
  86 !3.4.2 !2010-12-29
  87 !3.4.1 !2010-09-03
  88 !3.4.0 !2010-06-16
  89 !3.3.3 !2009-11-10
  90 !3.3.2 !2009-10-05
  91 !3.3.1 !2009-09-22
  92 !3.3.0 !2009-08-02
  93 !3.2.2 !2009-01-05
  94 !3.2.1 !2008-08-26
  95 !3.2.0 !2008-07-30
  96 !3.1.4 !2008-04-01
  97 !3.1.3 !2008-03-06
  98 !3.1.2 !2008-02-20
  99 !3.1.1 !2008-01-20
 100 !======
 101 |
 102 [frame="topbot",grid="none",options="header,autowidth"]
 103 !======
 104 !Version !Date
 105 !3.1.0 !2008-01-09
 106 !3.0.6 !2007-09-16
 107 !3.0.5 !2007-06-17
 108 !3.0.4 !2007-05-08
 109 !3.0.3 !2007-04-28
 110 !3.0.2 !2007-04-23
 111 !3.0.1 !2007-04-04
 112 !3.0.0 !2007-03-25
 113 !2.9.8 !2006-02-02
 114 !2.9.7 !2005-09-16
 115 !2.9.7-TEST3 !2005-09-11
 116 !2.9.7-TEST2 !2005-09-07
 117 !2.9.7-TEST !2005-08-19
 118 !2.9.6 !2005-06-10
 119 !2.9.5 !2005-01-11
 120 !2.9.4 !2004-12-20
 121 !2.9.3 !2004-12-19
 122 !2.9.2 !2004-09-25
 123 !2.9.1 !2004-09-25
 124 !2.9 !2004-09-18
 125 !2.8.4 !2004-08-23
 126 !2.8.3 !2004-08-04
 127 !2.8.2 !2004-07-22
 128 !2.8.1 !2004-07-17
 129 !2.8 !2004-07-03
 130 !2.7.9 !2004-04-30
 131 !2.7.8 !2004-04-29
 132 !2.7.7 !2004-04-15
 133 !======
 134 |
 135 [frame="topbot",grid="none",options="header,autowidth"]
 136 !======
 137 !Version !Date
 138 !2.7.6 !2004-04-04
 139 !2.7.5 !2004-03-02
 140 !2.7.4 !2004-02-18
 141 !2.7.3 !2004-02-07
 142 !2.7.2 !2004-01-04
 143 !2.7.1 !2003-12-21
 144 !2.7 !2003-11-25
 145 !2.6.4 !2003-10-17
 146 !2.6.3 !2003-10-01
 147 !2.6.2 !2003-09-29
 148 !2.6.1 !2003-09-15
 149 !2.6 !2003-09-03
 150 !2.5.1 !2003-07-12
 151 !2.5 !2003-05-30
 152 !2.4.1 !2003-04-19
 153 !2.4 !2003-04-11
 154 !2.3.2 !2003-03-17
 155 !2.3.1 !2003-03-14
 156 !2.3 !2003-02-27
 157 !2.2 !2002-12-11
 158 !2.1 !2002-09-16
 159 !2.0 !2002-08-09
 160 !1.23 !2002-04-30
 161 !1.22 !2002-04-12
 162 !1.21 !2002-04-03
 163 !1.2 !2002-03-18
 164 !1.1 !2002-03-10
 165 !1.0 !2002-02-25
 166 !======
 167
 168 |======
 169
 170 Source code for all releases is available at
 171 link:ftp://ftp.archlinux.org/other/pacman/[]. To install, download the newest
 172 available source tarball, unpack it in a directory, and run the three magic
 173 commands:
 174
 175         $ ./configure
 176         $ make
 177         # make install
 178
 179 You may wish to read the options presented by `./configure --help` in order to
 180 set appropriate paths and build options that are correct for your system.
 181
 182 Development
 183 -----------
 184
 185 Mailing List
 186 ~~~~~~~~~~~~
 187 There is a mailing list devoted to pacman development, hosted by Arch Linux.
 188 link:http://mailman.archlinux.org/mailman/listinfo/pacman-dev/[Subscribe] or
 189 link:http://mailman.archlinux.org/pipermail/pacman-dev/[view the archives].
 190
 191 Source Code
 192 ~~~~~~~~~~~
 193 Development of pacman is currently done in GIT. The central repository is
 194 hosted by Arch Linux, although some of the developers have their own trees (ask
 195 on the above mailing lists if you are interested in finding the locations of
 196 these trees).
 197
 198 The current development tree can be fetched with the following command:
 199
 200         git clone git://projects.archlinux.org/pacman.git pacman
 201
 202 which will fetch the full development history into a directory named pacman.
 203 You can browse the source as well using
 204 link:http://projects.archlinux.org/pacman.git/[cgit]. HTTP/HTTPS URLs are also
 205 available for cloning purposes; these URLs are listed at the above page.
 206
 207 If you are interested in hacking on pacman, it is highly recommended you join
 208 the mailing list mentioned above, as well as take a quick glance at our
 209 link:HACKING.html[HACKING] document.
 210 link:submitting-patches.html[submitting-patches] is also a recommended read.
 211
 212 Not as familiar with code as you'd like to be, but still want to help out? If
 213 you speak a foreign language, you can help by either creating or updating a
 214 translation file for your native language. Instructions can be found in
 215 link:translation-help.html[translation-help].
 216
 217 Other Utilities
 218 ~~~~~~~~~~~~~~~
 219 Although the package manager itself is quite simple, many scripts have been
 220 developed that help automate building and installing packages. These are used
 221 extensively in link:http://archlinux.org/[Arch Linux]. Most of these utilities
 222 are available in the Arch Linux projects
 223 link:http://projects.archlinux.org/[code browser].
 224
 225 Utilities available:
 226
 227 * link:http://projects.archlinux.org/abs.git/[abs] - ABS (Arch Build System), scripts to download  & use the Arch Linux PKGBUILD tree
 228 * link:http://projects.archlinux.org/dbscripts.git/[dbscripts] - scripts used by Arch Linux to manage the main package repositories
 229 * link:http://projects.archlinux.org/devtools.git/[devtools] - tools to assist in packaging and dependency checking
 230 * link:http://projects.archlinux.org/namcap.git/[namcap] - a package analysis utility written in python
 231 * link:http://projects.archlinux.org/srcpac.git/[srcpac] - a bash build-from-source pacman wrapper
 232
 233 Bugs
 234 ----
 235 If you find bugs (which is quite likely), please email them to the pacman-dev
 236 mailing last at mailto:pacman-dev@archlinux.org[] with specific information
 237 such as your commandline, the nature of the bug, and even the package database
 238 if it helps.
 239
 240 You can also post a bug to the Arch Linux bug tracker
 241 link:http://bugs.archlinux.org/index.php?project=3[Flyspray]. Be sure to file
 242 bugs under the Pacman project.
 243
 244 Pacman/libalpm in the Wild
 245 --------------------------
 246 Although Arch Linux is the primary user of pacman and libalpm, other
 247 distributions and projects also use pacman as a package management tool. In
 248 addition, there have been several projects started to provide a frontend GUI to
 249 pacman and/or libalpm.
 250
 251 Arch derivatives:
 252
 253 * link:http://archie.dotsrc.org/[Archie] - Arch Live on steroids
 254 * link:http://www.faunos.com/[FaunOS] - A portable, fully integrated operating system based on Arch Linux
 255 * link:http://larch.berlios.de/[larch] - A live CD/DVD/USB-stick construction kit for Arch Linux
 256
 257 Other distributions:
 258
 259 * link:http://www.delilinux.org/[DeLi Linux] - "Desktop Light" Linux, a Linux distribution for old computers
 260 * link:http://www.frugalware.org/[Frugalware Linux] - A general purpose Linux distribution for intermediate users (pacman is forked and maintained separately)
 261
 262 Pacman/libalpm frontends:
 263
 264 * link:http://shaman.iskrembilen.com/[Shaman] - A GUI frontend using Qt and libalpm
 265
 266 Copyright
 267 ---------
 268 pacman is Copyright (C) 2006-2012 Pacman Development Team
 269 <pacman-dev@archlinux.org> and Copyright (C) 2002-2006 Judd Vinet
 270 <jvinet@zeroflux.org> and is licensed through the GNU General Public License,
 271 version 2 or later.
 272
 273 /////
 274 vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
 275 /////