posaune

[projects.git] / doc / mbuild.8

diff --git a/doc/mbuild.8 b/doc/mbuild.8
index 0f7b4f16fe3c0c992a46e9916271568f157e69e0..3209b7b6e6f3265f12c451555c385cdb0eba2c54 100644 (file)
--- a/doc/mbuild.8
+++ b/doc/mbuild.8
@@ -1,6 +1,6 @@
 .\" Manpage for mbuild.
 .\" Contact mail@wagnertech.de to correct errors or typos.
 .\" Manpage for mbuild.
 .\" Contact mail@wagnertech.de to correct errors or typos.

-.TH man 8 "12 Jul 2018" "0.1" "mbuild man page"
+.TH mbuild 8 "Jul 2018" GNU "WagnerTech Utilities"

 .SH NAME
 mbuild \- build system of WagnerTech UG
 .SH SYNOPSIS
 .SH NAME
 mbuild \- build system of WagnerTech UG
 .SH SYNOPSIS


@@ -13,25 +13,59 @@ consists of 3 phases: configuration - compile - pack
 configuration
 is done by the
 .B mconfigure
 configuration
 is done by the
 .B mconfigure

-script. It determins the verion number from the git/subversion status. Per 
+script. It determins the verion number from the git/subversion status. A
+.B PAKET.changelog
+file is needed. Per 

 default this script also performs compile and pack step.
 default this script also performs compile and pack step.

+
+If a
+.B PAKET.build
+file is present in the debian directory, it is called with a -prepare parameter.

 .TP
 compile
 To perform the compile step a
 .B PAKET.build
 .TP
 compile
 To perform the compile step a
 .B PAKET.build

-script is needed in the debian directory.
+script is needed in the 
+.B debian 
+directory.

 .TP
 pack
 To perform the pack step a
 .B PAKET.cp
 .TP
 pack
 To perform the pack step a
 .B PAKET.cp

-script is needed in the debian directory.
-
+script and a
+.B PAKET.control
+file are needed in the debian directory. If pre/post installation scripts
+are needed, these files must be also placed in the
+.B debian 
+directory.

 .SH FILES
 .SH FILES

+.TP
+PAKET.changelog
+Example:
+.br
+projects (0.2-%BUILD%) unstable; urgency=medium
+  * Build in svn-Umgebung
+ -- Michael Wagner <michael@wagnertech.de>  Fr 10. Aug 22:54:48 CEST 2018
+.TP

 PAKET.build
 PAKET.build

-
+Any executable script file executing the build in the ../build directory
+.TP

 PAKET.cp
 PAKET.cp

+An executable script file copying the artefacts to target paths preposed by $1:
+.br
+cp ../build/my_artefact $1/usr/bin/
+.TP
+PAKET.preinst PAKET.postint PAKET.prerm PAKET.postrm
+Optional pre/post installation scripts
+.TP
+PAKET.control
+Debian control file
+.PP
+These files are expected in a
+.B debian
+directory, placed below the projects main directory.

 .SH SEE ALSO
 .SH SEE ALSO

-make(1), mconfigure(8) 
+make(1), mconfigure(1)

 .SH BUGS
 No known bugs.
 .SH AUTHOR
 .SH BUGS
 No known bugs.
 .SH AUTHOR