--- coreutils-gotchas.html	2017-02-21 22:46:29.000000000 -0500
+++ coreutils-gotchas-split.html	2017-02-21 22:58:23.000000000 -0500
@@ -860,6 +860,56 @@
 10
 </pre>
 
+<h2 id="split">split</h2>
+<font class="snippet">split</font> has a feature to widen the letters in
+the output file names if more files are needed beyond the default of
+two letters. The widening scheme ensures file names are sorted correctly.
+For example:
+
+<pre class="shell">
+$ seq 1000 | split -l 1 - foo_
+$ ls foo_*
+...
+foo_yy
+foo_yz
+foo_zaaa
+foo_zaab
+...
+</pre>
+
+<font class="snippet">split</font> behaves the same with
+<font class="snippet">--numeric-suffixes/-d</font> option, which could
+lead to unexpected numeric sequences:
+
+<pre class="shell">
+$ seq 1000 | split -l 10 -d - bar_
+$ ls bar_*
+...
+bar_88
+bar_89
+bar_9000
+bar_9001
+...
+</pre>
+
+The recommended solution is to use the
+<font class="snippet">-a/--suffix-length</font> parameter:
+<pre class="shell">
+$ seq 1000 | split -a5 -l 10 -d - baz_
+$ ls baz_*
+bar_00000
+bar_00001
+...
+bar_00098
+bar_00099
+</pre>
+
+See relevant reports in bugs
+<a href="https://debbugs.gnu.org/20874">#20874</a> and
+<a href="https://debbugs.gnu.org/25832">#25832</a>.
+
+
+
 <h2 id="units">Unit representations</h2>
 The <i>df</i>, <i>du</i>, <i>ls</i>
 <a href="https://www.gnu.org/software/coreutils/manual/html_node/Block-size.html">--block-size</a>
