Cleanup top-level documentation

Moved most of the documentation from `README` to
`README.md`, and added MarkDown formatting when
required. Also move the release notes to a
`CHANGELOG.md`, and made sure the formatting
was consistent.
This commit is contained in:
louib
2019-11-09 10:17:44 -05:00
parent 42e58bbd22
commit 46f8cc352d
3 changed files with 229 additions and 219 deletions

View File

@@ -1,3 +1,5 @@
# nwipe
nwipe is a command that will securely erase disks using a variety of
recognised methods. It is a fork of the dwipe command used by
Darik's Boot and Nuke (dban). nwipe is included with partedmagic if you
@@ -6,9 +8,84 @@ a need to run the DBAN dwipe command outside of DBAN, in order to
allow its use with any host distribution, thus giving better hardware
support.
To use from the git repository, first create all the autoconf files with
`./init.sh`
## Compiling & Installing
Then do the standard `./configure --prefix=/usr && make && make install`
`nwipe` requires the following libraries to be installed:
For developers & release notes please see the [README file](README)
* ncurses
* pthreads
* parted
### Debian & Ubuntu prerequisites
If you are compiling `nwipe` from source, the following libraries will need to be installed first:
```bash
sudo apt install \
build-essential \
pkg-config \
automake \
libncurses5-dev \
autotools-dev \
libparted-dev
```
### Fedora prerequisites
```bash
sudo bash
dnf update
dnf groupinstall "Development Tools"
dnf groupinstall "C Development Tools and Libraries"
yum install ncurses-devel
yum install parted-devel
```
### Compilation
For a development setup, see [the hacking section below](#Hacking).
First create all the autoconf files:
```
./init.sh
```
Then compile & install using the following standard commands:
```
./configure
make
make install
```
### Hacking
If you wish to submit pull requests to this code we would prefer you enable all warnings when compiling.
This can be done using the following compile commands:
```
./configure --prefix=/usr CFLAGS='-O0 -g -Wall -Wextra'
make
make install
```
The `-O0 -g` flags disable optimisations. This is required if you're debugging with
`gdb` in an IDE such as Kdevelop. With these optimisations enabled you won't be
able to see the values of many variables in nwipe, not to mention the IDE won't step
through the code properly.
The `-Wall` and `-Wextra` flags enable all compiler warnings. Please submit code with zero warnings.
Once done with your coding then the released/patch/fixed code can be compiled,
with all the normal optimisations, using:
```
./configure --prefix=/usr && make && make install
```
## Bugs
Bugs can be reported on GitHub:
https://github.com/martijnvanbrummelen/nwipe
## License
GNU General Public License v2.0