diff options
Diffstat (limited to 'libpkgconf/README-DEV')
-rw-r--r-- | libpkgconf/README-DEV | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/libpkgconf/README-DEV b/libpkgconf/README-DEV new file mode 100644 index 0000000..5188ab1 --- /dev/null +++ b/libpkgconf/README-DEV @@ -0,0 +1,35 @@ +This document describes how libpkgconf was packaged for build2. In particular, +this understanding will be useful when upgrading to a new upstream version. +See ../README-DEV for general notes on pkgconf packaging. + +Symlink the required upstream files and directories and provide our own +implementations for auto-generated headers: + +$ ln -s ../upstream/{AUTHORS,COPYING} ./ + +$ ln -s ../../upstream/libpkgconf/config.h.cmake.in \ + libpkgconf/config.h.cmake.in.orig + +$ cd libpkgconf && ln -s ../../upstream/libpkgconf/*.{c,h} ./ + +Use libpkgconf/config.h.cmake.in.orig for creating libpkgconf/config.h and +libpkgconf/version.h.in, defining/undefining macros introduced with +#cmakedefine. + +Re-creating libpkgconf/config.h from scratch every time we upgrade to a new +upstream version would be a real pain. Instead we can only (un)define the +newly introduced macros, comparing the already defined and currently used +macro sets: + +$ for m in `cat libpkgconf/config.h.cmake.in.orig | \ + sed -n 's/.*#\s*cmakedefine\s\{1,\}\([_a-zA-Z0-9]\{1,\}\)\(\s.*\)\{0,1\}$/\1/p' | sort -u`; do + if grep -q -e "\b$m\b" `find -L . -name '*.h' -a ! -name config.h -a ! -name version.h -o -name '*.c'`; then + echo "$m" + fi + done >used-macros + +$ cat libpkgconf/config.h | + sed -n 's/#\s*\(define\|undef\)\s\{1,\}\([_a-zA-Z0-9]\{1,\}\)\(\s.*\)\{0,1\}$/\2/p' | + sort -u >defined-macros + +$ diff defined-macros used-macros >diff-macros |