From 79fa169d07c7a20e3e9598e6d32d99353383bd22 Mon Sep 17 00:00:00 2001
From: Aaron <aaronquinlan@gmail.com>
Date: Tue, 13 Aug 2013 21:08:49 -0400
Subject: [PATCH] [DOC] add docs for the -noOverlapping option in shuffle.

---
 docs/content/tools/shuffle.rst    | 16 ++++++++++++++++
 src/shuffleBed/shuffleBedMain.cpp |  2 +-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/content/tools/shuffle.rst b/docs/content/tools/shuffle.rst
index 26d3716f..8ad9fba1 100755
--- a/docs/content/tools/shuffle.rst
+++ b/docs/content/tools/shuffle.rst
@@ -47,6 +47,7 @@ Usage and option summary
 **-chromFirst**                  Instead of choosing a position randomly among the entire genome (the default), first choose a chrom randomly, and then choose a random start coordinate on that chrom.  This leads to features being ~uniformly distributed among the chroms, as opposed to features being distribute as a function of chrom size.
 **-bedpe**	                     Indicate that the A file is in BEDPE format.
 **-maxTries**                    Max. number of attempts to find a home for a shuffled interval in the presence of -incl or -excl. *Default = 1000.*
+**-noOverlapping**               Don't allow shuffled intervals to overlap.
 ===========================      ===============================================================================================================================================================================================================
 
 
@@ -192,3 +193,18 @@ of the chromosome*):
   $ bedtools shuffle -i A.bed -g my.genome -seed 927442958
   chr1 6177 6277 a1 1 +
   chr1 8119 9119 a2 2 -
+
+==========================================================================
+``-noOverlapping`` Prevent shuffled intervals from overlapping.
+==========================================================================
+There often arise cases where one wants to shuffle intervals throughout 
+the genome, yet one wants to prevent the intervals from occupying a single
+common base pair.  The ``-noOverlapping`` option allows one to enforce
+no such overlaps.
+
+.. code-block:: bash
+
+  $ bedtools shuffle -i A.bed -g my.genome -noOverlapping
+
+
+
diff --git a/src/shuffleBed/shuffleBedMain.cpp b/src/shuffleBed/shuffleBedMain.cpp
index cea9e4d5..5acbef88 100644
--- a/src/shuffleBed/shuffleBedMain.cpp
+++ b/src/shuffleBed/shuffleBedMain.cpp
@@ -198,7 +198,7 @@ void shuffle_help(void) {
     cerr << "\t-maxTries\t"         << "\n\t\tMax. number of attempts to find a home for a shuffled interval" << endl;
     cerr                            << "\t\tin the presence of -incl or -excl." << endl;
     cerr                            << "\t\tDefault = 1000." << endl;
-    cerr << "\t-noOverlapping\t"         << "\n\t\tdont allow shuffled intervals to overlap." << endl;
+    cerr << "\t-noOverlapping\t"         << "\n\t\tDon't allow shuffled intervals to overlap." << endl;
 
     cerr << "Notes: " << endl;
     cerr << "\t(1)  The genome file should tab delimited and structured as follows:" << endl;
-- 
GitLab