README.md: updated and corrected documentation
This commit is contained in:
30
README.md
30
README.md
@@ -16,8 +16,9 @@ using Debian GNU/Linux, Devuan and different flavors of Ubuntu.
|
||||
- [4. Error code table](#4-error-code-table)
|
||||
- [5. Contact and more information](#5-contact-and-more-information)
|
||||
- [5.1. New users](#51-new-users)
|
||||
- [5.2. How to contribute?](#51-how-to-contribute)
|
||||
- [5.3. Website and maintainor](#52-website-and-maintainor)
|
||||
- [5.2. Bugs](#52-bugs)
|
||||
- [5.3. How to contribute?](#53-how-to-contribute)
|
||||
- [5.4. Website and maintainor](#54-website-and-maintainor)
|
||||
|
||||
## 1. Getting started
|
||||
You should consider reading that document entirely before use. If you need
|
||||
@@ -41,7 +42,7 @@ hardcoded monolitic scripts where I had to rewritte many things on every new
|
||||
infrastructures I wanted to manage. As it was a fastidious job, I started to
|
||||
rewritte and redesign everything with a common architecture and code, modular
|
||||
and easily adaptative. As I don't know any tools in that market scale, I decided
|
||||
to publish and share that work, in the hope I can be usefull.
|
||||
to publish and share that work, in the hope it can be usefull.
|
||||
|
||||
## 3. Design
|
||||
**init.sh** relies on three different elements to work:
|
||||
@@ -308,7 +309,7 @@ The following table is giving a list of error code with explanation:
|
||||
| Code | Meaning |
|
||||
|:----------|:------------------------------------------------------------|
|
||||
| 0 | No error |
|
||||
| 1 | Command line syntax error |
|
||||
| 1 | Command line syntax error or incompatible options |
|
||||
| 2 | Misuse of Bash built-in |
|
||||
| 3 | Missing library file or function |
|
||||
| 4 | No root rights |
|
||||
@@ -324,6 +325,7 @@ The following table is giving a list of error code with explanation:
|
||||
| 14 | Impossible to chroot |
|
||||
| 15 | Bad chrooted installation, destination OS needs to be fixed |
|
||||
| 16 | Invalid options provided with cron mode activated |
|
||||
| 17 | Missing or invalid status file, can't resume |
|
||||
| 50..100 | Error in module execution |
|
||||
| 126 | Command exists but is not executable |
|
||||
| 127 | Command not found |
|
||||
@@ -336,13 +338,25 @@ you in the debugging process. If you find a bug outside modules or in the basic
|
||||
provided module, please contact the author. Of course, if you also have a patch,
|
||||
your mail will be even more welcomed!
|
||||
|
||||
You can check [error fixing documentation](./doc/errors.md) to obtain help on
|
||||
how to solve problems.
|
||||
|
||||
## 5. Contact and more information
|
||||
### 5.1. New users
|
||||
As this project is very new and as I have no idea of who will use it, if you do
|
||||
so, I'll be very happy if you simply mail me to let me know, especially if you
|
||||
don't plan to contribute.
|
||||
|
||||
### 5.2. How to contribute?
|
||||
### 5.2. Bugs
|
||||
**init.sh** have no bug tracker yet. For now, if you find a bug, please submit a
|
||||
bag report to the maintenor mentionned at the end of that document. A bug report
|
||||
may contain the command line parameters where the bug happens, OS details,
|
||||
the module that trigger it if any, and the log file containing the error.
|
||||
|
||||
Please check the to do list before sending any report as the problem might
|
||||
already be known.
|
||||
|
||||
### 5.3. How to contribute?
|
||||
You are free to improve and contribute as you wish. If you have no idea what to
|
||||
do or want some direction, you can check the [to do list](./doc/todo.md),
|
||||
containing desired future improvements. Make sure you always have the latest
|
||||
@@ -363,7 +377,9 @@ packages not provided in minimal Debian installation will be rejected. Anyway,
|
||||
core scripts will remain in Bash whatever the evolutions of ```init.sh``` will
|
||||
be.
|
||||
|
||||
### 5.3. License, website and maintainor
|
||||
If you want to make a financial contribution, please contact me by mail.
|
||||
|
||||
### 5.4. License, website and maintainor
|
||||
Everything except configuration files is licensed under BSD-3 license. Please
|
||||
check license file allong this one.
|
||||
|
||||
@@ -371,4 +387,4 @@ Please check [https://www.geoffray-levasseur.org/init](https://www.geoffray-leva
|
||||
Please note that this website is still under construction and needs some more
|
||||
care.
|
||||
|
||||
You can mail author to fatalerrors \<at\> geoffray-levasseur \<dot\> org
|
||||
You can mail author to fatalerrors \<at\> geoffray-levasseur \<dot\> org.
|
||||
|
||||
Reference in New Issue
Block a user