From d691d448dc21231b35eb700e57cdedf206c4a26c Mon Sep 17 00:00:00 2001 From: merakor Date: Mon, 5 Apr 2021 12:03:18 +0000 Subject: Update and move README.md to README FossilOrigin-Name: 189ba29d62a2ed56cad5481274bbbee1814d2ffdfe83ef88aa38ec5162eaacfe --- README | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 60 ------------------------------------------------------------ config.mk | 2 +- 3 files changed, 59 insertions(+), 61 deletions(-) create mode 100644 README delete mode 100644 README.md 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 \ -- cgit v1.2.3