>From d182bc1a4b59647f03eaf6e5f4a6d1f1b017df35 Mon Sep 17 00:00:00 2001
From: Ralf Wildenhues <address@hidden>
Date: Sun, 21 Nov 2010 11:57:27 +0100
Subject: [PATCH 3/3] manual: fix overlong lines and a couple of examples.

---
 ChangeLog         |    7 +++++++
 doc/recutils.texi |   10 +++++++---
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4a84459..c18f6ff 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,12 @@
 2010-11-21  Ralf Wildenhues  <address@hidden>
 
+	manual: fix overlong lines and a couple of examples.
+	* doc/recutils.texi (recsel Invocation, recins Invocation)
+	(recins Examples): Do not recommend appending to a file while
+	reading it.  Avoid overlong lines in the synopses and examples.
+
+2010-11-21  Ralf Wildenhues  <address@hidden>
+
 	Fix make check in VPATH case.
 	* torture/utils/recsel.sh: Ensure $srcdir is set; read
 	testsutils.sh from $srcdir.
diff --git a/doc/recutils.texi b/doc/recutils.texi
index aed6fc0..c702a0f 100644
--- a/doc/recutils.texi
+++ b/doc/recutils.texi
@@ -1193,7 +1193,8 @@ part of records) based in some criteria specified by the user.
 criteria.  Synopsis:
 
 @example
-recsel [OPTION]... [-n NUM | -e RECORD_EXPR] [-c | (-p|-P|-R) FIELD_EXPR] [FILE]...
+recsel [OPTION]... [-n NUM | -e RECORD_EXPR] [-c | (-p|-P|-R) FIELD_EXPR] \
+       [FILE]...
 @end example
 
 In addition of the common options described earlier (@pxref{Common
@@ -1292,7 +1293,8 @@ from the standard input.
 from the standard input.  Synopsis:
 
 @example
-recins [OPTION]... [t TYPE] [-n NUM | -e EXPR] [(-f STR -v STR]|[-r RECDATA)]... [FILE]
+recins [OPTION]... [t TYPE] [-n NUM | -e EXPR] \
+       [(-f STR -v STR]|[-r RECDATA)]... [FILE]
 @end example
 
 The new record that will be inserted by the command is constructed by
@@ -1359,7 +1361,9 @@ $ recins -t Issue -f Id     -v 10           \
 Register a new event in a log file, using recins as a filter:
 
 @example
-cat $LOGFILE | recins -f Date -v `date` -f Entry -v "$HW_ADDR device connected" >> $LOGFILE
+recins -f Date -v `date` -f Entry -v "$HW_ADDR device connected" \
+       < $LOGFILE > $LOGFILE.t \
+  && cat $LOGFILE.t >> $LOGFILE
 @end example
 
 @node recdel
-- 
1.7.3.rc2