summaryrefslogtreecommitdiff
path: root/DEVELOPERS.md
blob: 3ff3516125e48ac0e2321ad7433d20dcd1a49b89 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Developers
==========

GNU autoconf & automake
-----------------------

This project uses GNU autoconf and automake for installation and
building. To regenerate everything from first principles (`configure.ac`
and `**/Makefile.am`), run these commands:

    aclocal && \
    automake --add-missing --copy && \
    autoconf

Debian
------

First, everything must be set up just right:

    mkdir -p ~/debian/rcm && \
    cp -a rcm ~/debian/rcm/rcm-0.0.2 && \
    cd ~/debian/rcm && \
    rm -f rcm_0.0.2.orig.tar.gz && \
    rm -f rcm-0.0.2/tags && \
    tar --exclude=*swp --exclude-backups --exclude-vcs --exclude=debian -zcf rcm_0.0.2.orig.tar.gz rcm-0.0.2

Given that, now you can generate the Debian package. This requires the
Debian packaging tools, especially debuild:

    cd ~/debian/rcm/rcm-0.0.2 && \
    debuild -us -uc

HTML documentation
------------------

The HTML documentation can be generated using the mdocml suite,
especially mandoc(1). This shell command will generate them all into a
separate `rcm-gh-pages` directory:

    for i in lsrc.1 mkrc.1 rcm.7 rcrc.5 rcup.1; do
      mandoc -Thtml -Oman=%N.%S.html man/$i > ~/rcm-gh-pages/$i.html
    done
    cp ~/rcm-gh-pages/rcm.7.html ~/rcm-gh-pages/index.html

More information on mdocml can be found on http://mdocml.bsd.lv/ .