aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README58
-rw-r--r--README.md60
-rw-r--r--config.mk2
3 files changed, 59 insertions, 61 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..9ea2dc3
--- /dev/null
+++ b/README
@@ -0,0 +1,58 @@
+Carbs Packaging Tools
+=====================
+
+Package management toolset for Carbs Linux. Forked from KISS[1]. All usage
+information can be obtained from the manual page. Refer to the ChangeLog[2] 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 or tar [GNU tar, busybox, toybox, libarchive, etc.]
+- 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 with `make`:
+
+ make
+ make PREFIX=/usr 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[3], 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
+
+[1]: https://github.com/kisslinux/kiss
+[2]: https://fossil.carbslinux.org/cpt/log
+[3]: https://carbslinux.org/docs/cpt
diff --git a/README.md b/README.md
deleted file mode 100644
index b7db05a..0000000
--- a/README.md
+++ /dev/null
@@ -1,60 +0,0 @@
-Carbs Packaging Tools
---------------------------------------------------------------------------------
-
-Package management toolset for Carbs Linux. Forked from [KISS]. All usage
-information can be obtained from the manual page. For changes please refer to
-the `CHANGELOG.md` file.
-
-[KISS]: https://github.com/kisslinux/kiss
-
-
-Dependencies
---------------------------------------------------------------------------------
-
-To build and use cpt, you need the following software:
-
-- `rsync`
-- `curl`
-- POSIX base utilities [`coreutils`, `busybox`, `sbase`, etc.]
-- `pax` or `tar` [GNU tar, busybox, toybox, libarchive, etc.]
-- Common compression utilities such as `gzip`, `bzip2`, `xz`, etc.
-
-
-In order to build the documentation, you will need the following software:
-
-- `texinfo` (for generating `.info` pages)
-- `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.
-
-
-Directory Structure
---------------------------------------------------------------------------------
-
- / -- README, LICENSE, CHANGELOG
- contrib/ -- for Shell scripts that wrap around cpt.
- docs/ -- for documentation.
- man/ -- for manual pages.
- src/ -- for the tools that make up the package manager.
-
-
-Defining Base
---------------------------------------------------------------------------------
-
-Tools such as cpt-orphans and cpt-reset define the base from the file
-`/etc/cpt-base`. An example cpt-base file can be found from the root directory
-of the repository, which is the default base for Carbs Linux. A user can modify
-this file to fit their needs and redefine their base for the system. For
-example, a user can decide that they want `sbase` instead of `busybox` for their
-base, so if they reset their system, busybox will be removed instead of sbase.
-
-This file is used to ship a predefined base, while leaving the base to a user's
-choice. However, it isn't installed by the Makefile so that the packagers may
-define their own base, or so that a user can install cpt without using it as
-their main package manager.
diff --git a/config.mk b/config.mk
index 730692e..d29414c 100644
--- a/config.mk
+++ b/config.mk
@@ -28,7 +28,7 @@ DISTFILES = \
CHANGELOG.md \
LICENSE \
Makefile \
- README.md \
+ README \
config.mk \
contrib \
cpt-base \