deluge/docs/source/devguide/packaging/launchpad-recipe.md
Calum Lind 82ecf8a416 [Docs] Reorganise and add sections from wiki
- Change the layout and contents of docs to be better organised and
  follow ideas from: https://www.divio.com/blog/documentation/
- Use markdown for non-technical documents to speed up writing.
- Added new sections and imported documents from Trac wiki.

Build fixes:

- Added a patch to fix recommonmark 0.4 and doc referencing:
    https://github.com/rtfd/recommonmark/issues/93
- Set docs build in tox to Py2.7 since there are problems with autodoc
  mocking multiple inheritance on Python 3 resulting in metaclass errors.
- Supressed warning about `modules.rst` not in the toctree by creating
  a static `modules.rst` with `:orphan:` file directive and add to git.
  Also skip creating this toc file with sphinx-apidoc in setup and tox.
- Simplified finding exported RPC and JSON API methods by adding an
  autodoc custom class directive. Removed unneeded __rpcapi.py.
2018-11-01 17:38:10 +00:00

44 lines
1.4 KiB
Markdown

# Launchpad recipe
The launchpad build recipes are for build from source automatically to provide
ubuntu packages. They are used to create daily builds of a git repo branch.
Note these don't have the same control as a creating a publishing to PPA.
Main reference: https://help.launchpad.net/Packaging/SourceBuilds/Recipes
## Deluge launchpad build recipes
Recipe configuration: https://code.launchpad.net/~deluge-team/+recipes
An example for building the develop branch:
# git-build-recipe format 0.4 deb-version 2.0.0.dev{revno}+{git-commit}+{time}
lp:deluge develop
nest-part packaging lp:~calumlind/+git/lp_deluge_deb debian debian develop
There are two parts, first to get the source code branch and then the `debian`
files for building the package.
## Testing and building locally
Create a `deluge.recipe` file with the contents from launchpad and create the
build files with `git-build-recipe`:
git-build-recipe --allow-fallback-to-native deluge.recipe lp_build
Setup [pbuilder] and build the deluge package:
sudo pbuilder build lp_build/deluge*.dsc
Alternatively to build using local files with [pdebuild]:
cd lp_build/deluge/deluge
pdebuild
This will allow modifying the `debian` files to test changes to `rules` or
`control`.
[pbuilder]: https://wiki.ubuntu.com/PbuilderHowto
[pdebuild]: https://wiki.ubuntu.com/PbuilderHowto#pdebuild