[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