From 79b8ff535e449e02f2927c52070c99512aaedd24 Mon Sep 17 00:00:00 2001
From: axel <axel@liljencrantz.se>
Date: Sat, 24 Sep 2005 11:31:57 +1000
Subject: [PATCH] Minor documentation update

darcs-hash:20050924013157-ac50b-4ad9f6bb8da67a24999796a9a3de90e334645540.gz
---
 doc_src/doc.hdr   |  9 +++++----
 doc_src/fishd.txt | 12 ++++++++----
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/doc_src/doc.hdr b/doc_src/doc.hdr
index 1b5bc5569..9e9956315 100644
--- a/doc_src/doc.hdr
+++ b/doc_src/doc.hdr
@@ -1252,15 +1252,16 @@ that even if a variable contains spaces, it will never be separated
 into multiple arguments. If you want to tokenize a string, you can use
 the <a href="commands.html#tokenize">tokenize</a> command.
 
-Command substitution is specified using parenthesis. 
+Command substitution is specified using parenthesis, as in <tt>set name (whoami)</tt>. 
 
 There is no math mode, use bc.
 
 The POSIX way of setting variables is <i>lame</i>. Whitespace
 sensitive languages are awful. "foo=bar" and "foo = bar" should not
-mean different things? \c fish uses a builtin, <tt>set</tt> to set and
-remove environment variables. This keeps things consistent. In fish,
-everything, including the switch/case statement is a command.
+mean different things. \c fish uses a builtin, <tt>set</tt> to set and
+remove environment variables. While this may seem a bit obscure, this
+makes for a very consistent language. In fish, everything, including
+the loops, assignments and switch/case statements is a command.
 
 In \c fish, all block types end with the \c end command.
 
diff --git a/doc_src/fishd.txt b/doc_src/fishd.txt
index ebdabd3f3..2c8901506 100644
--- a/doc_src/fishd.txt
+++ b/doc_src/fishd.txt
@@ -39,9 +39,13 @@ barrier_reply
 </pre>
 
 A \c barrier command will result in a barrier_reply beeing added to
-the end of the senders queue. These commands are used to synchronize
-clients.
+the end of the senders queue of unsent messages. These commands are
+used to synchronize clients, since once the reply for a barrier
+message returns, the sender can know that any updates available at the
+time the original barrier request was sent have been recieved.
 
-\subecion fishd-files Files
+\subsection fishd-files Files
 
-~/.fishd.HOSTNAME permenent storage location for universal variale data
+~/.fishd.HOSTNAME permenent storage location for universal variale
+data. The data is stored as a set of \c set and \c set_export commands
+such as would be parsed by fishd.