aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authormerakor <cem@ckyln.com>2021-07-28 08:31:37 +0000
committermerakor <cem@ckyln.com>2021-07-28 08:31:37 +0000
commitcc0c978106939e2f057484b9a38f90051e75c87e (patch)
tree00ffdd593bd38329606b3476754ac0f7f371b56c /README.md
parent0ded82fa18a6ebb1acf1e0d0d3a22f2dda8697fe (diff)
downloadcpt-cc0c978106939e2f057484b9a38f90051e75c87e.tar.gz
docs: update
FossilOrigin-Name: 44bfb20c738fedc0542d2258ecbf4c33ff9d165ecb7359674ee9e5d073bb5ad5
Diffstat (limited to 'README.md')
-rw-r--r--README.md59
1 files changed, 59 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3dcca26
--- /dev/null
+++ b/README.md
@@ -0,0 +1,59 @@
+Carbs Packaging Tools
+=====================
+
+Package management toolset for Carbs Linux. Forked from [KISS]. All usage
+information can be obtained from the manual page. Refer to the [ChangeLog] to
+learn what's new.
+
+
+Dependencies
+------------
+
+To build and use cpt, you need the following software:
+
+- rsync
+- curl
+- POSIX base utilities [coreutils, busybox, sbase, etc.]
+- pax
+- Common compression utilities such as `gzip`, `bzip2`, `xz`, etc.
+
+
+In order to build the documentation from source, you will need the following
+software:
+
+- GNU Texinfo (for generating `.info` pages)
+- GNU Emacs (for generating `.texi` and `.txt` pages)
+
+However, distributed tarballs come with info pages, and `.texi` and `.txt` files
+are committed directly into the repository, meaning that you don't need Texinfo
+if you are using a tarball, and you don't need Emacs as long as you don't edit
+the documentation.
+
+You can also completely disable the build/installation of the documentation by
+either passing `DOCS=no` to `make` or editing `config.mk` to disable it.
+
+
+Installation
+------------
+
+In order to install CPT, you can run the following:
+
+ ./configure
+ make
+ make install
+
+
+Documentation
+-------------
+
+The documentation for each tool along with some examples can be found on
+manpages installed with the package manager. User manual of CPT can be found
+[online], or installed as both plain-text and as info pages. Without any
+changes to the Makefile configuration those files can be found at:
+
+- /usr/local/share/docs/cpt/cpt.txt
+- /usr/local/share/info/cpt.info
+
+[KISS]: https://github.com/kisslinux/kiss
+[ChangeLog]: https://fossil.carbslinux.org/cpt/doc/trunk/CHANGELOG.md
+[online]: https://carbslinux.org/docs/cpt