doc/mbuild.8

   1 .\" Manpage for mbuild.
   2 .\" Contact mail@wagnertech.de to correct errors or typos.
   3 .TH mbuild 8 "Jul 2018" GNU "WagnerTech Utilities"
   4 .SH NAME
   5 mbuild \- build system of WagnerTech UG
   6 .SH SYNOPSIS
   7 .B mbuild
   8 .SH DESCRIPTION
   9 .PP
  10 mbuild provides a simple build system based on make, git, subversion. The build process
  11 consists of 3 phases: configuration - compile - pack
  12 .TP
  13 configuration
  14 is done by the
  15 .B mconfigure
  16 script. It determins the verion number from the git/subversion status. A
  17 .B PAKET.changelog
  18 file is needed. Per
  19 default this script also performs compile and pack step.
  20
  21 If a
  22 .B PAKET.prepare
  23 file is present in the debian directory, it is called.
  24
  25 If a
  26 .B PAKET.build
  27 file is present in the debian directory, it is called with a -prepare parameter (deprecated).
  28 The current tree is rsync_ed to ~/build.
  29
  30 If a
  31 .B PAKET.prebuild
  32 file is present in the debian directory, it is called in the ~/build directory.
  33
  34 .TP
  35 compile
  36 To perform the compile step a
  37 .B PAKET.build
  38 script is needed in the
  39 .B debian
  40 directory.
  41 .TP
  42 pack
  43 To perform the pack step a
  44 .B PAKET.cp
  45 script and a
  46 .B PAKET.control
  47 file are needed in the debian directory. If pre/post installation scripts
  48 are needed, these files must be also placed in the
  49 .B debian
  50 directory.
  51 .SH FILES
  52 .TP
  53 PAKET.changelog
  54 Example:
  55 .br
  56 projects (0.2-%BUILD%) unstable; urgency=medium
  57   * Build in svn-Umgebung
  58  -- Michael Wagner <michael@wagnertech.de>  Fr 10. Aug 22:54:48 CEST 2018
  59 .TP
  60 PAKET.prepare
  61 Any executable script file executed in configure step
  62 .TP
  63 PAKET.prebuild
  64 Any executable script file executed in configure step in the ../build directory
  65 .TP
  66 PAKET.build
  67 Any executable script file executing the build in the ../build directory
  68 .TP
  69 PAKET.cp
  70 An executable script file copying the artefacts to target paths preposed by $1:
  71 .br
  72 cp ../build/my_artefact $1/usr/bin/
  73 .TP
  74 PAKET.preinst PAKET.postint PAKET.prerm PAKET.postrm
  75 Optional pre/post installation scripts
  76 .TP
  77 PAKET.control
  78 Debian control file
  79 .PP
  80 These files are expected in a
  81 .B debian
  82 directory, placed below the projects main directory.
  83 .SH SEE ALSO
  84 make(1), mconfigure(1)
  85 .SH BUGS
  86 No known bugs.
  87 .SH AUTHOR
  88 Michael Wagner (michael@wagnertech.de)
  89