Fixed installation process with the GNU Build System

Using a custum build system is not portable and it does not have all features
that required the [GNU Coding Standards][0].

In order to come as close as possible to the [GNU Coding Standards][0]. Using
[autotools][1] is a good practice.

There are some changes:

* the python library of this package is private so it does not install under
  the standard python `site-package` directory but on `pkglibdir`
  (default: `/usr/local/lib/cyg-apt`)

* to build from source it requires the `automake` package

* the build process command line:

  Before:

      $ make

  After:

      $ autoreconf -i && ./configure && make

* the tests suite command line:

  Before:

      $ make test

  After:

      $ make check

* the installation tests suite command line:

  Before:

      $ make installtest

  After:

      $ make installcheck

[0]: http://www.gnu.org/prep/standards/standards.html#Makefile-Conventions
[1]: http://www.gnu.org/software/automake/manual/automake.html#Autotools-Introduction

Author: alquerci

.gitignore

@@ -3,4 +3,3 @@ dist
 *.pyc
 .*
 *~
-/src/cygapt/version.py

.travis.yml

@@ -4,11 +4,10 @@ python:
     - "2.6"
     - "2.7"
 
-install:
-    - make PYTHON=python
-
 script:
-    - make test PYTHON=python
+    - autoreconf -i
+    - ./configure
+    - make distcheck
 
 notifications:
     email: false

INSTALL.md

@@ -0,0 +1,21 @@
+SUBDIRS = src doc tools
+
+DIST_SUBDIRS = $(SUBDIRS) \
+    build-aux
+
+dist_doc_DATA = \
+    AUTHORS \
+    CONTRIBUTING.md \
+    CONVENTIONS.md \
+    COPYING \
+    ChangeLog \
+    INSTALL.md \
+    LICENSE \
+    NEWS.md \
+    TODO \
+    README.md
+
+ACLOCAL_AMFLAGS = -I m4
+
+dist-hook:
+	echo '$(VERSION)' > $(distdir)/version

Makefile

@@ -20,3 +20,12 @@ News
 
       - `<cachedir>/<mirror>/<arch>/setup.ini`
 
+* 1.1.0 ()
+
+  * the python library of this package is private so it does not install under
+    the standard python `site-package` directory but on `pkglibdir`
+    (default: `/usr/local/lib/cyg-apt`)
+
+  * to build from source it requires the `automake` package
+
+  * the build command line: `autoreconf -i && ./configure && make`

Makefile.am

@@ -20,18 +20,32 @@ Requirements
 Build requirements
 ------------------
 
-* `make` 3.80+
-* `git` 1.7+
+* `make` 3.59+
+
+From source:
+
+    * `automake` 1.9+
 
 
 Install instructions
 --------------------
 
-Briefly the following commands should build, test and install this package.
+From source please run `autoreconf` first to generate all required build scripts:
+
+    $ autoreconf -i
+
+Briefly the following commands should configure, make and install this package:
+
+    $ ./configure && make && make install
+
+Some features can be enable by giving to `configure` the option `--enable-FEATURE[=ARG]`:
+
+  * If you want to install the **bash-completion** script then set the `--enable-bash-completion=DIR` option.
+    Where `DIR` may be one of the following directories:
 
-    $ make
-    $ make test
-    $ make install
+    - `pkg-config --variable=completionsdir bash-completion`
+    - `${BASH_COMPLETION_DIR}`
+    - `/etc/bash_completion.d`
 
 See the [`INSTALL.md`](INSTALL.md) file for more detailed instructions.
 

NEWS.md

@@ -3,6 +3,8 @@ environment:
         CYG_ROOT: C:/cygwin
         CYG_MIRROR: http://cygwin.uib.no
         CYG_CACHE: C:/cygwin/var/cache/setup
+        # need to set DJDIR because bash fail to read the file descriptor 0
+        DJDIR: /
 
     matrix:
         -
@@ -73,23 +75,24 @@ install:
     - 'if not "%PYTHON_PLATFORM%" == "cygwin" powershell ./.appveyor/install.ps1'
     - 'if not "%PYTHON_PLATFORM%" == "cygwin" dir "C:/python*"'
     - 'appveyor DownloadFile http://cygwin.com/setup-%CYG_ARCH%.exe -FileName setup.exe'
-    - 'setup.exe -qnNdO -R "%CYG_ROOT%" -s "%CYG_MIRROR%" -l "%CYG_CACHE%" -P make -P python -P gnupg > NUL'
+    - 'setup.exe -qnNdO -R "%CYG_ROOT%" -s "%CYG_MIRROR%" -l "%CYG_CACHE%" -P make -P python -P gnupg -P automake > NUL'
     - '%CYG_ROOT%/bin/bash -lc "cygcheck -dc cygwin"'
     - '%PYTHON% --version'
     - '%PYTHON% -c "import sys; print(''Python architecture: {0}''.format(''x64'' if sys.maxsize > 2**32 else ''x86''))"'
     - '%PYTHON% -c "import sys; print(''Python platform: {0}''.format(sys.platform));"'
     - 'if "2.6" == "%PYTHON_VERSION%" appveyor DownloadFile https://raw.githubusercontent.com/bewest/argparse/master/argparse.py -FileName %PYTHON_DIR%/Lib/site-packages/argparse.py'
 
 build_script:
-    - '%CYG_ROOT%/bin/bash -lc "cd \"$OLDPWD\"; make PYTHON=\"$PYTHON\""'
+    - '%CYG_ROOT%/bin/bash -lc "cd $OLDPWD; autoreconf -i"'
+    - '%CYG_ROOT%/bin/bash -lc "cd $OLDPWD; ./configure PYTHON=$PYTHON"'
+    - '%CYG_ROOT%/bin/bash -lc "cd $OLDPWD; make"'
 
 test_script:
-    - '%CYG_ROOT%/bin/bash -lc "cd \"$OLDPWD\"; make test PYTHON=\"$PYTHON\""'
-    - '%CYG_ROOT%/bin/bash -lc "cd \"$OLDPWD\"; make install"'
-    - '%CYG_ROOT%/bin/bash -lc "cd \"$OLDPWD\"; make installtest PYTHON=\"$PYTHON\""'
+    - '%CYG_ROOT%/bin/bash -lc "cd $OLDPWD; make distcheck DISTCHECK_CONFIGURE_FLAGS=PYTHON=$PYTHON"'
+    - '%CYG_ROOT%/bin/bash -lc "cd $OLDPWD; cd src; /usr/bin/python cyg-apt setup -q"'
     - ps: 'cp $env:CYG_ROOT/home/$env:USERNAME/.cyg-apt -destination $env:HOMEPATH'
-    - '%PYTHON% %CYG_ROOT%/bin/cyg-apt update -qX'
-    - '%PYTHON% %CYG_ROOT%/bin/cyg-apt ball cygwin> ball~'
+    - '%PYTHON% src/cyg-apt update -qX'
+    - '%PYTHON% src/cyg-apt ball cygwin> ball~'
     - ps: 'Get-Content ball~ | set path; cmd /c $env:CYG_ROOT/bin/cygpath -w $path> ball~'
     - ps: 'Get-Content ball~'
     - ps: 'if (-not(Get-Content ball~ | Test-Path)) { Exit 1 }'

README.md

@@ -0,0 +1 @@
+EXTRA_DIST = git-version-gen