- Pacman-dev - lists.archlinux.org

[pacman-dev] [PATCH] Clarify that build_options only apply during build()
by Que Quotion 19 Mar '19

19 Mar '19

From: Que Quotion <quequotion(a)gmail.com> The word 'build' can be vague: as a verb in can be used to describe the entire process of rendering a package tarball from a PKGBUILD, while on these lines it refers to a specific PKGBUILD function. We need to more effectively discourage packagers from doing things like generating makefiles in prepare(), where the scripts these options trigger are not called to set or unset their flags. Signed-off-by: Que Quotion <quequotion(a)gmail.com> --- doc/PKGBUILD.5.asciidoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/PKGBUILD.5.asciidoc b/doc/PKGBUILD.5.asciidoc index e8ce691f..416a86a7 100644 --- a/doc/PKGBUILD.5.asciidoc +++ b/doc/PKGBUILD.5.asciidoc @@ -296,23 +296,23 @@ underscore and the architecture name e.g., 'replaces_x86_64=()'. Compress man and info pages with gzip. *ccache*;; - Allow the use of ccache during build. More useful in its negative + Allow the use of ccache during build(). More useful in its negative form `!ccache` with select packages that have problems building with ccache. *distcc*;; - Allow the use of distcc during build. More useful in its negative + Allow the use of distcc during build(). More useful in its negative form `!distcc` with select packages that have problems building with distcc. *buildflags*;; Allow the use of user-specific buildflags (CPPFLAGS, CFLAGS, CXXFLAGS, - LDFLAGS) during build as specified in linkman:makepkg.conf[5]. More + LDFLAGS) during build() as specified in linkman:makepkg.conf[5]. More useful in its negative form `!buildflags` with select packages that have problems building with custom buildflags. *makeflags*;; - Allow the use of user-specific makeflags during build as specified + Allow the use of user-specific makeflags during build() as specified in linkman:makepkg.conf[5]. More useful in its negative form `!makeflags` with select packages that have problems building with custom makeflags such as `-j2` (or higher). -- 2.21.0

2 2

[pacman-dev] [PATCH 0/2] [WIP] Fix du filesize computation
by Santiago Torres 19 Mar '19

19 Mar '19

This patchset is a WIP that tries to address FS#61717[1]. This is my first patch for pacman, so I may be missing a couple of the heuristics of proper pacman develoment. Namely, I'm worried about the use of xargs (I went down this road because I wanted to have the minimal set of changes). I'm not sure what're the heuristics for what I can assume (e.g., can findutils be assumed to exist?). As a followup of this, I removed the configure.ac stuff related to DUPATH and DUFLAGS. I'm not sure if we'd want to add XARGSPATH or so. I opted to not do that just yet. Thanks, -Santiago. [1] https://bugs.archlinux.org/task/61717 Santiago Torres (2): Make makepkg compute sizes properly configure.ac: drop DU* config configure.ac | 10 ---------- scripts/makepkg.sh.in | 3 +-- 2 files changed, 1 insertion(+), 12 deletions(-) -- 2.21.0

4 9

[pacman-dev] [PATCH] Reformatting log timestamp to include time-zone
by Florian Wehner 19 Mar '19

19 Mar '19

The time logged is currently given as localtime without any time-zone information. This is confusing in various scenarios. Examples: * If one is travelling across time-zones and the timestamps in the log appear out of order. * Comparing dates with `datediff` gives an offset by the time-zone This patch would reformat the time-stamp to a full ISO-8601 version. It includes the 'T' separating date and time. This could be removed. Old: [2019-03-04 16:15] New: [2019-03-04T16:15-05:00] Signed-off-by: Florian Wehner <florian(a)whnr.de> --- lib/libalpm/log.c | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/lib/libalpm/log.c b/lib/libalpm/log.c index e46ad3c3..cf869a08 100644 --- a/lib/libalpm/log.c +++ b/lib/libalpm/log.c @@ -20,6 +20,7 @@ #include <stdio.h> #include <stdarg.h> +#include <stdlib.h> #include <errno.h> #include <syslog.h> @@ -37,12 +38,17 @@ static int _alpm_log_leader(FILE *f, const char *prefix) { time_t t = time(NULL); + int tz_h, tz_m; struct tm *tm = localtime(&t); + /* Calculate the timezone offset ±hh:mm */ + tz_h = tm->tm_gmtoff/3600; + tz_m = abs(tm->tm_gmtoff - (tz_h*3600))/60; + /* Use ISO-8601 date format */ - return fprintf(f, "[%04d-%02d-%02d %02d:%02d] [%s] ", + return fprintf(f, "[%04d-%02d-%02dT%02d:%02d%+03d:%02d] [%s] ", tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, - tm->tm_hour, tm->tm_min, prefix); + tm->tm_hour, tm->tm_min, tz_h, tz_m, prefix); } /** A printf-like function for logging. -- 2.21.0

