~ubuntu-branches/ubuntu/wily/debmake/wily-proposed

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Package Import Robot
  • Author(s): Osamu Aoki
  • Date: 2015-04-19 12:39:55 UTC
  • mfrom: (1.2.1) (20.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20150419123955-tw70ceypk1acdjz0
Tags: 4.2.0-1
* Allow single -dbg package case for bin+lib > 1.
* Fix copyright holder list generation. Closes: #782850 
* Delayed execution of dpkg-buildflags to make DEB_*_MAINT_APPEND
  effective is activated only for Vala.
* No more CPPFLAGS workaround for cmake.
* Make template file messages more consistent.
* -b option argument drops white spaces .
* Refine the auto-generated file handling.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
debmake for Debian
2
2
------------------
3
3
 
4
 
The debmake command is helper script to generate basic Debian packaging files
5
 
using debhelper version 9 or newer.  See README.tutorial, README.multi and
6
 
debmake(1) for more.
 
4
The debmake command is a helper script to generate basic Debian packaging files
 
5
using debhelper version 9 or newer with multiarch conscious way.  See the
 
6
debmake(1) manpage in this package and the HTML documentation provided in the
 
7
debmake-doc package for more.
7
8
 
8
9
The debmake command is written in python and is intended to replace functions
9
 
offered by deb-make and dh_make commands.
 
10
traditionally offered by deb-make and dh_make commands.
10
11
 
11
12
This new debmake package has debmake as its command and starts its version from
12
13
4.0 to avoid version overlaps.
23
24
Rationale for debmake
24
25
---------------------
25
26
 
26
 
debmake was created to address shortcomings of dh_make(1).
27
 
 
28
 
The initial targets
29
 
-------------------
30
 
 
31
 
 * make functioning binary packages directly with no user input
32
 
   - from upstream VCS (autotools, setup.py, ...)
33
 
     - setup.py means auto conversion from PyPI 
34
 
       https://pypi.python.org/pypi to Debian debs.
35
 
     - make dist
36
 
   - from upstream tarball
37
 
   - help migration from native to non-native package
38
 
   - multi-arch aware
39
 
 * make multi binary packages with flexible combinations
40
 
 * make packages with hardening turned on
41
 
 * efficient generation of debian/copyright
42
 
   - use licensecheck(1) but do more
 
27
debmake was created to address shortcomings of dh_make(1): Notably:
 
28
 * semi-automatic scanning of copyright
 
29
 * flexible combination of binary package types
 
30
 * multiarch aware
 
31
 * friendly for the hardening of compiler flags
 
32
 * almost automatic process from the upstream VCS (autotools, setup.py, ...)
 
33
 * help upstream to manage the non-native package
43
34
 
44
35
The design guide line of debmake
45
36
--------------------------------
46
37
 
47
38
 * Keep it simple.
48
 
 * Use the new dh syntax.  (No cdbs.)
 
39
 * Use the new dh syntax.  (No cdbs nor any make file inclusion system)
49
40
 * The basic ability of dh_make (and its predecessor deb-make) should be
50
 
   covered.  (debmake intends to replace them.)
51
 
 * The debmake command should require no or minimum arguments to do useful things.
52
 
 * The debmake command should help reviewing of the license for all source files.
 
41
   covered.  (The debmake command intends to replace them.)
 
42
 * The debmake command should require no or minimum arguments to do useful 
 
43
   things.
 
44
 * The debmake command should help reviewing of the license for all source 
 
45
   files.
53
46
 * The program structure should be friendly for adding the GUI.
54
47
 * The native build system of the upstream source should be identified and
55
48
   utilized.
56
49
 * The debmake command should make it easy to create various combinations of
57
 
   binary packages in multi-arch compatible ways.
 
50
   binary packages in the multiarch compatible way.
58
51
 * The debmake command should not overwrite existing files by default.
59
 
 * The debmake command should not generate non-essential template files as default
60
 
   except for the first run in which normal template files are generated.
 
52
 * The debmake command should not generate non-essential template files as
 
53
   default except for the first run in which normal template files are 
 
54
   generated.
61
55
 
62
 
 -- Osamu Aoki <osamu@debian.org>  Sun, 12 Jan 2014 07:21:13 +0000
 
56
 -- Osamu Aoki <osamu@debian.org>  Sun, 14 Dec 2014 17:11:26 +0000