[SCM] Packaging for bam branch, master, updated. upstream/0.4.0-18-g6a4b7af

[Felix Geyer]

The following commit has been merged in the master branch:
commit 6a4b7af4891c448ec7e8c48a0601bb391b875dc4
Author: Felix Geyer <debfx-pkg at fobos.de>
Date:   Mon May 9 14:22:03 2011 +0200

    Update man page.

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..8bc018d
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,4 @@
+Updating the manpage
+====================
+
+help2man --section=1 --name="fast and flexible build system" --version-string="VERSION_STRING" --no-info bam | sed -r 's/( VERSION_STRING| version [0-9]\.[0-9]\.[0-9]\. built .+ using Lua [0-9]\.[0-9])//g' > bam.1
diff --git a/debian/bam.1 b/debian/bam.1
index 75c849b..31ea938 100644
--- a/debian/bam.1
+++ b/debian/bam.1
@@ -1,47 +1,85 @@
-.TH BAM 1
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.4.
+.TH BAM "1" "May 2011" "bam" "User Commands"
 .SH NAME
-bam \- A fast and flexible build system
+bam \- fast and flexible build system
 .SH SYNOPSIS
-.B bam \-
-[options]
+.B bam
+[\fIOPTION\fR]... [\fIVARIABLE=VALUE\fR]... [\fITARGET\fR]...
 .SH DESCRIPTION
-Bam uses Lua to describe the build process. It's takes its inspiration for
-the script files from scons. While scons focuses on being 100% correct when
-building, bam makes a few sacrifices to acquire fast full and incremental
-build times. 
-.SH OPTIONS
-.TP
-.B \-c
-Clean. Removes all output files for the specified targets
-.TP
-.B \-f
-Force. Forces all files to be dirty and causes a complete rebuild.
-.TP
-.B \-b filename
-Base script. Specifices the base script to use instead of the builtin.
-.TP
-.B \-s filename
-Script. Specifices the bam file to use.
-.TP
-.B \-j X
-Use X threads when building. (EXPRIMENTAL!)
-.TP
-.B \-v
-Verbose. Prints all commands that bam executes.
-.TP
-.B \-\-dry
-Dry run. Does not do anything except load the scripts. Don't build any targets.
-
-.SH SEE ALSO
-On your system:
-.I /usr/share/doc/bam 
-
-Homepage at:
-.I http://teeworlds.com/trac/bam/wiki 
-
-Please report all bugs to the Debian Bug Tracking System (see: 
-.IR http://www.debian.org/Bugs ) 
-
-.SH AUTHORS
-.I Magnus Auvinen
-Magnus Auvinen (C) 2008
+Builds applications using the bam build system.
+.IP
+Execution:
+.TP
+\fB\-a\fR
+abort on error
+.TP
+\fB\-c\fR
+clean targets
+.TP
+\fB\-d\fR
+build targets that is dependent given targets
+.TP
+\fB\-\-dry\fR
+dry run, don't run any jobs
+.TP
+\fB\-j\fR
+sets the number of threads to use (default: 0, disabled)
+.TP
+\fB\-s\fR
+bam file to use (default: bam.lua)
+.IP
+Lua:
+.TP
+\fB\-l\fR
+print local variables in backtrace
+.TP
+\fB\-t\fR
+print backtrace when an error occurs
+.IP
+Output:
+.TP
+\fB\-r\fR
+build progress report format (default: s)
+b = progress bar
+c = use ansi colors
+s = build steps
+.TP
+\fB\-v\fR
+be verbose
+.IP
+Other:
+.TP
+\fB\-n\fR
+don't use cache
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+prints this help
+.IP
+Debug:
+.TP
+\fB\-\-debug\-nodes\fR
+prints all the nodes with dependencies
+.TP
+\fB\-\-debug\-detail\fR
+prints all the nodes with dependencies and details
+.TP
+\fB\-\-debug\-jobs\fR
+prints all the jobs that exist
+.TP
+\fB\-\-debug\-dot\fR
+prints all nodes as a graphviz dot file
+.TP
+\fB\-\-debug\-jobs\-dot\fR
+prints all jobs as a graphviz dot file
+.TP
+\fB\-\-debug\-trace\-vm\fR
+prints a line for every instruction the vm makes
+.TP
+\fB\-\-debug\-dump\-int\fR
+prints the internals scripts to stdout
+.TP
+\fB\-\-debug\-no\-int\fR
+don't load internal scripts
+.PP
+bam version 0.4.0. built Apr 16 2011 15:38:46 using Lua 5.1
+by Magnus Auvinen (magnus.auvinen at gmail.com)
diff --git a/debian/changelog b/debian/changelog
index d75af84..7a98ebc 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -12,6 +12,7 @@ bam (0.4.0-1) UNRELEASED; urgency=low
   * Enable test suite.
     - Add test-error-exit-code.diff to make it exit with an error on
       test failure.
+  * Update man page.
 
  -- Felix Geyer <debfx-pkg at fobos.de>  Sat, 16 Apr 2011 10:34:53 +0200
 

-- 
Packaging for bam