4 8

[pacman-dev] New Optional Dependencies Aren't Logged.
by Ralph Corderoy 17 Mar '19

17 Mar '19

`pacman -Su' suggested an optional dependency of gst-plugins-bad. I looked to see what that was and didn't want it. Later, due to discussion on the local LUG IRC, I wanted to look up what package had the new optional depends but found /var/log/pacman.log didn't record it. Please consider logging them. Looking at the optional depends of all the upgraded packages, I think it was webkit2gtk, but if it were logged then I could check if there were any new optional depends in the more general case, e.g. looking back in time. -- Cheers, Ralph.

3 8

[pacman-dev] [PATCH] scripts: update gitignore for currently noisy files
by Eli Schwartz 12 Mar '19

12 Mar '19

Signed-off-by: Eli Schwartz <eschwartz(a)archlinux.org> --- scripts/.gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/.gitignore b/scripts/.gitignore index b8bb1f83..c511f889 100644 --- a/scripts/.gitignore +++ b/scripts/.gitignore @@ -1,7 +1,9 @@ +.lib/ makepkg makepkg-template pacman-db-upgrade pacman-key +pkgdelta repo-add repo-elephant repo-remove -- 2.21.0

1 1

[pacman-dev] [PATCH] repo-add: use more libmakepkg to handle common compression routines
by Eli Schwartz 12 Mar '19

12 Mar '19

Currently the list of supported formats for an archive, is maintained in two places. And repo-add does not actually get updated. :( In the process, remove some of the logical duplication when calling bsdtar/compress_as. Signed-off-by: Eli Schwartz <eschwartz(a)archlinux.org> --- scripts/repo-add.sh.in | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/scripts/repo-add.sh.in b/scripts/repo-add.sh.in index 57413df5..0f9628ad 100644 --- a/scripts/repo-add.sh.in +++ b/scripts/repo-add.sh.in @@ -44,6 +44,7 @@ CLEAN_LOCK=0 USE_COLOR='y' # Import libmakepkg +source "$LIBRARY"/util/compress.sh source "$LIBRARY"/util/message.sh # ensure we have a sane umask set @@ -188,21 +189,12 @@ verify_signature() { } verify_repo_extension() { - local repofile=$1 - - case $repofile in - *.db.tar.gz) TAR_OPT="z" ;; - *.db.tar.bz2) TAR_OPT="j" ;; - *.db.tar.xz) TAR_OPT="J" ;; - *.db.tar.zst) TAR_OPT="--zstd" ;; - *.db.tar.Z) TAR_OPT="Z" ;; - *.db.tar) TAR_OPT="" ;; + case $1 in + *.db.tar.*|*.db.tar) ;; *) error "$(gettext "'%s' does not have a valid database archive extension.")" \ - "$repofile" + "$1" exit 1 ;; esac - - printf '%s' "$TAR_OPT" } # write an entry to the pacman database @@ -513,7 +505,6 @@ rotate_db() { } create_db() { - TAR_OPT=$(verify_repo_extension "$REPO_DB_FILE") # $LOCKFILE is already guaranteed to be absolute so this is safe dirname=${LOCKFILE%/*} @@ -523,13 +514,13 @@ create_db() { tempname=$dirname/.tmp.$filename pushd "$tmpdir/$repo" >/dev/null - if ( shopt -s nullglob; files=(*); (( ${#files[*]} )) ); then - bsdtar -c${TAR_OPT}f "$tempname" * - else + local files=(*) + if [[ ${files[*]} = '*' ]]; then # we have no packages remaining? zip up some emptyness warning "$(gettext "No packages remain, creating empty database.")" - bsdtar -c${TAR_OPT}f "$tempname" -T /dev/null + files=(-T /dev/null) fi + bsdtar -cf - "${files[@]}" | compress_as "$REPO_DB_SUFFIX" > "$tempname" popd >/dev/null create_signature "$tempname" @@ -644,7 +635,7 @@ else LOCKFILE=$PWD/$REPO_DB_FILE.lck fi -verify_repo_extension "$REPO_DB_FILE" >/dev/null +verify_repo_extension "$REPO_DB_FILE" REPO_DB_PREFIX=${REPO_DB_FILE##*/} REPO_DB_PREFIX=${REPO_DB_PREFIX%.db.*} -- 2.21.0

3 4

[pacman-dev] [PATCH] build: check for gpgme with pkg-config before gpgme-config
by Eli Schwartz 08 Mar '19

08 Mar '19

gpgme in git master now supports pkg-config and with the next release we can and should prefer its use. However, retain the legacy code that enables building with older versions of gpgme, as a fallback. Signed-off-by: Eli Schwartz <eschwartz(a)archlinux.org> --- Since we seem headed for a release soon, I'd like to get this in now even though gpgme is still unreleased. configure.ac | 68 +++++++++++++++++++++------------------ lib/libalpm/libalpm.pc.in | 4 +-- meson.build | 49 +++++++++++++++------------- 3 files changed, 66 insertions(+), 55 deletions(-) diff --git a/configure.ac b/configure.ac index 2f345b5d..74bf8c1f 100644 --- a/configure.ac +++ b/configure.ac @@ -268,37 +268,43 @@ AS_IF([test "x$with_gpgme" != "xno"], [AC_MSG_RESULT([no])]) have_gpgme=no -AS_IF([test "x$with_gpgme" != "xno"], - [AM_PATH_GPGME([1.3.0], - [LIBS_save="$LIBS" - CPPFLAGS_save="$CPPFLAGS" - CFLAGS_save="$CFLAGS" - - LIBS="$LIBS $GPGME_LIBS" - CPPFLAGS="$CPPFLAGS $GPGME_CPPFLAGS" - CFLAGS="$CFLAGS $GPGME_CFLAGS" - - AC_MSG_CHECKING([for sane gpgme]) - AC_LINK_IFELSE( - [AC_LANG_PROGRAM( - [[#include <gpgme.h>]], - [[return gpgme_check_version("1.3.0");]])], - [AC_MSG_RESULT([yes]) - have_gpgme=yes - AC_DEFINE([HAVE_LIBGPGME], [1], [Define if gpgme should be used to provide GPG signature support.])], - [AC_MSG_RESULT([no]) - have_gpgme=no - unset GPGME_LIBS - unset GPGME_CFLAGS] - AS_IF([test "x$with_gpgme" = "xyes"], - [AC_MSG_FAILURE([*** gpgme >= 1.3.0 is needed for GPG signature support])]) - ) - - LIBS="$LIBS_save" - CPPFLAGS="$CPPFLAGS_save" - CFLAGS="$CFLAGS_save" - unset CPPFLAGS_save - unset CFLAGS_save],)]) +if test "x$with_gpgme" != "xno"; then + PKG_CHECK_MODULES(GPGME, [gpgme], + [AC_DEFINE([HAVE_LIBGPGME], [1], [Define if gpgme should be used to provide GPG signature support.]) + AC_SUBST(pc_gpgme, [gpgme]) + have_gpgme=yes], + [AM_PATH_GPGME([1.3.0], + [LIBS_save="$LIBS" + CPPFLAGS_save="$CPPFLAGS" + CFLAGS_save="$CFLAGS" + + LIBS="$LIBS $GPGME_LIBS" + CPPFLAGS="$CPPFLAGS $GPGME_CPPFLAGS" + CFLAGS="$CFLAGS $GPGME_CFLAGS" + + AC_MSG_CHECKING([for sane gpgme]) + AC_LINK_IFELSE( + [AC_LANG_PROGRAM( + [[#include <gpgme.h>]], + [[return gpgme_check_version("1.3.0");]])], + [AC_MSG_RESULT([yes]) + have_gpgme=yes + AC_DEFINE([HAVE_LIBGPGME], [1], [Define if gpgme should be used to provide GPG signature support.]) + AC_SUBST(pc_gpgme_libs, ["$GPGME_LIBS"])], + [AC_MSG_RESULT([no]) + have_gpgme=no + unset GPGME_LIBS + unset GPGME_CFLAGS] + AS_IF([test "x$with_gpgme" = "xyes"], + [AC_MSG_FAILURE([*** gpgme >= 1.3.0 is needed for GPG signature support])]) + ) + + LIBS="$LIBS_save" + CPPFLAGS="$CPPFLAGS_save" + CFLAGS="$CFLAGS_save" + unset CPPFLAGS_save + unset CFLAGS_save],)]) +fi AS_IF([test "x$have_gpgme" = xno -a "x$with_gpgme" = xyes], [AC_MSG_FAILURE([--with-gpgme was given, but gpgme was not found])]) diff --git a/lib/libalpm/libalpm.pc.in b/lib/libalpm/libalpm.pc.in index 6b905747..126a6e6a 100644 --- a/lib/libalpm/libalpm.pc.in +++ b/lib/libalpm/libalpm.pc.in @@ -7,7 +7,7 @@ Name: libalpm Description: Arch Linux package management library URL: http://www.archlinux.org/pacman/ Version: @LIB_VERSION@ -Requires.private: libarchive @pc_crypto@ @pc_libcurl@ +Requires.private: libarchive @pc_crypto@ @pc_libcurl@ @pc_gpgme@ Cflags: -I${includedir} @LFS_CFLAGS@ Libs: -L${libdir} -lalpm -Libs.private: @LIBS@ @GPGME_LIBS@ +Libs.private: @LIBS@ @pc_gpgme_libs@ diff --git a/meson.build b/meson.build index b810e2fb..5512913a 100644 --- a/meson.build +++ b/meson.build @@ -98,29 +98,34 @@ libcurl = dependency('libcurl', conf.set('HAVE_LIBCURL', libcurl.found()) want_gpgme = get_option('gpgme') -gpgme_config = find_program('gpgme-config', required : want_gpgme) -if not want_gpgme.disabled() and gpgme_config.found() - gpgme_version = run_command(gpgme_config, '--version').stdout().strip() - - needed_gpgme_version = '>=1.3.0' - have = gpgme_version.version_compare(needed_gpgme_version) - if want_gpgme.enabled() and not have - error('gpgme @0@ is needed for GPG signature support'.format(needed_gpgme_version)) +gpgme = dependency('gpgme', + required : false, + static : get_option('buildstatic')) +# gpgme recently began providing a pkg-config file. Create a fake dependency +# object if it cannot be found, by manually searching for libs. +if not want_gpgme.disabled() and not gpgme.found() + gpgme_config = find_program('gpgme-config', required : want_gpgme) + if gpgme_config.found() + gpgme_version = run_command(gpgme_config, '--version').stdout().strip() + + needed_gpgme_version = '>=1.3.0' + if gpgme_version.version_compare(needed_gpgme_version) + gpgme_libs = [ + cc.find_library('gpgme', + dirs : [get_option('gpgme-libdir')]), + cc.find_library('gpg-error', + dirs : [get_option('gpgme-libdir')]), + cc.find_library('assuan', + dirs : [get_option('gpgme-libdir')]), + ] + gpgme = declare_dependency(dependencies : gpgme_libs) + endif endif +endif - gpgme_libs = [ - cc.find_library('gpgme', required : have, - dirs : [get_option('gpgme-libdir')]), - cc.find_library('gpg-error', required : have, - dirs : [get_option('gpgme-libdir')]), - cc.find_library('assuan', required : have, - dirs : [get_option('gpgme-libdir')]), - ] - - conf.set('HAVE_LIBGPGME', have) -else - gpgme_libs = [] - conf.set('HAVE_LIBGPGME', false) +conf.set('HAVE_LIBGPGME', gpgme.found()) +if want_gpgme.enabled() and not conf.get('HAVE_LIBGPGME') + error('gpgme @0@ is needed for GPG signature support'.format(needed_gpgme_version)) endif want_crypto = get_option('crypto') @@ -359,7 +364,7 @@ libalpm_a = static_library( 'alpm', libalpm_sources, include_directories : includes, - dependencies : [crypto_provider, libarchive, libcurl] + gpgme_libs, + dependencies : [crypto_provider, libarchive, libcurl, gpgme], link_with : [libcommon], install : true) -- 2.21.0

1 0

[pacman-dev] Upcoming pacman-5.3.0 release
by Allan McRae 07 Mar '19

07 Mar '19

Hi all, I intend to release pacman-5.2.0 soon. Looking at patchwork, there is a few patches that should be handled before then, but these are mostly minor: https://patchwork.archlinux.org/project/pacman/list/?state=* Our bug tracker looks clear for 5.2.0: https://bugs.archlinux.org/roadmap/proj3 Please respond to this email with any bugs or patches not on those lists that should be considered before 5.2.0. I will update transifex so translators can get a head start before the final freeze soon. Allan

1 1

[pacman-dev] [GIT] The official pacman repository branch, master, updated. v5.1.1-149-gc0e9be79
by Allan McRae 07 Mar '19

07 Mar '19

This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "The official pacman repository". The branch, master has been updated via c0e9be7973be6c81b22fde91516fb8991e7bb07b (commit) via e7bb0f8824a916c1537dd83735cd8aeccdcd0f3f (commit) via 40391c564a97b10362ee7cbcf07faac03549d2ca (commit) via 2883b869c72102bf00b4dc14f663c2f322736bc0 (commit) via 9adb0d5b37df7ca668e23877e85431dabeea005e (commit) via 377d47142f7aaa01ca782e6587f2d4caf663865b (commit) via 298bcf7986ca5500c8891ec412d65d8a8f5b9a4f (commit) via e03752e6adc86cbb4cb4f52a38f6e3e98cbe9dd5 (commit) via 0113214db9a9e9ae48bffa3c3e7b39be16e8272a (commit) from d197d8ab82cf10650487518fb968067897a12775 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit c0e9be7973be6c81b22fde91516fb8991e7bb07b Author: Allan McRae <allan(a)archlinux.org> Date: Sat Mar 2 18:57:20 2019 +1000 Remove support for deltas from libalpm Signed-off-by: Allan McRae <allan(a)archlinux.org> commit e7bb0f8824a916c1537dd83735cd8aeccdcd0f3f Author: Allan McRae <allan(a)archlinux.org> Date: Sat Mar 2 18:40:19 2019 +1000 Make pacman forget deltas exist Dummy callbacks are still present to prevent compiler warnings until libalpm is delta free. Also remove Delta parsing from pacman.conf. Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 40391c564a97b10362ee7cbcf07faac03549d2ca Author: Allan McRae <allan(a)archlinux.org> Date: Sat Mar 2 15:41:25 2019 +1000 Remove cleanupdelta Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 2883b869c72102bf00b4dc14f663c2f322736bc0 Author: Allan McRae <allan(a)archlinux.org> Date: Sat Mar 2 15:38:50 2019 +1000 Remove pkgdelta Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 9adb0d5b37df7ca668e23877e85431dabeea005e Author: Allan McRae <allan(a)archlinux.org> Date: Sat Mar 2 15:34:56 2019 +1000 Remove delta support from repo-add Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 377d47142f7aaa01ca782e6587f2d4caf663865b Author: Jelle van der Waa <jelle(a)vdwaa.nl> Date: Thu Feb 21 13:20:19 2019 +0100 doc: add man page for pacman-conf Signed-off-by: Jelle van der Waa <jelle(a)vdwaa.nl> Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 298bcf7986ca5500c8891ec412d65d8a8f5b9a4f Author: Jelle van der Waa <jelle(a)vdwaa.nl> Date: Thu Feb 21 13:22:31 2019 +0100 doc: set rootdir correctly in man pages If an alternative rootdir is specified in either meson or configure it's not respected in the generated man pages. Signed-off-by: Jelle van der Waa <jelle(a)vdwaa.nl> Signed-off-by: Allan McRae <allan(a)archlinux.org> commit e03752e6adc86cbb4cb4f52a38f6e3e98cbe9dd5 Author: Eli Schwartz <eschwartz(a)archlinux.org> Date: Fri Feb 15 11:38:18 2019 -0500 makepkg: add new checksum algorithm via coreutils b2sum coreutils 8.26 in December 2016 added this new hashing method which is compatible with the existing md5sum and sha*sum tool usage, while using the blake2 hash algorithm. makepkg uses coreutils to provide source file integrity checks via ${integ}sum binaries and it makes sense to offer this as an additional option. Signed-off-by: Eli Schwartz <eschwartz(a)archlinux.org> Signed-off-by: Allan McRae <allan(a)archlinux.org> commit 0113214db9a9e9ae48bffa3c3e7b39be16e8272a Author: morganamilo <morganamilo(a)gmail.com> Date: Wed Mar 6 22:52:19 2019 +0000 pacman: fix segfault when Usage is specified without a value And extract all the common code to a macro. Signed-off-by: morganamilo <morganamilo(a)gmail.com> Signed-off-by: Allan McRae <allan(a)archlinux.org> ----------------------------------------------------------------------- Summary of changes: README | 1 - doc/Makefile.am | 8 +- doc/PKGBUILD.5.asciidoc | 2 +- doc/index.asciidoc | 1 - doc/makepkg.conf.5.asciidoc | 2 +- doc/meson.build | 3 +- doc/pacman-conf.8.asciidoc | 67 +++++++ doc/pacman.8.asciidoc | 2 +- doc/pacman.conf.5.asciidoc | 8 - doc/pkgdelta.8.asciidoc | 53 ----- doc/repo-add.8.asciidoc | 22 +-- etc/makepkg.conf.in | 2 +- etc/pacman.conf.in | 1 - lib/libalpm/Makefile.am | 1 - lib/libalpm/alpm.h | 53 ----- lib/libalpm/be_sync.c | 21 +- lib/libalpm/delta.c | 361 ----------------------------------- lib/libalpm/delta.h | 33 ---- lib/libalpm/error.c | 5 - lib/libalpm/handle.c | 20 -- lib/libalpm/handle.h | 5 - lib/libalpm/meson.build | 1 - lib/libalpm/package.c | 14 -- lib/libalpm/package.h | 2 - lib/libalpm/po/POTFILES.in | 1 - lib/libalpm/sync.c | 207 +------------------- meson.build | 8 - scripts/.gitignore | 1 - scripts/Makefile.am | 3 - scripts/libmakepkg/util/schema.sh.in | 2 +- scripts/makepkg.sh.in | 2 +- scripts/meson.build | 1 - scripts/pkgdelta.sh.in | 234 ----------------------- scripts/po/POTFILES.in | 1 - scripts/repo-add.sh.in | 168 +--------------- src/pacman/callback.c | 19 -- src/pacman/conf.c | 63 ++---- src/pacman/conf.h | 1 - src/pacman/pacman-conf.c | 13 -- src/pacman/po/POTFILES.in | 1 - src/pacman/sync.c | 5 +- src/util/.gitignore | 2 - src/util/Makefile.am | 5 +- src/util/cleanupdelta.c | 135 ------------- src/util/meson.build | 1 - 45 files changed, 126 insertions(+), 1435 deletions(-) create mode 100644 doc/pacman-conf.8.asciidoc delete mode 100644 doc/pkgdelta.8.asciidoc delete mode 100644 lib/libalpm/delta.c delete mode 100644 lib/libalpm/delta.h delete mode 100644 scripts/pkgdelta.sh.in delete mode 100644 src/util/cleanupdelta.c hooks/post-receive -- The official pacman repository

1 0

[pacman-dev] [PATCH] doc: add man page for pacman-conf
by Jelle van der Waa 07 Mar '19

07 Mar '19

Signed-off-by: Jelle van der Waa <jelle(a)vdwaa.nl> --- doc/Makefile.am | 3 +- doc/pacman-conf.8.asciidoc | 60 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 doc/pacman-conf.8.asciidoc diff --git a/doc/Makefile.am b/doc/Makefile.am index de87c409..f68f4ea0 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -16,7 +16,8 @@ MANPAGES = \ makepkg.conf.5 \ pacman.conf.5 \ libalpm.3 \ - BUILDINFO.5 + BUILDINFO.5 \ + pacman-conf.8 DOXYGEN_MANS = $(wildcard man3/*.3) diff --git a/doc/pacman-conf.8.asciidoc b/doc/pacman-conf.8.asciidoc new file mode 100644 index 00000000..0e4c96be --- /dev/null +++ b/doc/pacman-conf.8.asciidoc @@ -0,0 +1,60 @@ +pacman-conf(8) +============== + +Name +---- +pacman-conf - query pacman's configuration file + + +Synopsis +-------- +'pacman-conf' [options] [<directive> ...] + + +Description +----------- +The 'pacman-conf' utility is created since parsing pacman's configuration file +is non-trivial and extremely difficult to do correctly from scripts. It makes it +easy for scripts to get the same configuration value which pacman itself would +use. + + +Options +------- +*-c, \--config* <path>:: + Specify an alternate configuration file. + +*-R, \--rootdir* <path>:: + Specify an alternate installation root (default is `/`). + +*-r, \--repo* <remote>:: + Query options for a specific repository. + +*-v, \--verbose*:: + Always shown directive names. + +*-l, \--repo-list*:: + List configured repositories. + +*-V, \--version*:: + Display version and exit. + +*-h, \--help*:: + Output syntax and command line options. + + +Examples +-------- + +pacman-conf -r core Usage:: + Show the value of the Usage configuration option for core repository. + +pacman-conf HoldPkg:: + Show the value of the HoldPkg configuration option. + + +See Also +-------- +linkman:pacman.conf[5] + +include::footer.asciidoc[] -- 2.20.1

3 6