index : pacman | |
Archlinux32 fork of pacman | gitolite user |
summaryrefslogtreecommitdiff |
author | Aaron Griffin <aaron@archlinux.org> | 2006-10-27 21:09:14 +0000 |
---|---|---|
committer | Aaron Griffin <aaron@archlinux.org> | 2006-10-27 21:09:14 +0000 |
commit | 3e5401b74de0bc19f6eac48dd45c656a5c4e5ed7 (patch) | |
tree | a307cd915c8b53279e4a802d553837b89567ce63 /doc | |
parent | e8275fa9644181e9347e983f74b28f313103b888 (diff) |
diff --git a/doc/libalpm.3 b/doc/libalpm.3 deleted file mode 100644 index 52e4af0b..00000000 --- a/doc/libalpm.3 +++ /dev/null @@ -1,25 +0,0 @@ -.TH libalpm 3 "29 Jan 2006" "Frugalware Developer Manual" "" -.SH NAME -libalpm \- Arch Linux package management library -.SH SYNOPSIS -For ease of access, the libalpm manual has been split up into several sections. - -.nf -alpm_databases Database Functions -alpm_dep Dependency Functions -alpm_groups Group Functions -alpm_interface Interface Functions -alpm_list List Functions -alpm_log Logging Functions -alpm_misc Miscellaneous Functions -alpm_options Library Options -alpm_packages Package Functions -alpm_sync Sync Functions -alpm_trans Transaction Functions -.fi - -.SH AUTHOR -.nf -Judd Vinet <jvinet@zeroflux.org> -and the Frugalware developers <frugalware-devel@frugalware.org> -.fi diff --git a/doc/makepkg.8 b/doc/makepkg.8 deleted file mode 100644 index 418d5dca..00000000 --- a/doc/makepkg.8 +++ /dev/null @@ -1,156 +0,0 @@ -.TH makepkg 8 "January 30, 2006" "Frugalware Developer Manual" "" -.SH NAME -makepkg \- package build utility -.SH SYNOPSIS -\fBmakepkg [options]\fP -.SH DESCRIPTION -\fBmakepkg\fP will build packages for you. All it needs is -a build-capable linux platform, wget, and some build scripts. The advantage -to a script-based build is that you only really do the work once. Once you -have the build script for a package, you just need to run makepkg and it -will do the rest: download and validate source files, check dependencies, -configure the buildtime settings, build the package, install the package -into a temporary root, make customizations, generate meta-info, and package -the whole thing up for \fBpacman\fP to use. - -\fBmakeworld\fP can be used to rebuild an entire package group or the -entire build tree. See \fBmakeworld --help\fP for syntax. - -.SH OPTIONS -.TP -.B "\-b, \-\-builddeps" -Build missing dependencies from source. When makepkg finds missing build-time or -run-time dependencies, it will look for the dependencies' FrugalBuild files under -$fst_root (set in your /etc/repoman.conf). If it finds them it will -run another copy of makepkg to build and install the missing dependencies. -The child makepkg calls will be made with the \fB-b\fP and \fB-i\fP options. -.TP -.B "\-B, \-\-noccache" -Do not use ccache during build. -.TP -.B "\-c, \-\-clean" -Clean up leftover work files/directories after a successful build. -.TP -.B "\-C, \-\-cleancache" -Used with --chroot cleans up the chroot which means removing unnecessary -packages from it. If used twice, then it removes all source files from -the cache directory and cleans up the full compiler cache to free up diskspace. -.TP -.B "\-d, \-\-nodeps" -Do not perform any dependency checks. This will let you override/ignore any -dependencies required. There's a good chance this option will break the build -process if all of the dependencies aren't installed. -.TP -.B "\-D <pkgname>" -Clean up only one package's compiler cache. (Uses ccache -C.) -.TP -.B "\-e, \-\-noextract" -Do not extract source files. Instead, use whatever already exists in the -src/ directory. This is handy if you want to go into src and manually -patch/tweak code, then make a package out of the result. -.TP -.B "\-f, \-\-force" -\fBmakepkg\fP will not build a package if a \fIpkgname-pkgver-pkgrel-arch.fpm\fP -file already exists in the build directory. You can override this behaviour with -the \fB--force\fP switch. -.TP -.B "\-G, \-\-genmd5" -Download all source files (if required) and use \fImd5sum\fP to generate md5 hashes -for each of them. You can then redirect the output into your FrugalBuild for source -validation (makepkg -G >>FrugalBuild). -.TP -.B "\-g, \-\-gensha1" -Download all source files (if required) and use \fIsha1sum\fP to generate sha1 hashes -for each of them. You can then redirect the output into your FrugalBuild for source -validation (makepkg -g >>FrugalBuild). -.TP -.B "\-h, \-\-help" -Output syntax and commandline options. -.TP -.B "\-i, \-\-install" -Install/Upgrade the package after a successful build. -.TP -.B "\-j <jobs>" -Sets MAKEFLAGS="-j<jobs>" before building the package. This is useful for overriding -the MAKEFLAGS setting in /etc/makepkg.conf. -.TP -.B "\-L, \-\-nolastmod" -Disable updating the Last modified line. -.TP -.B "\-k, \-\-logging" -Logging package build process -.TP -.B "\-l <pkgname>" -Download the package's buildscript before starting the build. This is useful -if you do not want to do a full 'repoman upd' nor want to download manually the -buildscript. -.TP -.B "\-m, \-\-nocolor" -Disable color in output messages -.TP -.B "\-n, \-\-nostrip" -Do not strip binaries and libraries. -.TP -.B "\-o, \-\-nobuild" -Download and extract files only, do not build. -.TP -.B "\-p <buildscript>" -Read the package script \fI<buildscript>\fP instead of the default (\fIFrugalBuild\fP). -.TP -.B "\-r, \-\-rmdeps" -Upon successful build, remove any dependencies installed by makepkg/pacman during -dependency auto-resolution (using \fB-b\fP or \fB-s\fP). -.TP -.B "\-R, \-\-chroot" -Build the package in a chroot environment. -.TP -.B "\-s, \-\-syncdeps" -Install missing dependencies using pacman. When makepkg finds missing build-time -or run-time dependencies, it will run pacman to try and resolve them. If successful, -pacman will download the missing packages from a package repository and -install them for you. -.TP -.B "\-t <tree>" -When building in a chroot (using -R) you may want to build packages for a -version other than the host one. Using this option, it's possible to build -packages for "stable" while the host system is "current" and vica versa. -.TP -.B "\-u, \-\-noup2date" -Do not check for newer version before starting build. Normally makepkg will -prevent you from building obsolete source by mistake. If you know what you are -doing, you can disable this feature with this switch. -.B "\-S, \-\-sudosync" -Install missing dependencies using pacman and sudo. This is the same as \fB-s\fP -except that makepkg will call pacman with sudo. This means you don't have to -build as root to use dependency auto-resolution. -.TP -.TP -.B "\-w <destdir>" -Write the resulting package file to the directory \fI<destdir>\fP instead of the -current working directory. -.TP -.B "\-\-noconfirm" -When calling pacman to resolve dependencies or conflicts, makepkg can pass -the \fI--noconfirm\fP option to it so it does not wait for any user -input before proceeding with operations. -.TP -.B "\-\-noprogressbar" -When calling pacman, makepkg can pass the \fI--noprogressbar\fP option to it. -This is useful if one is directing makepkg's output to a non-terminal (ie, a file). - -.SH CONFIGURATION -Configuration options are stored in \fI/etc/makepkg.conf\fP. This file is parsed -as a bash script, so you can export any special compiler flags you wish -to use. This is helpful for building for different architectures, or with -different optimizations. - -\fBNOTE:\fP This does not guarantee that all package Makefiles will use -your exported variables. Some of them are flaky... -.SH "SEE ALSO" -.BR FrugalBuild (8), -.BR pacman (8) -.SH AUTHOR -.nf -Judd Vinet <jvinet@zeroflux.org> -and the Frugalware developers <frugalware-devel@frugalware.org> -.fi diff --git a/doc/man3/alpm_conflict_getinfo.3 b/doc/man3/alpm_conflict_getinfo.3 deleted file mode 100644 index 8bfc6275..00000000 --- a/doc/man3/alpm_conflict_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_dep.3 diff --git a/doc/man3/alpm_databases.3 b/doc/man3/alpm_databases.3 deleted file mode 100644 index 84eda8c5..00000000 --- a/doc/man3/alpm_databases.3 +++ /dev/null @@ -1,211 +0,0 @@ -.TH "Database Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Database Functions \- Frunctions to query and manipulate the database of libalpm. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "pmdb_t * \fBalpm_db_register\fP (char *treename, alpm_cb_db_register callback)" -.br -.ti -1c -.RI "int \fBalpm_db_unregister\fP (pmdb_t *db)" -.br -.ti -1c -.RI "void * \fBalpm_db_getinfo\fP (PM_DB *db, unsigned char parm)" -.br -.ti -1c -.RI "int \fBalpm_db_setserver\fP (pmdb_t *db, char *url)" -.br -.ti -1c -.RI "int \fBalpm_db_update\fP (int level, PM_DB *db)" -.br -.ti -1c -.RI "pmpkg_t * \fBalpm_db_readpkg\fP (pmdb_t *db, char *name)" -.br -.ti -1c -.RI "PMList * \fBalpm_db_getpkgcache\fP (pmdb_t *db)" -.br -.ti -1c -.RI "PMList * \fBalpm_db_whatprovides\fP (pmdb_t *db, char *name)" -.br -.ti -1c -.RI "pmgrp_t * \fBalpm_db_readgrp\fP (pmdb_t *db, char *name)" -.br -.ti -1c -.RI "PMList * \fBalpm_db_getgrpcache\fP (pmdb_t *db)" -.br -.in -1c -.SH "Detailed Description" -.PP -Frunctions to query and manipulate the database of libalpm. -.PP -.SH "Function Documentation" -.PP -.SS "PMList* alpm_db_getgrpcache (pmdb_t * db)" -.PP -Get the group cache of a package database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to get the group from -.RE -.PP -\fBReturns:\fP -.RS 4 -the list of groups on success, NULL on error -.RE -.PP - -.SS "void* alpm_db_getinfo (PM_DB * db, unsigned char parm)" -.PP -Get informations about a database. -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP database pointer -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a void* on success (the value), NULL on error -.RE -.PP - -.SS "PMList* alpm_db_getpkgcache (pmdb_t * db)" -.PP -Get the package cache of a package database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to get the package from -.RE -.PP -\fBReturns:\fP -.RS 4 -the list of packages on success, NULL on error -.RE -.PP - -.SS "pmgrp_t* alpm_db_readgrp (pmdb_t * db, char * name)" -.PP -Get a group entry from a package database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to get the group from -.br -\fIname\fP of the group -.RE -.PP -\fBReturns:\fP -.RS 4 -the groups entry on success, NULL on error -.RE -.PP - -.SS "pmpkg_t* alpm_db_readpkg (pmdb_t * db, char * name)" -.PP -Get a package entry from a package database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to get the package from -.br -\fIname\fP of the package -.RE -.PP -\fBReturns:\fP -.RS 4 -the package entry on success, NULL on error -.RE -.PP - -.SS "pmdb_t* alpm_db_register (char * treename, alpm_cb_db_register callback)" -.PP -Register a package database -.PP -\fBParameters:\fP -.RS 4 -\fItreename\fP the name of the repository -.br -\fIcallback\fP a function to be called upon new database creation -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_db_setserver (pmdb_t * db, char * url)" -.PP -Set the serverlist of a database. -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP database pointer -.br -\fIurl\fP url of the server -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_db_unregister (pmdb_t * db)" -.PP -Unregister a package database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to unregister -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_db_update (int level, PM_DB * db)" -.PP -Update a package database -.PP -\fBParameters:\fP -.RS 4 -\fIlevel\fP control for checking lastupdate time -.br -\fIdb\fP pointer to the package database to update -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, > 0 on error (pm_errno is set accordingly), < 0 if up to date -.RE -.PP - -.SS "PMList* alpm_db_whatprovides (pmdb_t * db, char * name)" -.PP -Get the list of packages that a package provides -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to get the package from -.br -\fIname\fP name of the package -.RE -.PP -\fBReturns:\fP -.RS 4 -the list of packages on success, NULL on error -.RE -.PP - diff --git a/doc/man3/alpm_db_getgrpcache.3 b/doc/man3/alpm_db_getgrpcache.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_getgrpcache.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_getinfo.3 b/doc/man3/alpm_db_getinfo.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_getpkgcache.3 b/doc/man3/alpm_db_getpkgcache.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_getpkgcache.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_readgrp.3 b/doc/man3/alpm_db_readgrp.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_readgrp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_readpkg.3 b/doc/man3/alpm_db_readpkg.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_readpkg.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_register.3 b/doc/man3/alpm_db_register.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_register.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_search.3 b/doc/man3/alpm_db_search.3 deleted file mode 100644 index e26f34ce..00000000 --- a/doc/man3/alpm_db_search.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_sync.3 diff --git a/doc/man3/alpm_db_setserver.3 b/doc/man3/alpm_db_setserver.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_setserver.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_unregister.3 b/doc/man3/alpm_db_unregister.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_unregister.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_update.3 b/doc/man3/alpm_db_update.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_update.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_whatprovides.3 b/doc/man3/alpm_db_whatprovides.3 deleted file mode 100644 index 01b2bdc9..00000000 --- a/doc/man3/alpm_db_whatprovides.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_dep.3 b/doc/man3/alpm_dep.3 deleted file mode 100644 index 49eaf0a1..00000000 --- a/doc/man3/alpm_dep.3 +++ /dev/null @@ -1,57 +0,0 @@ -.TH "Dependency Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Dependency Functions \- Functions to get informations about a libalpm dependency. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "void * \fBalpm_dep_getinfo\fP (pmdepmissing_t *miss, unsigned char parm)" -.br -.ti -1c -.RI "void * \fBalpm_conflict_getinfo\fP (pmconflict_t *conflict, unsigned char parm)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to get informations about a libalpm dependency. -.PP -.SH "Function Documentation" -.PP -.SS "void* alpm_conflict_getinfo (pmconflict_t * conflict, unsigned char parm)" -.PP -Get informations about a file conflict. -.PP -\fBParameters:\fP -.RS 4 -\fIconflict\fP database conflict structure -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - -.SS "void* alpm_dep_getinfo (pmdepmissing_t * miss, unsigned char parm)" -.PP -Get informations about a dependency. -.PP -\fBParameters:\fP -.RS 4 -\fImiss\fP dependency pointer -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - diff --git a/doc/man3/alpm_dep_getinfo.3 b/doc/man3/alpm_dep_getinfo.3 deleted file mode 100644 index 8bfc6275..00000000 --- a/doc/man3/alpm_dep_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_dep.3 diff --git a/doc/man3/alpm_fetch_pkgurl.3 b/doc/man3/alpm_fetch_pkgurl.3 deleted file mode 100644 index 5c237ae4..00000000 --- a/doc/man3/alpm_fetch_pkgurl.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_get_md5sum.3 b/doc/man3/alpm_get_md5sum.3 deleted file mode 100644 index 5c237ae4..00000000 --- a/doc/man3/alpm_get_md5sum.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_get_option.3 b/doc/man3/alpm_get_option.3 deleted file mode 100644 index 695ff9fd..00000000 --- a/doc/man3/alpm_get_option.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_options.3 diff --git a/doc/man3/alpm_get_sha1sum.3 b/doc/man3/alpm_get_sha1sum.3 deleted file mode 100644 index 5c237ae4..00000000 --- a/doc/man3/alpm_get_sha1sum.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_groups.3 b/doc/man3/alpm_groups.3 deleted file mode 100644 index 77fb4b71..00000000 --- a/doc/man3/alpm_groups.3 +++ /dev/null @@ -1,37 +0,0 @@ -.TH "Group Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Group Functions \- Functions to get informations about libalpm groups. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "void * \fBalpm_grp_getinfo\fP (pmgrp_t *grp, unsigned char parm)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to get informations about libalpm groups. -.PP -.SH "Function Documentation" -.PP -.SS "void* alpm_grp_getinfo (pmgrp_t * grp, unsigned char parm)" -.PP -Get informations about a group. -.PP -\fBParameters:\fP -.RS 4 -\fIgrp\fP group pointer -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - diff --git a/doc/man3/alpm_grp_getinfo.3 b/doc/man3/alpm_grp_getinfo.3 deleted file mode 100644 index a85dd83a..00000000 --- a/doc/man3/alpm_grp_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_groups.3 diff --git a/doc/man3/alpm_initialize.3 b/doc/man3/alpm_initialize.3 deleted file mode 100644 index bca122ef..00000000 --- a/doc/man3/alpm_initialize.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_interface.3 diff --git a/doc/man3/alpm_interface.3 b/doc/man3/alpm_interface.3 deleted file mode 100644 index a4b5443a..00000000 --- a/doc/man3/alpm_interface.3 +++ /dev/null @@ -1,48 +0,0 @@ -.TH "Interface Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Interface Functions \- Function to initialize and release libalpm. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "int \fBalpm_initialize\fP (char *root)" -.br -.ti -1c -.RI "int \fBalpm_release\fP ()" -.br -.in -1c -.SH "Detailed Description" -.PP -Function to initialize and release libalpm. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_initialize (char * root)" -.PP -Initializes the library. This must be called before any other functions are called. -.PP -\fBParameters:\fP -.RS 4 -\fIroot\fP the full path of the root we'll be installing to (usually /) -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_release ()" -.PP -Release the library. This should be the last alpm call you make. -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - diff --git a/doc/man3/alpm_list.3 b/doc/man3/alpm_list.3 deleted file mode 100644 index 18c48014..00000000 --- a/doc/man3/alpm_list.3 +++ /dev/null @@ -1,107 +0,0 @@ -.TH "List Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -List Functions \- Functions to manipulate libalpm linked lists. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "PMList * \fBalpm_list_first\fP (PMList *list)" -.br -.ti -1c -.RI "PMList * \fBalpm_list_next\fP (PMList *entry)" -.br -.ti -1c -.RI "void * \fBalpm_list_getdata\fP (PMList *entry)" -.br -.ti -1c -.RI "int \fBalpm_list_free\fP (PMList *entry)" -.br -.ti -1c -.RI "int \fBalpm_list_count\fP (PMList *list)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to manipulate libalpm linked lists. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_list_count (PMList * list)" -.PP -Count the entries in a list. -.PP -\fBParameters:\fP -.RS 4 -\fIlist\fP the list to count -.RE -.PP -\fBReturns:\fP -.RS 4 -number of entries on success, NULL on error -.RE -.PP - -.SS "PMList* alpm_list_first (PMList * list)" -.PP -Get the first element of a list. -.PP -\fBParameters:\fP -.RS 4 -\fIlist\fP the list -.RE -.PP -\fBReturns:\fP -.RS 4 -the first element -.RE -.PP - -.SS "int alpm_list_free (PMList * entry)" -.PP -Free a list. -.PP -\fBParameters:\fP -.RS 4 -\fIentry\fP list to free -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error -.RE -.PP - -.SS "void* alpm_list_getdata (PMList * entry)" -.PP -Get the data of a list entry. -.PP -\fBParameters:\fP -.RS 4 -\fIentry\fP the list entry -.RE -.PP -\fBReturns:\fP -.RS 4 -the data on success, NULL on error -.RE -.PP - -.SS "PMList* alpm_list_next (PMList * entry)" -.PP -Get the next element of a list. -.PP -\fBParameters:\fP -.RS 4 -\fIentry\fP the list entry -.RE -.PP -\fBReturns:\fP -.RS 4 -the next element on success, NULL on error -.RE -.PP - diff --git a/doc/man3/alpm_list_count.3 b/doc/man3/alpm_list_count.3 deleted file mode 100644 index af27c84d..00000000 --- a/doc/man3/alpm_list_count.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_first.3 b/doc/man3/alpm_list_first.3 deleted file mode 100644 index af27c84d..00000000 --- a/doc/man3/alpm_list_first.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_free.3 b/doc/man3/alpm_list_free.3 deleted file mode 100644 index af27c84d..00000000 --- a/doc/man3/alpm_list_free.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_getdata.3 b/doc/man3/alpm_list_getdata.3 deleted file mode 100644 index af27c84d..00000000 --- a/doc/man3/alpm_list_getdata.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_next.3 b/doc/man3/alpm_list_next.3 deleted file mode 100644 index af27c84d..00000000 --- a/doc/man3/alpm_list_next.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_list.3 diff --git a/doc/man3/alpm_log.3 b/doc/man3/alpm_log.3 deleted file mode 100644 index 1e2d9ac3..00000000 --- a/doc/man3/alpm_log.3 +++ /dev/null @@ -1,35 +0,0 @@ -.TH "Logging Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Logging Functions \- Functions to log using libalpm. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "int \fBalpm_logaction\fP (char *fmt,...)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to log using libalpm. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_logaction (char * fmt, ...)" -.PP -A printf-like function for logging. -.PP -\fBParameters:\fP -.RS 4 -\fIfmt\fP output format -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - diff --git a/doc/man3/alpm_logaction.3 b/doc/man3/alpm_logaction.3 deleted file mode 100644 index bd21eb21..00000000 --- a/doc/man3/alpm_logaction.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_log.3 diff --git a/doc/man3/alpm_misc.3 b/doc/man3/alpm_misc.3 deleted file mode 100644 index d2e8a3b0..00000000 --- a/doc/man3/alpm_misc.3 +++ /dev/null @@ -1,93 +0,0 @@ -.TH "Miscellaneous Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Miscellaneous Functions \- Various libalpm functions. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "char * \fBalpm_get_md5sum\fP (char *name)" -.br -.ti -1c -.RI "char * \fBalpm_get_sha1sum\fP (char *name)" -.br -.ti -1c -.RI "char * \fBalpm_fetch_pkgurl\fP (char *url)" -.br -.ti -1c -.RI "int \fBalpm_parse_config\fP (char *file, alpm_cb_db_register callback, const char *this_section)" -.br -.in -1c -.SH "Detailed Description" -.PP -Various libalpm functions. -.PP -.SH "Function Documentation" -.PP -.SS "char* alpm_fetch_pkgurl (char * url)" -.PP -Fetch a remote pkg. -.PP -\fBParameters:\fP -.RS 4 -\fIurl\fP -.RE -.PP -\fBReturns:\fP -.RS 4 -the downloaded filename on success, NULL on error -.RE -.PP - -.SS "char* alpm_get_md5sum (char * name)" -.PP -Get the md5 sum of file. -.PP -\fBParameters:\fP -.RS 4 -\fIname\fP name of the file -.RE -.PP -\fBReturns:\fP -.RS 4 -the checksum on success, NULL on error -.RE -.PP - -.SS "char* alpm_get_sha1sum (char * name)" -.PP -Get the sha1 sum of file. -.PP -\fBParameters:\fP -.RS 4 -\fIname\fP name of the file -.RE -.PP -\fBReturns:\fP -.RS 4 -the checksum on success, NULL on error -.RE -.PP - -.SS "int alpm_parse_config (char * file, alpm_cb_db_register callback, const char * this_section)" -.PP -Parses a configuration file. -.PP -\fBParameters:\fP -.RS 4 -\fIfile\fP path to the config file. -.br -\fIcallback\fP a function to be called upon new database creation -.br -\fIthis_section\fP the config current section being parsed -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - diff --git a/doc/man3/alpm_options.3 b/doc/man3/alpm_options.3 deleted file mode 100644 index c43a3039..00000000 --- a/doc/man3/alpm_options.3 +++ /dev/null @@ -1,57 +0,0 @@ -.TH "Library Options" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Library Options \- Functions to set and get libalpm options. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "int \fBalpm_set_option\fP (unsigned char parm, unsigned long data)" -.br -.ti -1c -.RI "int \fBalpm_get_option\fP (unsigned char parm, long *data)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to set and get libalpm options. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_get_option (unsigned char parm, long * data)" -.PP -Get the value of a library option. -.PP -\fBParameters:\fP -.RS 4 -\fIparm\fP the parameter to get -.br -\fIdata\fP pointer argument to get the value in -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_set_option (unsigned char parm, unsigned long data)" -.PP -Set a library option. -.PP -\fBParameters:\fP -.RS 4 -\fIparm\fP the name of the parameter -.br -\fIdata\fP the value of the parameter -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - diff --git a/doc/man3/alpm_packages.3 b/doc/man3/alpm_packages.3 deleted file mode 100644 index 5b193c0f..00000000 --- a/doc/man3/alpm_packages.3 +++ /dev/null @@ -1,131 +0,0 @@ -.TH "Package Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Package Functions \- Functions to manipulate libalpm packages. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "void * \fBalpm_pkg_getinfo\fP (pmpkg_t *pkg, unsigned char parm)" -.br -.ti -1c -.RI "int \fBalpm_pkg_load\fP (char *filename, pmpkg_t **pkg)" -.br -.ti -1c -.RI "int \fBalpm_pkg_free\fP (pmpkg_t *pkg)" -.br -.ti -1c -.RI "int \fBalpm_pkg_checksha1sum\fP (pmpkg_t *pkg)" -.br -.ti -1c -.RI "int \fBalpm_pkg_checkmd5sum\fP (pmpkg_t *pkg)" -.br -.ti -1c -.RI "int \fBalpm_pkg_vercmp\fP (const char *ver1, const char *ver2)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to manipulate libalpm packages. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_pkg_checkmd5sum (pmpkg_t * pkg)" -.PP -Check the integrity (with md5) of a package from the sync cache. -.PP -\fBParameters:\fP -.RS 4 -\fIpkg\fP package pointer -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_pkg_checksha1sum (pmpkg_t * pkg)" -.PP -Check the integrity (with sha1) of a package from the sync cache. -.PP -\fBParameters:\fP -.RS 4 -\fIpkg\fP package pointer -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_pkg_free (pmpkg_t * pkg)" -.PP -Free a package. -.PP -\fBParameters:\fP -.RS 4 -\fIpkg\fP package pointer to free -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "void* alpm_pkg_getinfo (pmpkg_t * pkg, unsigned char parm)" -.PP -Get informations about a package. -.PP -\fBParameters:\fP -.RS 4 -\fIpkg\fP package pointer -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - -.SS "int alpm_pkg_load (char * filename, pmpkg_t ** pkg)" -.PP -Create a package from a file. -.PP -\fBParameters:\fP -.RS 4 -\fIfilename\fP location of the package tarball -.br -\fIpkg\fP address of the package pointer -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_pkg_vercmp (const char * ver1, const char * ver2)" -.PP -Compare versions. -.PP -\fBParameters:\fP -.RS 4 -\fIver1\fP first version -.br -\fIver2\fP secont version -.RE -.PP -\fBReturns:\fP -.RS 4 -postive, 0 or negative if ver1 is less, equal or more than ver2, respectively. -.RE -.PP - diff --git a/doc/man3/alpm_parse_config.3 b/doc/man3/alpm_parse_config.3 deleted file mode 100644 index 5c237ae4..00000000 --- a/doc/man3/alpm_parse_config.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_pkg_checkmd5sum.3 b/doc/man3/alpm_pkg_checkmd5sum.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_checkmd5sum.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_checksha1sum.3 b/doc/man3/alpm_pkg_checksha1sum.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_checksha1sum.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_free.3 b/doc/man3/alpm_pkg_free.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_free.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_getinfo.3 b/doc/man3/alpm_pkg_getinfo.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_load.3 b/doc/man3/alpm_pkg_load.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_load.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_vercmp.3 b/doc/man3/alpm_pkg_vercmp.3 deleted file mode 100644 index 133c7d41..00000000 --- a/doc/man3/alpm_pkg_vercmp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_release.3 b/doc/man3/alpm_release.3 deleted file mode 100644 index bca122ef..00000000 --- a/doc/man3/alpm_release.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_interface.3 diff --git a/doc/man3/alpm_set_option.3 b/doc/man3/alpm_set_option.3 deleted file mode 100644 index 695ff9fd..00000000 --- a/doc/man3/alpm_set_option.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_options.3 diff --git a/doc/man3/alpm_sync.3 b/doc/man3/alpm_sync.3 deleted file mode 100644 index c406ff92..00000000 --- a/doc/man3/alpm_sync.3 +++ /dev/null @@ -1,55 +0,0 @@ -.TH "Sync Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Sync Functions \- Functions to get informations about libalpm syncs. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "void * \fBalpm_sync_getinfo\fP (pmsyncpkg_t *sync, unsigned char parm)" -.br -.ti -1c -.RI "PMList * \fBalpm_db_search\fP (pmdb_t *db)" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to get informations about libalpm syncs. -.PP -.SH "Function Documentation" -.PP -.SS "PMList* alpm_db_search (pmdb_t * db)" -.PP -Searches a database -.PP -\fBParameters:\fP -.RS 4 -\fIdb\fP pointer to the package database to search in -.RE -.PP -\fBReturns:\fP -.RS 4 -the list of packages on success, NULL on error -.RE -.PP - -.SS "void* alpm_sync_getinfo (pmsyncpkg_t * sync, unsigned char parm)" -.PP -Get informations about a sync. -.PP -\fBParameters:\fP -.RS 4 -\fIsync\fP pointer -.br -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - diff --git a/doc/man3/alpm_sync_getinfo.3 b/doc/man3/alpm_sync_getinfo.3 deleted file mode 100644 index e26f34ce..00000000 --- a/doc/man3/alpm_sync_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_sync.3 diff --git a/doc/man3/alpm_trans.3 b/doc/man3/alpm_trans.3 deleted file mode 100644 index d574cdb1..00000000 --- a/doc/man3/alpm_trans.3 +++ /dev/null @@ -1,141 +0,0 @@ -.TH "Transaction Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- -.ad l -.nh -.SH NAME -Transaction Functions \- Functions to manipulate libalpm transactions. - -.PP -.SS "Functions" - -.in +1c -.ti -1c -.RI "void * \fBalpm_trans_getinfo\fP (unsigned char parm)" -.br -.ti -1c -.RI "int \fBalpm_trans_init\fP (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)" -.br -.ti -1c -.RI "int \fBalpm_trans_sysupgrade\fP ()" -.br -.ti -1c -.RI "int \fBalpm_trans_addtarget\fP (char *target)" -.br -.ti -1c -.RI "int \fBalpm_trans_prepare\fP (PMList **data)" -.br -.ti -1c -.RI "int \fBalpm_trans_commit\fP (PMList **data)" -.br -.ti -1c -.RI "int \fBalpm_trans_release\fP ()" -.br -.in -1c -.SH "Detailed Description" -.PP -Functions to manipulate libalpm transactions. -.PP -.SH "Function Documentation" -.PP -.SS "int alpm_trans_addtarget (char * target)" -.PP -Add a target to the transaction. -.PP -\fBParameters:\fP -.RS 4 -\fItarget\fP the name of the target to add -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_trans_commit (PMList ** data)" -.PP -Commit a transaction. -.PP -\fBParameters:\fP -.RS 4 -\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "void* alpm_trans_getinfo (unsigned char parm)" -.PP -Get informations about the transaction. -.PP -\fBParameters:\fP -.RS 4 -\fIparm\fP name of the info to get -.RE -.PP -\fBReturns:\fP -.RS 4 -a char* on success (the value), NULL on error -.RE -.PP - -.SS "int alpm_trans_init (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)" -.PP -Initialize the transaction. -.PP -\fBParameters:\fP -.RS 4 -\fItype\fP type of the transaction -.br -\fIflags\fP flags of the transaction (like nodeps, etc) -.br -\fIevent\fP event callback function pointer -.br -\fIconv\fP question callback function pointer -.br -\fIprogress\fP progress callback function pointer -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_trans_prepare (PMList ** data)" -.PP -Prepare a transaction. -.PP -\fBParameters:\fP -.RS 4 -\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) -.RE -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_trans_release ()" -.PP -Release a transaction. -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - -.SS "int alpm_trans_sysupgrade ()" -.PP -Search for packages to upgrade and add them to the transaction. -.PP -\fBReturns:\fP -.RS 4 -0 on success, -1 on error (pm_errno is set accordingly) -.RE -.PP - diff --git a/doc/man3/alpm_trans_addtarget.3 b/doc/man3/alpm_trans_addtarget.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_addtarget.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_commit.3 b/doc/man3/alpm_trans_commit.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_commit.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_getinfo.3 b/doc/man3/alpm_trans_getinfo.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_getinfo.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_init.3 b/doc/man3/alpm_trans_init.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_init.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_prepare.3 b/doc/man3/alpm_trans_prepare.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_prepare.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_release.3 b/doc/man3/alpm_trans_release.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_release.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_sysupgrade.3 b/doc/man3/alpm_trans_sysupgrade.3 deleted file mode 100644 index 219cf744..00000000 --- a/doc/man3/alpm_trans_sysupgrade.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/alpm_trans.3 diff --git a/doc/pacman.8 b/doc/pacman.8 deleted file mode 100644 index 704f9d1b..00000000 --- a/doc/pacman.8 +++ /dev/null @@ -1,359 +0,0 @@ -.TH pacman 8 "January 21, 2006" "Frugalware User Manual" "" -.SH NAME -pacman \- package manager utility -.SH SYNOPSIS -\fBpacman <operation> [options] <package> [package] ...\fP -.SH DESCRIPTION -\fBpacman\fP is a \fIpackage management\fP utility that tracks installed -packages on a linux system. It has simple dependency support and the ability -to connect to a remote ftp server and automatically upgrade packages on -the local system. pacman package are \fIbzipped tar\fP format. -.SH OPERATIONS -.TP -.B "\-A, \-\-add" -Add a package to the system. Package will be uncompressed -into the installation root and the database will be updated. -.TP -.B "\-F, \-\-freshen" -This is like --upgrade except that, unlike --upgrade, this will only -upgrade packages that are already installed on your system. -.TP -.B "\-Q, \-\-query" -Query the package database. This operation allows you to -view installed packages and their files, as well as meta-info -about individual packages (dependencies, conflicts, install date, -build date, size). This can be run against the local package -database or can be used on individual .fpm packages. See -\fBQUERY OPTIONS\fP below. -.TP -.B "\-c, \-\-changelog" -View the changelog of a package. -.TP -.B "\-R, \-\-remove" -Remove a package from the system. Files belonging to the -specified package will be deleted, and the database will -be updated. Most configuration files will be saved with a -\fI.pacsave\fP extension unless the \fB--nosave\fP option was -used. -.TP -.B "\-S, \-\-sync" -Synchronize packages. With this function you can install packages -directly from the ftp servers, complete with all dependencies required -to run the packages. For example, \fBpacman -S qt\fP will download -qt and all the packages it depends on and install them. You could also use -\fBpacman -Su\fP to upgrade all packages that are out of date (see below). -.TP -.B "\-U, \-\-upgrade" -Upgrade a package. This is essentially a "remove-then-add" -process. See \fBHANDLING CONFIG FILES\fP for an explanation -on how pacman takes care of config files. -.TP -.B "\-V, \-\-version" -Display version and exit. -.TP -.B "\-h, \-\-help" -Display syntax for the given operation. If no operation was -supplied then the general syntax is shown. -.SH OPTIONS -.TP -.B "\-d, \-\-nodeps" -Skips all dependency checks. Normally, pacman will always check -a package's dependency fields to ensure that all dependencies are -installed and there are no package conflicts in the system. This -switch disables these checks. -.TP -.B "\-f, \-\-force" -Bypass file conflict checks, overwriting conflicting files. If the -package that is about to be installed contains files that are already -installed, this option will cause all those files to be overwritten. -This option should be used with care, ideally not at all. -.TP -.B "\-r, \-\-root <path>" -Specify alternative installation root (default is "/"). This -should \fInot\fP be used as a way to install software into -e.g. /usr/local instead of /usr. Instead this should be used -if you want to install a package on a temporary mounted partition, -which is "owned" by another system. By using this option you not only -specify where the software should be installed, but you also -specify which package database to use. -.TP -.B "\-v, \-\-verbose" -Output more status and error messages. -.TP -.B "\-\-config <path>" -Specify an alternate configuration file. -.TP -.B "\-\-noconfirm" -Bypass any and all "Are you sure?" messages. It's not a good idea to do this -unless you want to run pacman from a script. -.TP -.B "\-\-ask <number>" -Finetune the --noconfirm switch by not answering "yes" to all libalpm -questions, but you are able to specify yes/no for all type of libalpm -questions. The types are the followings: -.nf -The given package is in IgnorePkg. (1) -Replace package foo with bar? (2) -foo conflicts with bar. Remove bar? (4) -Do you want to delete the corrupted package? (8) -Local version is newer. (16) -Local version is up to date. (32) -.fi -Select for what types do you want to answer yes, sum up the values and use the -result as a parameter to this option. -.TP -.B "\-\-noprogressbar" -Do not show a progress bar when downloading files. This can be useful for -scripts that call pacman and capture the output. -.SH SYNC OPTIONS -.TP -.B "\-c, \-\-clean" -Remove old packages from the cache. When pacman downloads packages, -it saves them in \fI/var/cache/pacman/pkg\fP. If you need to free up -diskspace, you can remove these packages by using the --clean option. -Using one --clean (or -c) switch will only remove \fIold\fP packages. -Use it twice to remove \fIall\fP packages from the cache. -.TP -.B "\-e, \-\-dependsonly" -Don't install the packages itself, only their dependencies. This can be -handy if you want to install the packages themselves with different -options or from source. -.TP -.B "\-g, \-\-groups" -Display all the members for each package group specified. If no group -names are provided, all groups will be listed. -.TP -.B "\-i, \-\-info" -Display dependency information for a given package. This will search -through all repositories for a matching package and display the -dependencies, conflicts, etc. -.TP -.B "\-l, \-\-list" -List all files in the specified repositories. Multiple repositories can -be specified on the command line. -.TP -.B "\-p, \-\-print-uris" -Print out URIs for each package that will be installed, including any -dependencies that have yet to be installed. These can be piped to a -file and downloaded at a later time, using a program like wget. -.TP -.B "\-s, \-\-search <regexp>" -This will search each package in the package list for names or descriptions -that contains <regexp>. -.TP -.B "\-u, \-\-sysupgrade" -Upgrades all packages that are out of date. pacman will examine every -package installed on the system, and if a newer package exists on the -server it will upgrade. pacman will present a report of all packages -it wants to upgrade and will not proceed without user confirmation. -Dependencies are automatically resolved at this level and will be -installed/upgraded if necessary. -.TP -.B "\-w, \-\-downloadonly" -Retrieve all packages from the server, but do not install/upgrade anything. -.TP -.B "\-y, \-\-refresh" -Download a fresh copy of the master package list from the ftp server -defined in \fI/etc/pacman.conf\fP. This should typically be used each -time you use \fB--sysupgrade\fP. -.TP -.B "\-\-ignore <pkg>" -This option functions exactly the same as the \fBIgnorePkg\fP configuration -directive. Sometimes it can be handy to skip some package updates without -having to edit \fIpacman.conf\fP each time. -.SH REMOVE OPTIONS -.TP -.B "\-c, \-\-cascade" -Remove all target packages, as well as all packages that depend on one -or more target packages. This operation is recursive. -.TP -.B "\-k, \-\-keep" -Removes the database entry only. Leaves all files in place. -.TP -.B "\-n, \-\-nosave" -Instructs pacman to ignore file backup designations. Normally, when -a file is about to be \fIremoved\fP from the system the database is first -checked to see if the file should be renamed to a .pacsave extension. If -\fB--nosave\fP is used, these designations are ignored and the files are -removed. -.TP -.B "\-s, \-\-recursive" -For each target specified, remove it and all its dependencies, provided -that (A) they are not required by other packages; and (B) they were not -explicitly installed by the user. -This option is analagous to a backwards --sync operation. -.SH QUERY OPTIONS -.TP -.B "\-e, \-\-orphans" -List all packages that were installed as a dependency (ie, not -installed explicitly) and are not required by any other -packages. -.TP -.B "\-g, \-\-groups" -Display all groups that a specified package is part of. If no package -names are provided, all groups and members will be listed. -.TP -.B "\-i, \-\-info" -Display information on a given package. If it is used with the \fB-p\fP -option then the .PKGINFO file will be printed. -.TP -.B "\-l, \-\-list" -List all files owned by <package>. Multiple packages can be specified on -the command line. -.TP -.B "\-m, \-\-foreign" -List all packages that were not found in the sync database(s). Typically these -are packages that were downloaded manually and installed with --add. -.TP -.B "\-o, \-\-owns <file>" -Search for the package that owns <file>. -.TP -.B "\-p, \-\-file" -Tells pacman that the package supplied on the command line is a -file, not an entry in the database. Pacman will decompress the -file and query it. This is useful with \fB--info\fP and \fB--list\fP. -.TP -.B "\-s, \-\-search <regexp>" -This will search each locally-installed package for names or descriptions -that contains <regexp>. -.SH HANDLING CONFIG FILES -pacman uses the same logic as rpm to determine action against files -that are designated to be backed up. During an upgrade, it uses 3 -md5 hashes for each backup file to determine the required action: -one for the original file installed, one for the new file that's about -to be installed, and one for the actual file existing on the filesystem. -After comparing these 3 hashes, the follow scenarios can result: -.TP -original=\fBX\fP, current=\fBX\fP, new=\fBX\fP -All three files are the same, so we win either way. Install the new file. -.TP -original=\fBX\fP, current=\fBX\fP, new=\fBY\fP -The current file is un-altered from the original but the new one is -different. Since the user did not ever modify the file, and the new -one may contain improvements/bugfixes, we install the new file. -.TP -original=\fBX\fP, current=\fBY\fP, new=\fBX\fP -Both package versions contain the exact same file, but the one -on the filesystem has been modified since. In this case, we leave -the current file in place. -.TP -original=\fBX\fP, current=\fBY\fP, new=\fBY\fP -The new one is identical to the current one. Win win. Install the new file. -.TP -original=\fBX\fP, current=\fBY\fP, new=\fBZ\fP -All three files are different, so we install the new file with a .pacnew -extension and warn the user, so she can manually move the file into place -after making any necessary customizations. -.SH CONFIGURATION -pacman will attempt to read \fI/etc/pacman.conf\fP each time it is invoked. This -configuration file is divided into sections or \fIrepositories\fP. Each section -defines a package repository that pacman can use when searching for packages in ---sync mode. The exception to this is the \fIoptions\fP section, which defines -global options. -.TP -.SH Example: -.RS -.nf -[options] -NoUpgrade = etc/passwd etc/group etc/shadow -NoUpgrade = etc/fstab - -Include = /etc/pacman.d/current - -[custom] -Server = file:///home/pkgs - -.fi -.RE -.SH CONFIG: OPTIONS -.TP -.B "DBPath = path/to/db/dir" -Overrides the default location of the toplevel database directory. The default is -\fIvar/lib/pacman\fP. -.TP -.B "CacheDir = path/to/cache/dir" -Overrides the default location of the package cache directory. The default is -\fIvar/cache/pacman\fP. -.TP -.B "HoldPkg = <package> [package] ..." -If a user tries to \fB--remove\fP a package that's listed in HoldPkg, pacman -will ask for confirmation before proceeding. -.TP -.B "IgnorePkg = <package> [package] ..." -Instructs pacman to ignore any upgrades for this package when performing a -\fB--sysupgrade\fP. -.TP -.B "UpgradeDelay = <number>" -Upgrade only the packages that are at least <number> days old when -performing a \fB--sysupgrade\fP. -.TP -.B "Include = <path>" -Include another config file. This config file can include repositories or -general configuration options. -.TP -.B "ProxyServer = <host|ip>[:port]" -If set, pacman will use this proxy server for all ftp/http transfers. -.TP -.B "XferCommand = /path/to/command %u" -If set, pacman will use this external program to download all remote files. -All instances of \fB%u\fP will be replaced with the URL to be downloaded. If -present, instances of \fB%o\fP will be replaced with the local filename, plus a -".part" extension, which allows programs like wget to do file resumes properly. - -This option is useful for users who experience problems with pacman's built-in http/ftp -support, or need the more advanced proxy support that comes with utilities like -wget. -.TP -.B "NoPassiveFtp" -Disables passive ftp connections when downloading packages. (aka Active Mode) -.TP -.B "NoUpgrade = <file> [file] ..." -All files listed with a \fBNoUpgrade\fP directive will never be touched during a package -install/upgrade. \fINote:\fP do not include the leading slash when specifying files. -.TP -.B "NoExtract = <file> [file] ..." -All files listed with a \fBNoExtract\fP directive will never be extracted from -a package into the filesystem. This can be useful when you don't want part of -a package to be installed. For example, if your httpd root uses an index.php, -then you would not want the index.html file to be extracted from the apache -package. -.TP -.B "UseSyslog" -Log action messages through syslog(). This will insert pacman log entries into your -/var/log/messages or equivalent. -.TP -.B "LogFile = /path/to/file" -Log actions directly to a file, usually /var/log/pacman.log. - -.SH CONFIG: REPOSITORIES -Each repository section defines a section name and at least one location where the packages -can be found. The section name is defined by the string within square brackets (eg, the two -above are 'current' and 'custom'). Locations are defined with the \fIServer\fP directive and -follow a URL naming structure. Currently only ftp is supported for remote servers. If you -want to use a local directory, you can specify the full path with a 'file://' prefix, as -shown above. -.SH USING YOUR OWN REPOSITORY -Let's say you have a bunch of custom packages in \fI/home/pkgs\fP and their respective FrugalBuild -files are all in \fI/var/fst/local\fP. All you need to do is generate a compressed package database -in the \fI/home/pkgs\fP directory so pacman can find it when run with --refresh. - -.RS -.nf -# gensync /var/fst/local /home/pkgs/custom.fdb -.fi -.RE - -The above command will read all FrugalBuild files in /var/fst/local and generate a compressed -database called /home/pkgs/custom.fdb. Note that the database must be of the form -\fI{treename}.fdb\fP, where {treename} is the name of the section defined in the -configuration file. -That's it! Now configure your \fIcustom\fP section in the configuration file as shown in the -config example above. Pacman will now use your package repository. If you add new packages to -the repository, remember to re-generate the database and use pacman's --refresh option. -.SH SEE ALSO -\fBmakepkg\fP is the package-building tool that comes with pacman. -.SH AUTHOR -.nf -Judd Vinet <jvinet@zeroflux.org> -and the Frugalware developers <frugalware-devel@frugalware.org> -.fi |