From 90f886c5c4690fc770da668c079a9ccca88baeab Mon Sep 17 00:00:00 2001 From: "R. Dale Thomas" Date: Wed, 1 Oct 2008 19:41:52 -0700 Subject: Reduce the line length an take out some "funny" formating characters. --- README | 130 ++++++++++++++++++++++++++++++++++++++++------------------------- 1 file changed, 81 insertions(+), 49 deletions(-) diff --git a/README b/README index 9493bd5..64e778e 100644 --- a/README +++ b/README @@ -1,5 +1,11 @@ - The LinHES development is divided into two different git repositories. -The first repository is LinHES-PKGBUILD, and it contains all the PKGBUILD files that make up LinHES. The second repository is called LinHES-dev and is intended to create a chroot for all development to occur within. By using a chroot development work can be done on non-LinHES machines. The reason for the split is so that the PKGBUILD's may be downloaded and modified by non-developers without requiring them to download the entire development environment. + The LinHES development is divided into two different git repositories. +The first repository is LinHES-PKGBUILD, and it contains all the PKGBUILD +files that make up LinHES. The second repository is called LinHES-dev and is +intended to create a chroot for all development to occur within. By using a +chroot development work can be done on non-LinHES machines. The reason for +the split is so that the PKGBUILD's may be downloaded and modified by +non-developers without requiring them to download the entire development +environment. ------ LinHES-PKGBUILD ----------- @@ -7,71 +13,95 @@ The layout of the LinHES-PKGBUILD repository is as follows. -- abs |-- chroot-devel |-- chroot-devel-testing - |-- core + |-- core |-- core-testing |-- extra |-- extra-testing -Core is the set of packages that make up the “core” of LinHES, or in other words all the packages needed to create a fully functioning system. +Core is the set of packages that make up the "core" of LinHES, or in other +words all the packages needed to create a fully functioning system. -Extra contains all the packages used by LinHES, but not necessarily needed to create a fully functioning system. For example this would include mplayer, xine and mozilla. +Extra contains all the packages used by LinHES, but not necessarily needed +to create a fully functioning system. For example this would include +mplayer, xine and mozilla. Chroot-devel are packages used by developers that are not in LinHES. -The difference between core and core-testing is that core is intended to be used for public iso releases, where as core-testing is intended for developers or beta testing. The same applies to extra and chroot-devel. +The difference between core and core-testing is that core is intended to be +used for public iso releases, where as core-testing is intended for developers +or beta testing. The same applies to extra and chroot-devel. ----------- LinHES-dev ------------------- - LinHES-dev contains the tools and scripts for a working development environment, but it is not a working development by itself. The script setup-env.sh will do all the work in creating a working development environment. The script will download and install the required packages(from the current stable release) into a directory called build_root and create a script that can be used to enter the chroot. - Because LinHES will support multiple architectures, setup-env.sh requires and argument telling it which architecture to work with.. Currently i686 is the only working option, so that is the one I recommend you use. For example running “setup-env.sh i686” will create a working i686 LinHES development environment named build_root.i686. Setup-env.sh also creates a empty directory structure called pkg_repo, this is used by kmsync.sh (which will be discussed later). - - To enter the build root run (as root) the newly created script called enter_build_root.i686. -The script will take care of the following things for you - a) mounting proc,sys,dev/pts - b) bind mounting LinHES-dev/build_tools to build_root/build_tools - c) bind mounting LinHES-PKGBUILD to build_root/data/LinHES-PKGBUILD - d) bind mounting pkg_repo to build_root/data/pkg_repo. - e) unmount the above directories when leaving the chroot - + LinHES-dev contains the tools and scripts for a working development +environment, but it is not a working development by itself. The script +setup-env.sh will do all the work in creating a working development +environment. The script will download and install the required packages +(from the current stable release) into a directory called build_root and +create a script that can be used to enter the chroot. + Because LinHES will support multiple architectures, setup-env.sh +requires and argument telling it which architecture to work with. Currently +i686 is the only working option, so that is the one I recommend you use. +For example running "setup-env.sh i686" will create a working i686 LinHES +development environment named build_root.i686. Setup-env.sh also creates an +empty directory structure called pkg_repo, this is used by kmsync.sh +(which will be discussed later). + + To enter the build root run (as root) the newly created script called +enter_build_root.i686. The script will take care of the following things: + a) mounting proc,sys,dev/pts + b) bind mounting LinHES-dev/build_tools to build_root/build_tools + c) bind mounting LinHES-PKGBUILD to build_root/data/LinHES-PKGBUILD + d) bind mounting pkg_repo to build_root/data/pkg_repo. + e) unmount the above directories when leaving the chroot The following is a list of tools available to you inside the chroot. a) mp - Small script to compile a package, copy it to the local testing repo and update the local database using the repo-add function. Must be called from the same directory that contains the PKGBUILD. This script takes all the same arguments that makepkg takes. + Small script to compile a package, copy it to the local testing repo + and update the local database using the repo-add function. Must + be called from the same directory that contains the PKGBUILD. + This script takes all the same arguments that makepkg takes. b) mpr - Symlink to mp that does the same thing as mp except it copies the package to the release repo + Symlink to mp that does the same thing as mp except it copies the + package to the release repo c) update_db_repo -Used to completely regenerate the the local package database. -Takes two arguments the directory with packages, and the name of the repository. - Example: update_db_repo /data/local/pkg_repo/i686/core-testing core-testing + Used to completely regenerate the the local package database. + Takes two arguments the directory with packages, and the name of + the repository. Example: + update_db_repo /data/local/pkg_repo/i686/core-testing core-testing d) kmsync.sh (testing|release|chroot-devel - This script is used to synchronize the contents of the compiled packages on knoppmyth.net and the ones on your local machine. - - The script takes 1 argument telling it which repository to sync up with - - The first time it's run with any given option the local directory (/data/pkg_repo/i686/core|extra|chroot-devel) MUST MUST MUST be empty. - - Please use this script with care, any changes that are made in the local mirror will be copied to the knoppmyth server. - - This includes the possibility to completely erase all the packages. Finally this script uses a shared user account on knoppmyth.net that is a locked account. SSH keys must be setup for this script to work. + This script is used to synchronize the contents of the compiled + packages on knoppmyth.net and the ones on your local machine. + The script takes 1 argument telling it which repository with which + to sync up. The first time it's run with any given option the local + directory (/data/pkg_repo/i686/core|extra|chroot-devel) + MUST MUST MUST be empty. + Please use this script with care, any changes that are made in the + local mirror will be copied to the knoppmyth server. + This includes the possibility to completely erase all the packages. + Finally this script uses a shared user account on knoppmyth.net that + is a locked account. SSH keys must be setup for this script to work. e) build_tools/go.sh - Menu driven fronted to create an ISO with selected profile - The following profiles are available to create an iso. -a ) i686-RELEASE-REMOTE - Create an iso from the release repo using packages from knoppmyth.net -b ) i686-testing-REMOTE - Create an ISO from the testing repo using packages from knoppmyth.net -c) i686-testing-local - Create an ISO from the testing repo using packages from the local mirror -d ) i686-testing-local-httpdir-structure - Create an ISO from the testing repo using packages from a local web server name “localmirror” - - After the process finishes it will let you know the final name and location of the resulting ISO - For any of the local profiles to work, it requires that kmsync be run at least once to populate the local mirror. + Menu driven fronted to create an ISO with selected profile + The following profiles are available to create an iso. + a ) i686-RELEASE-REMOTE + Create an iso from the release repo using packages from knoppmyth.net + b ) i686-testing-REMOTE + Create an ISO from the testing repo using packages from knoppmyth.net + c) i686-testing-local + Create an ISO from the testing repo using packages from the local mirror + d ) i686-testing-local-httpdir-structure + Create an ISO from the testing repo using packages from a local web + server name "localmirror" + + After the process finishes it will let you know the final name and +location of the resulting ISO. For any of the local profiles to work, it +requires that kmsync be run at least once to populate the local mirror. Quick start showing typical process ############ @@ -88,7 +118,7 @@ git clone ssh://jams@knoppmyth.net/mount/repository/LinHES-PKGBUILD Build and iso from knoppmyth.net cdb <= alias ./go.sh - (select i686-testing-REMOTE) + (select i686-testing-REMOTE) commands used to build a package (tar in this example), and update knoppmyth.net @@ -97,7 +127,10 @@ cd core-testing cd tar vi PKGBUILD <= bump the pkgrel line by 1 mp -(at this point you should test the package, either by building a new iso or installing the package)kmsync.sh testing <= this will pull down all changes from knoppmyth.net and upload the new tar package +# at this point you should test the package, either by building +# a new iso or installing the package) +kmsync.sh testing <= this will pull down all changes from knoppmyth.net + and upload the new tar package ----------------------- Misc. @@ -108,6 +141,5 @@ Directory structure after a functioning chroot is created for i686 |-- enter_dev_chroot.i686.sh `-- pkg_repo - - - +----------------------- +# End -- cgit v0.12