aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorCem Keylan <cem@ckyln.com>2020-05-27 14:26:27 +0300
committerCem Keylan <cem@ckyln.com>2020-05-27 14:26:27 +0300
commit989ba82fd00558de17de9e7450128e9fdbccc3fb (patch)
tree394138b5e6584402c23e3082f178ab6d4770385b /README
parentbdffd49644e754a08592d0a9bdb36d429b5e5717 (diff)
downloadmkrootfs-989ba82fd00558de17de9e7450128e9fdbccc3fb.tar.gz
README: update
Diffstat (limited to 'README')
-rw-r--r--README58
1 files changed, 49 insertions, 9 deletions
diff --git a/README b/README
index ee131f5..72c800e 100644
--- a/README
+++ b/README
@@ -1,11 +1,51 @@
-carbs base
-==========
+carbs rootfs script
+-------------------
-Tool for generating the rootfs tarball.
-Tarballs on https://dl.carbslinux.org are
-generated from this script. You should run
-mkrootfs.sh as root. If you want to configure,
-copy config.def to config and edit the file.
+Tool for generating rootfs tarballs for Carbs Linux. But
+it can be configured to create tarballs for KISS, create
+a personalized pre-configured tarball with an Xorg server
+to ease installation process. Tarballs on
+https://dl.carbslinux.org are generated from this script.
-Please report any issues you encounter from this
-program.
+
+configuration
+-------------
+
+Configuration can be done by copying config.def file to
+config. There you can configure where the rootfs will be
+created, packages to be installed, CFLAGS, MAKEFLAGS,
+repository to be added, and the `KISS_PATH` to be used.
+
+
+extra repositories
+------------------
+
+The script by default only installs a single repository,
+but can accept a file named 'repositories' to add additional
+repositories to the target system. This file is structured
+in a plaintext manner and has 3 seperate sections.
+
+1. Git URL
+2. Target location
+3. Git clone options (such as --depth 1)
+
+Here is an example repositories file. The local repository is
+for example purposes, don't actually use local repositories.
+
+
+ https://git.u.com/repo1 /var/db/kiss/personalrepo --depth 1
+ /home/user/kiss-repo2 /var/db/kiss/kiss-repo2 --no-local --depth 2
+
+
+You can then add these to your KISS_PATH by editing the
+config file and adding the following to your `HOST_REPO_PATH`.
+
+
+ HOST_REPO_PATH="/tmp/repo/core:$MNTDIR/var/db/kiss/personalrepo:$MNTDIR/var/db/kiss/kiss-repo2"
+
+
+postinstall
+-----------
+
+You can change the postinstall (which defaults to true) function to
+make manual changes to the generated root filesystem. \ No newline at end of file