]> Cypherpunks.ru repositories - nncp.git/blobdiff - doc/cfg/index.texi
Add various documentation indices
[nncp.git] / doc / cfg / index.texi
index b44f2430e1ef02cd00e196f0882a956a81e8b0c0..1b40823bd6787fe1f42ddc1c1f1c8d2d9c127881 100644 (file)
@@ -1,6 +1,8 @@
 @node Configuration
+@cindex configuration file
 @unnumbered Configuration file
 
+@cindex Hjson
 NNCP uses single file configuration file in @url{https://hjson.org/,
 Hjson} format (see also section about @ref{Configuration directory,
 directory layout}) . Initially it is created with @ref{nncp-cfgnew}
@@ -30,17 +32,29 @@ neigh: {
 }
 @end verbatim
 
+@cindex JSON
+@pindex hjson-cli
+@pindex gojq
+@pindex gjo
+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".
 
 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::