README.md 2.64 KB
Newer Older
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
1 2
## Introduction

Ruben Rodriguez's avatar
Ruben Rodriguez committed
3 4 5 6 7
This set of scripts are helpers that modify and compile those packages coming
from the Ubuntu upstream which need it. It might be because they contain
non-free stuff, references to Ubuntu that need to be changed, or because we
want the package to work our way.

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
8
This helpers are similar to some of those in the [gNewSense](http://www.gnewsense.org/Builder/HowToCreateourOwnGNULinuxDistribution) builder, we took
Ruben Rodriguez's avatar
Ruben Rodriguez committed
9 10 11 12 13
some ideas and even some lines from them. If you plan to build an Ubuntu
derivative of your own, we suggest you to use Builder instead of this helpers.

All packages in this list are in the appropriate blacklist in the repository
updater, so they never enter into the repo from upstream and need to be
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
14 15
compiled with this helpers and pushed into reprepro. This helpers also need
to be run by hand - and the results tested - any time the repo watchdog warns
Ruben Rodriguez's avatar
Ruben Rodriguez committed
16 17
about pending updates from upstream.

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
18 19 20
To add a package to the list, just copy one - `make-apache2` is a good template -
and rename it to `make-sourcePackageName`. To send the file back to us, or to
include any modification into the current scripts, use `bzr diff` and send
Ruben Rodriguez's avatar
Ruben Rodriguez committed
21 22 23
the output as an attachment to trisquel-devel@listas.trisquel.info. You need
to join the mailing list to send messages to it.

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
24
## Recommendations
Ruben Rodriguez's avatar
Ruben Rodriguez committed
25

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
26 27 28
* Take care to use the right sourcePackageName, many source packages produce
several binary packages. `apt-cache showsrc binary-package` can help you.
* If possible, use sed to replace chains in the upstream source without the
Ruben Rodriguez's avatar
Ruben Rodriguez committed
29
need of external files or patches. If you really need to include a file, place
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
30 31
it at the `DATA/sourcePackageName` directory
* Do not replace *all* references to Ubuntu in the package, just those that
Ruben Rodriguez's avatar
Ruben Rodriguez committed
32
would actually be shown to the user. Avoid replacing copyright statements!
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
33
* Try to write your replacements in a way they might work in future versions
Ruben Rodriguez's avatar
Ruben Rodriguez committed
34
of the upstream package. Well written regexps and sed will help with that.
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
35 36 37
* Some of this packages require the lsb to match Trisquel values. Edit the
`/etc/lsb_release` accordingly, or run the helpers in a Trisquel box.
* You can - and maybe should - run this scripts inside a chroot.
Ruben Rodriguez's avatar
Ruben Rodriguez committed
38

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
39
## Netinstall
Ruben Rodriguez's avatar
Ruben Rodriguez committed
40 41 42 43 44 45 46

Included are the set of scipts used to generate the network installer images
found in Trisquel GNU/Linux LTS (version 2.0, 4.0, 6.0... and up). The scripts
may not be available for all versions.

To generate the images, we run the following scripts:

Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
47 48 49 50 51 52 53
* `make-apt-setup`
* `make-base-installer`
* `make-choose-mirror`
* `make-main-menu`
* `make-netcfg`
* `make-net-retriever`
* `make-pkgsel`
Ruben Rodriguez's avatar
Ruben Rodriguez committed
54 55

Then we push the results into the Trisquel repository and run the script
Lars-Magnus Skog's avatar
Lars-Magnus Skog committed
56
`make-debian-installer` to build the final images.