From f923cecebafa22dd4d7e233e151b1202959fb12c Mon Sep 17 00:00:00 2001
From: Jim Meyering <meyering@redhat.com>
Date: Fri, 19 Sep 2008 09:20:13 +0200
Subject: [PATCH] doc: coreutils.texi (csplit invocation): Add an example.

---
 doc/coreutils.texi | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index e4599e9..cd54d91 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -3084,6 +3084,56 @@ Do not print counts of output file sizes.
 
 @exitstatus
 
+Here is an example of its usage.
+First, create an empty directory for the exercise,
+and cd into it:
+
+@example
+$ mkdir d && cd d
+@end example
+
+Now, split the sequence of 1..14 on lines that end with 0 or 5:
+
+@example
+$ seq 14 | csplit - '/[05]$/' '@{*@}'
+8
+10
+15
+@end example
+
+Each number printed above is the size of an output
+file that csplit has just created.
+List the names of those output files:
+
+@example
+$ ls
+xx00  xx01  xx02
+@end example
+
+Use @command{head} to show their contents:
+
+@example
+$ head xx*
+==> xx00 <==
+1
+2
+3
+4
+
+==> xx01 <==
+5
+6
+7
+8
+9
+
+==> xx02 <==
+10
+11
+12
+13
+14
+@end example
 
 @node Summarizing files
 @chapter Summarizing files
-- 
2.7.4