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

README -> README.md

Browse source
This commit is contained in:
Lars-Magnus Skog 2015-01-24 20:09:39 +01:00
parent de69c50338
commit c4aa29ba89
1 changed files with 27 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

51
README → README.md
View file

@ -1,41 +1,42 @@
## Introduction
This set of scripts are helpers that modify and compile those packages coming 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 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 non-free stuff, references to Ubuntu that need to be changed, or because we
want the package to work our way. 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 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. 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 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 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 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 to be run by hand - and the results tested - any time the repo watchdog warns
about pending updates from upstream. about pending updates from upstream.
To add a package to the list, just copy one -make-apache2 is a good template- 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 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 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 the output as an attachment to trisquel-devel@listas.trisquel.info. You need
to join the mailing list to send messages to it. to join the mailing list to send messages to it.
Some recommendations: ## Recommendations
- Take care to use the right sourcePackageName, many source packages produce * Take care to use the right sourcePackageName, many source packages produce
several binary packages. "apt-cache showsrc binary-package" can help you. several binary packages. `apt-cache showsrc binary-package` can help you.
- If possible, use sed to replace chains in the upstream source without the * 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 need of external files or patches. If you really need to include a file, place
it at the DATA/sourcePackageName directory it at the `DATA/sourcePackageName` directory
- Do not replace *all* references to Ubuntu in the package, just those that * Do not replace *all* references to Ubuntu in the package, just those that
would actually be shown to the user. Avoid replacing copyright statements! 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. 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 * 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. `/etc/lsb_release` accordingly, or run the helpers in a Trisquel box.
- You can -and maybe should- run this scripts inside a chroot. * 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 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 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: To generate the images, we run the following scripts:
make-apt-setup * `make-apt-setup`
make-base-installer * `make-base-installer`
make-choose-mirror * `make-choose-mirror`
make-main-menu * `make-main-menu`
make-netcfg * `make-netcfg`
make-net-retriever * `make-net-retriever`
make-pkgsel * `make-pkgsel`
Then we push the results into the Trisquel repository and run the script 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.