[Lsb-messages] /var/www/bzr/lsb/devel/repogen r197: Add some documentation for the new Debian system.
Jeff Licquia
licquia at linuxfoundation.org
Thu Jun 13 15:00:09 UTC 2013
------------------------------------------------------------
revno: 197
committer: Jeff Licquia <licquia at linuxfoundation.org>
branch nick: repogen
timestamp: Thu 2013-06-13 08:00:09 -0700
message:
Add some documentation for the new Debian system.
modified:
README
-------------- next part --------------
=== modified file 'README'
--- a/README 2007-06-01 00:26:36 +0000
+++ b/README 2013-06-13 15:00:09 +0000
@@ -98,6 +98,13 @@
Debian packages aren't built by default in the standard package build, and
they impose greater requirements on the build host.
+There are actually two systems for building Debian packages: an old way, which
+didn't work well but which needed little more than make and Python, and a new
+way, partially written in Haskell. For this new way, you'll need GHC (the
+most popular Haskell compiler). The new way has its own Makefile currently,
+and doesn't work within the rest of the framework yet; we hope to fix that
+soon.
+
Requirements
------------
@@ -105,6 +112,8 @@
- A recent Python.
+ - The Glasgow Haskell Compiler (ghc).
+
- The dpkg, apt, and alien tools. These are usually provided in
"dpkg" and "alien" packages. Note that a Debian system is not
required, as long as the dpkg tools are provided. For example, the
@@ -115,19 +124,24 @@
Usage
-----
-Specify "BUILD_DEBIAN=yes" as one of the values you override when running
-make.
+For the old way, just run "make" with the appropriate options, similarly to
+the way the RPM system works. Specify "BUILD_DEBIAN=yes" as one of the values
+you override when running make.
+
+For the new way, run "make -f Makefile-haskell". Mostly, this will just try
+to refresh anything. The new way is smart about not regenerating packages
+that have already been converted, so it should be safe to run frequently.
Results
-------
-In "repo/repos/debian", you'll end up with a complete apt repository. As with
-the yum and urpmi repos, you should copy this entire tree as a unit, and
-preserve relative paths under "repo/repos/debian". Running "make install"
-will do this if BUILD_DEBIAN is set.
+In "deb/debian", you'll end up with a complete apt repository. As with the
+yum and urpmi repos, you should copy this entire tree as a unit, and preserve
+relative paths under "deb/debian". Running "make install" will do this if
+BUILD_DEBIAN is set.
Once you've found a home for those files, you can use sources.list lines like
this to get apt to work:
-deb <url_to_debian_repos> lsb main
+deb <url_to_debian_repos> lsb-<version> main
More information about the lsb-messages
mailing list