X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcall.texi;h=06566abc4a87c7a5c77e321e5a2c912bb84551ed;hb=bb7fe5e770586be9f44a8a7f3321a3139d5345bb;hp=83f43ea5fe206e9b4dc36a559b32e91be70d2500;hpb=ab7c7eca0e53661f0ba904c2a6ba752990bea367;p=nncp.git

diff --git a/doc/call.texi b/doc/call.texi
index 83f43ea..06566ab 100644
--- a/doc/call.texi
+++ b/doc/call.texi
@@ -1,7 +1,9 @@
 @node Call
+@cindex call
+@vindex calls
 @unnumbered Call configuration
 
-Call is a rule when and how node can be called by @ref{nncp-caller}.
+Call is a rule when and how node can be called by @command{@ref{nncp-caller}}.
 
 Example list of call structures:
 
@@ -14,7 +16,7 @@ calls: [
 
         autotoss: true
         autotoss-doseen: true
-    },
+    }
     {
         cron: "30 * * * SAT,SUN"
         onlinedeadline: 1800
@@ -22,18 +24,18 @@ calls: [
         nice: NORMAL
         rxrate: 10
         txrate: 20
-    },
+    }
     {
         cron: "0 * * * SAT,SUN"
         xx: rx
         addr: lan
-    },
+    }
     {
         cron: "*/5 * * * * * *"
         when-tx-exists: true
         nock: true
         mcd-ignore: true
-    },
+    }
 ]
 @end verbatim
 
@@ -51,17 +53,23 @@ It contains the following fields (only @emph{cron} is required):
 
 @table @emph
 
+@vindex cron
 @item cron
 @include cronexpr.texi
 
+@vindex nice
 @item nice
 Optional. Use that @ref{Niceness, niceness} during the call (255 is used
 otherwise).
 
+@vindex xx
+@vindex rx
+@vindex tx
 @item xx
 Optional. Either @verb{|rx|} or @verb{|tx|}. Tells only to either to
 receive or to transmit data during that call.
 
+@vindex addr
 @item addr
 Optional. Call only that address, instead of trying all from
 @ref{CfgAddrs, @emph{addrs}} configuration option. It can be either key
@@ -79,24 +87,33 @@ configuration option when calling.
 Optional. Override @ref{CfgMaxOnlineTime, @emph{maxonlinetime}}
 configuration option when calling.
 
+@vindex autotoss
 @item autotoss, -doseen, -nofile, -nofreq, -noexec, -notrns
 Optionally enable auto tossing: run tosser on node's spool every second
-during the call. You can control either are @file{.seen} files must be
+during the call. You can control either are @file{seen/} files must be
 created, or skip any kind of packet processing.
 
+@vindex when-tx-exists
 @item when-tx-exists
-Call only if packets for sending exists.
+Call only if packets for sending exists. The check of outbound packets
+existence is performed @strong{every} time we are going to make a call,
+but @emph{when-tx-exists} does not influence @emph{cron}. When
+@emph{cron} configuration decides that it is time to make a call, with
+@emph{when-tx-exists} option it checks packets existence first.
 
+@vindex nock
 @anchor{CfgNoCK}
 @item nock
 NoCK (no-checksumming) tells not to do checksumming of received files,
-assuming that it will be done for example with @ref{nncp-check} command
-later. That can help minimizing time spent online, because HDD won't do
-simultaneous reading of the data for checksumming and writing of the
-received one, but just sequential writing of the file. Pay attention
-that you have to make a call to remote node after checksumming is done,
-to send notification about successful packet reception.
-
+assuming that it will be done for example with
+@command{@ref{nncp-check}} command later. That can help minimizing time
+spent online, because HDD won't do simultaneous reading of the data for
+checksumming and writing of the received one, but just sequential
+writing of the file. Pay attention that you have to make a call to
+remote node after checksumming is done, to send notification about
+successful packet reception.
+
+@vindex mcd-ignore
 @anchor{CfgMCDIgnore}
 @item mcd-ignore
 Ignore @ref{MCD} announcements: do not add MCD addresses for possible