CMXSL.org/package-helpers-cmxsl
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge branch 'belenos' into 'belenos'

Browse source 
README -> README.md

Since these repositories are hosted on `gitlab` I thought it was nice to have the `README` in markdown format.

See merge request !48
This commit is contained in:
Ruben Rodriguez 2015-01-24 21:27:52 +00:00
commit 7f4a3a0f70
1 changed files with 27 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

53
README → README.md
View file

@ -1,41 +1,42 @@
## Introduction
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.
This helpers are similar to some of those in the gNewSense builder[1], we took
This helpers are similar to some of those in the [gNewSense](http://www.gnewsense.org/Builder/HowToCreateourOwnGNULinuxDistribution) builder, we took
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.
1: http://www.gnewsense.org/Builder/HowToCreateourOwnGNULinuxDistribution
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
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
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
about pending updates from upstream.
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
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
the output as an attachment to trisquel-devel@listas.trisquel.info. You need
to join the mailing list to send messages to it.
Some recommendations:
## Recommendations
- 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
* 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
need of external files or patches. If you really need to include a file, place
it at the DATA/sourcePackageName directory
- Do not replace *all* references to Ubuntu in the package, just those that
it at the `DATA/sourcePackageName` directory
* Do not replace *all* references to Ubuntu in the package, just those that
would actually be shown to the user. Avoid replacing copyright statements!
- Try to write your replacements in a way they might work in future versions
* Try to write your replacements in a way they might work in future versions
of the upstream package. Well written regexps and sed will help with that.
- 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.
* 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.
Netinstall:
## Netinstall
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
@ -43,13 +44,13 @@ may not be available for all versions.
To generate the images, we run the following scripts:
make-apt-setup
make-base-installer
make-choose-mirror
make-main-menu
make-netcfg
make-net-retriever
make-pkgsel
* `make-apt-setup`
* `make-base-installer`
* `make-choose-mirror`
* `make-main-menu`
* `make-netcfg`
* `make-net-retriever`
* `make-pkgsel`
Then we push the results into the Trisquel repository and run the script
make-debian-installer to build the final images.
`make-debian-installer` to build the final images.