ref: 601fd8cc2b36c3aef31d411115783428f039b36d
dir: npe/README.md
# npe
"Native Porting Environment" for 9front, pronounced "nope".
*WIP*
The project tries to provide a minimalistic (and mostly
non-conformant) POSIX environment with several additional libraries
(cut-down version of SDL2 from scratch for now) to ease up porting of
software to 9front. The goal is to be able to build and run
non-native GUI software with very minimal changes, if any.
Unlike APE, NPE is fully native and is not trying to hide any of the
native Plan 9 APIs.
## Using NPE
Clone, run `mk install`.
Create a `mkfile` for the software to be built, and set `CFLAGS`:
CFLAGS=$CFLAGS -p -I/sys/include/npe -D__plan9__ -D__${objtype}__
By default npe will override the `main` function with its own
`threadmain`. If that behaviour isn't desired, add
`-D__plan9_keep_main__` to `CFLAGS`.
Stack size is set to 256k.
[General porting guide](http://docs.9front.org/porting).
## Helping out
Patches and bug reports are always welcome.
g FIXME