X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fbuilding.texi;h=a0fdd5619e873d638dc87064bcb4c524e0579b61;hb=HEAD;hp=e6699233e0bab2f24241591b5d04159a184b8f79;hpb=77ff0686d3c96931ab5da62559771220271af206;p=nncp.git diff --git a/doc/building.texi b/doc/building.texi index e669923..7405d39 100644 --- a/doc/building.texi +++ b/doc/building.texi @@ -1,4 +1,5 @@ @node Build-instructions +@cindex building @section Build instructions Make sure that Go is installed. For example to install it from packages: @@ -12,31 +13,70 @@ Make sure that Go is installed. For example to install it from packages: @example $ [fetch|wget] http://www.nncpgo.org/download/nncp-@value{VERSION}.tar.xz -$ [fetch|wget] http://www.nncpgo.org/download/nncp-@value{VERSION}.tar.xz.sig -$ gpg --verify nncp-@value{VERSION}.tar.xz.sig nncp-@value{VERSION}.tar.xz -$ xz --decompress --stdout nncp-@value{VERSION}.tar.xz | tar xf - +$ [fetch|wget] http://www.nncpgo.org/download/nncp-@value{VERSION}.tar.xz.@{asc,sig@} +[verify signature] +$ xz -d < nncp-@value{VERSION}.tar.xz | tar xf - $ cd nncp-@value{VERSION} -$ redo all +[optionally edit config] +$ bin/build @end example +@pindex info After that you should get various @command{bin/nncp-*} binaries and @command{bin/hjson-cli} command (only for your convenience, not necessary installation). For example, documentation for @command{nncp-bundle} command can be get with @command{info doc/nncp.info -n nncp-bundle}. -It uses @url{http://cr.yp.to/redo.html, redo} build system for that -examples. You can use one of its various implementations, or at least -minimalistic POSIX shell @command{contrib/do} (just replace -@command{redo} with @command{contrib/do} in the example above) included -in tarball. Following ones are tested to work with: -@url{http://www.goredo.cypherpunks.ru/, goredo} (NNCP's author creation), -@url{https://redo.readthedocs.io/, apenwarr/redo} (@code{contrib/do} is -from that project), @url{https://github.com/leahneukirchen/redo-c, redo-c}. +@vindex PREFIX +@vindex DESTDIR +@vindex GO +@vindex MAKEINFO +@vindex PLANTUML +@vindex PREFIX +@vindex SENDMAIL +@vindex CFGPATH +@vindex SPOOLPATH +@vindex LOGPATH +@vindex BINDIR +@vindex INFODIR +@vindex DOCDIR +@file{config} file contains some environment variables that are +respected during installation: +@env{$PREFIX}, +@env{$DESTDIR}, +@env{$GO}, +@env{$MAKEINFO}, +@env{$PLANTUML}, +@env{$PREFIX}, +@env{$SENDMAIL}, +@env{$CFGPATH}, +@env{$SPOOLPATH}, +@env{$LOGPATH}, +@env{$BINDIR}, +@env{$INFODIR}, +@env{$DOCDIR}. -There is @command{install} target respecting @env{$DESTDIR}. It will -install binaries and info-documentation: +There is @command{install} script for binaries and info-documentation +installation: @example -# PREFIX=/usr/local redo install +# PREFIX=/usr/local ./install @end example + +@vindex nofsnotify +@cindex kqueue +@cindex epoll +@vindex GO_CFLAGS +NNCP depends on @code{github.com/fsnotify/fsnotify} library, that solely +relies on OS-specific mechanisms. There is possibility that you have +either broken or unsupported ones. You can still build NNCP with +@code{-tags nofsnotify} build option, to skip @code{fsnotify} library +usage at all: + +@example +$ GO_CFLAGS="-tags nofsnotify" bin/build +@end example + +@vindex noyggdrasil +You can also disable Yggdrasil support with @code{-tags noyggdrasil}.