On Tue, 08 Sep 2015 09:23:51 -0400 Antoine Beaupré wrote: > > How does it differ from the package that Gianfranco and Marc have been > working on? (In cc.) > > A.
It doesn't necessarily "differ" in the sense that it would be a different from-scratch packaging. It is 95% their package, plus a few lines in d/rules and one patch in d/patches to accomodate for the differences between upstream git and upstream tarball. My Idea was that instead of just saying "regenerate those files" I wanted to add a stance saying "and it could work somewhat like this", in order to have a discussion on whether my Idea makes sense, and not on the basis of whether it even works. The only differences are: (1) Repository layout "branch off the main repo" I didn't use upstream tarball, but rather depended only on the git tag (which doesn't contain the generated files I spoke of earlier, but it contains the code to re-generate them) Basically I followed this: http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.import.html#GBP.IMPORT.UPSTREAM.GIT.NOTARBALL (2) Rebuilding .c and .rst.inc files By using the upstream git directly, we can use the upstream build system (which already calls cython and sphinx) to generate the .c sources and the .rst.inc for the html manual. Some environment-variable-setting in d/rules was necessary to call the upstream docs/Makefile, to make sure it can call "borg help COMMAND --usage-only" during the generation of the .rst.inc files. (3) Patch to remove travis and codecov badges README.rst in git contains images that say "code coverage xyz%" and "travis build [passing/failing]". I didn't think they are of relevance to a Debian user (since they reflect current git status, not the version installed) plus it may be a privacy concern to load external resources when browsing the local copy of the manual. I also think that by using upstream git directly, we get the advantage of directly being able to use git-bisect/git-cherry-pick for identifying and backporting fixes to the stable version, which may come in handy later on. Danny