File: README.md

package info (click to toggle)
debmake-doc 1.17-7
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 24,612 kB
  • sloc: makefile: 768; sh: 690; ansic: 114; python: 99; sed: 16
file content (104 lines) | stat: -rw-r--r-- 2,621 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
# Generate packaging example log data

The source package examples are here.  These are used to produce log data in advance.

source package name:     debhello
executable command name: hello

## Pre-pre-build

After making manual changes, please make sure to clean tailing white spaces.

 $ make groom

## Pre-build

Prior to the packaging, the up-to-date packaging example logs need to created
as pre-build and committed to the source tree in the testing environment.

This pre-build requires a testing environment with many packages related to
the typical source building infrastructure.

In this sub-directory:

```
 $ sudo apt install\
       autoconf\
       automake\
       autopoint\
       cmake\
       debhelper\
       debmake\
       devscripts\
       gettext\
       gir1.2-gtk-3.0\
       libltdl-dev\
       libtool\
       libxml2-utils\
       lintian\
       locales-all\
       python3-all\
       python3-debian\
       python3-distutils-extra\
       python3-gi\
       quilt\
       tree\
       vim\
       w3m\
       zip
 $ make
 $ make clean
 $ git add -A .
 $ git commit -m "Update example logs"
```

## Debug pre-build for partial build log examples

If you want to create only a partial packaging example logs for
debugging, you can do it as:

```
 $ make prep
 $ cd debhello-1.6_build-1
 $ make
```

## Notes on file organization

### Files in `template/`

This directory contains a set of template files used to be copied to
`debian/*` files of many examples of the packaged source tree.

The changelog file in this template/ is for the latest version of the
package example which is split up properly for each version and copied
accordingly.

### Files in `debhello-<version>/`

Each of these contains an entire set of an example source tree with template
for properly packaged `debian/*` files.

The upstream tarballs used in the packaging example are generated by the tar
command while excluding the debian/ directory.

### Files in `debhello-<version>_build-<revision>/`

These are used to generate the packaging process example.

These contain `step<number>.cmd` files which are executed sequentially and the
results are logged to the step<number>.log files with the script program.

Since the `step<number>.log` files are terminated by `<CR><LF>`, may contain
`<TAB>`, and may be too long, the filtered `step<number>.slog` files are generated.

The `<revision>` is usually 1 and it matches the Debian revision of the binary
packages generated.

If you wish to run script-by-script, you can do the following

```
 $ make step<number>.cmd
```

<!-- vim:se tw=78 sts=4 ts=4 et ai: -->