]> Cypherpunks.ru repositories - nncp.git/blobdiff - doc/cfg/index.texi
Mention Yggdrasil accessible entrypoint
[nncp.git] / doc / cfg / index.texi
index 1944eaa2b8b5d772bae60e852456f489e8639d7d..f9844eaff5c962526ec9b496ee128d5a6bb9d16a 100644 (file)
@@ -2,8 +2,9 @@
 @unnumbered Configuration file
 
 NNCP uses single file configuration file in @url{https://hjson.org/,
-Hjson} format. Initially it is created with @ref{nncp-cfgnew} command
-and at minimum it can look like this:
+Hjson} format (see also section about @ref{Configuration directory,
+directory layout}) . Initially it is created with @ref{nncp-cfgnew}
+command and at minimum it can look like this:
 
 @verbatim
 spool: /var/spool/nncp
@@ -29,17 +30,28 @@ neigh: {
 }
 @end verbatim
 
+Do not forget that Hjson can be safely converted to JSON and vice versa
+(loosing formatting and comments of course). By default
+@command{hjson-cli} utility from @code{github.com/hjson/hjson-go} is
+built together with @command{nncp-*} commands too. For querying
+information from the JSON from the command line you can use
+@code{github.com/itchyny/gojq} and @code{github.com/skanehira/gjo} for
+building it up.
+
 And for being able to communicate with at least one other node, you just
 need to add single key to the @code{neigh} section similar to the "self".
 
-All configuration file can be separated on five sections:
+Whole configuration file can be separated on five sections:
 
 @menu
-* General options: CfgGeneral.
-* Self-node keypairs: CfgSelf.
-* Notifications: CfgNotify.
-* Neighbours: CfgNeigh.
-* Areas: CfgAreas.
+* General options: CfgGeneral
+* Self-node keypairs: CfgSelf
+* Notifications: CfgNotify
+* Neighbours: CfgNeigh
+* Areas: CfgAreas
+
+You can optionally convert it to directory layout
+* Configuration directory::
 @end menu
 
 @include cfg/general.texi
@@ -47,3 +59,4 @@ All configuration file can be separated on five sections:
 @include cfg/notify.texi
 @include cfg/neigh.texi
 @include cfg/areas.texi
+@include cfg/dir.texi