shithub: purgatorio

ref: 00c219c7d9c2b9f60c2db0e1ba7289b2301209a7
dir: /opt/skel/README.md/

View raw version
# Description

This project is example, which can be used as template to start new /opt
project for OS Inferno.


# Install

Make directory with this app/module skeleton available in /opt/skel/.

Install system-wide:

```
# git clone https://github.com/powerman/inferno-opt-skel.git $INFERNO_ROOT/opt/skel
```

or in your home directory:

```
$ git clone https://github.com/powerman/inferno-opt-skel.git $INFERNO_USER_HOME/opt/skel
$ emu
; bind opt /opt
```

## Dependencies

* https://github.com/powerman/inferno-opt-mkfiles
* https://github.com/powerman/inferno-contrib-tap (only for tests)
* https://github.com/powerman/inferno-contrib-logger (example dependency for
  example command :))
* http://asciidoc.org/ (converter from asciidoc markup to other formats)
* https://github.com/powerman/asciidoc-9man-backend (asciidoc 9man backend
  for converting into Inferno man pages)

Actually all these dependencies are optional:

* mkfiles project can be just copied to ./mkfiles/ subdir in your project
  to avoid dependency on external project
* tap module needed only for testing; you can use another modules, but
  this one is cool because it allow you to run tests using `prove` command
  in host os (standard testing tool for Perl)
* logger is just an example dependency, nothing more
* asciidoc needed only if you like to generate Inferno man pages from
  simple .txt source


# Usage

Just copy `/opt/skel/` into your project's directory when you start new
project.

You can build your project using these commands both from host os and
inside emu (except `prove`, which works only in host os):

```
mk all
mk install

mk test
prove -r

mk clean
mk nuke
```

## Example

When this project installed in `/opt/skel` and your /opt is correctly set
(https://github.com/powerman/inferno-opt-setup) you can also:

```
$ emu
; examplecmd
Hello from ExampleLib->init()
user.warn: Dec  6 05:04:40 examplecmd[158]: Hello from ExampleCmd->init()
user.err: Dec  6 05:04:40 examplecmd[158]: Hello from ExampleCmd->init()
; man examplecmd
EXAMPLECMD(1)                                       EXAMPLECMD(1)

NAME
     examplecmd - Example command in /opt skeleton project
…
; man examplelib
EXAMPLELIB(2)                                       EXAMPLELIB(2)

NAME
     examplelib - Example library in /opt skeleton project
…
```