Man page for fastq-sort. Bump version.

diff --git a/README.md b/README.md
index c9066774869a03c30c076b4f3f3c426a4e0ab9f1..b4cff423df9c44cfee6f2492480b74226742e0bc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -13,6 +13,7 @@ index
 The following programs are provided. See the individual man pages for more
 information.
 
+* *fastq-sort* : sort fastq entries by various keys
 
 * *fastq-grep* : match sequences against regular expressions
 

diff --git a/configure.ac b/configure.ac
index f1e45d988aa6cd7f515493000b7122e5c75ceee2..bdb3024df6df9544bb89b20c806cc93f77a0d19a 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -1,5 +1,5 @@
 
-AC_INIT( [fastq-tools], [0.3], [dcjones@cs.washington.edu] )
+AC_INIT( [fastq-tools], [0.4], [dcjones@cs.washington.edu] )
 AM_INIT_AUTOMAKE( [foreign -Wall -Werror] )
 m4_ifdef([AM_SILENT_RULES],[AM_SILENT_RULES([yes])])
 

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 8695fbdb48daf26f3bb24b3d397beb6fe1320d2d..16f345b4a47140d13f8b576789dae2ba37588ebb 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,4 +1,4 @@
 
-dist_man_MANS = fastq-grep.1 fastq-kmers.1 fastq-match.1 fastq-uniq.1 fastq-sample.1
+dist_man_MANS = fastq-grep.1 fastq-kmers.1 fastq-match.1 fastq-uniq.1 fastq-sample.1 fastq-sort.1
 
 

diff --git a/doc/fastq-grep.1 b/doc/fastq-grep.1
index 89bae043a5a8f30475500470843464cc3ca4c3f8..9858553a04da437afa4fb15f71909fca64356250 100644 (file)
--- a/doc/fastq-grep.1
+++ b/doc/fastq-grep.1
@@ -11,10 +11,9 @@ Given a PATTERN, specified as a perl-compatible regular expression, print every
 FASTQ entry with a matching nucleotide sequence.
 
 One ore more FILEs may be specified, otherwise input is read from standard input.
-Input files may be gziped.
 
 .SH OPTIONS
-.TP 
+.TP
 \fB\-i\fR, \fB\-\-id\fR
 Match the read ID (by default, the sequence is matched).
 .TP

diff --git a/doc/fastq-sort.1 b/doc/fastq-sort.1
new file mode 100644 (file)
index 0000000..7b63ae0
--- /dev/null
+++ b/doc/fastq-sort.1
@@ -0,0 +1,47 @@
+.TH FASTQ-SORT 1
+
+.SH NAME
+fastq-sort - sort entries in a fastq file
+
+.SH SYNOPSIS
+.B fastq-sort [OPTION]... [FILE]...
+
+.SH DESCRIPTION
+Sort a FASTQ file, outputing the sorted file to standard out. If no files are
+given, read from standard input.
+
+.SH OPTIONS
+.TP
+\fB\-r\fR, \fB\-\-reverse\fR
+Sort in reverse (i.e., descending) order.
+.TP
+\fB\-I\fR, \fB\-\-id\fR
+Sort alphabetically by read identifier.
+.TP
+\fB\-S\fR, \fB\-\-seq\fR
+Sort alphabetically by nucleotide sequence.
+.TP
+\fB\-R\fR, \fB\-\-random\fR
+Sort in random order. By default, a fixed seed is used so that random sort is
+deterministic. Use the '--seed' option to produce different random orderings on
+repeated runs.
+.TP
+\fB\-\-seed=[SEED]\fR
+If a decimal integer SEED is given, it is used as the seed when producing a
+random ordering. With no argument, a seed is generated using the current system
+time.
+.TP
+\fB\-G\fR, \fB\-\-gc\fR
+Sort by increasing GC-content.
+.TP
+\fB\-M\fR, \fB\-\-mean-qual\fR
+Sort by increasing mean quality score.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Output a help message and exit.
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Output version information and exit.
+
+.SH AUTHOR
+Written by Daniel C. Jones <dcjones@cs.washington.edu>

diff --git a/src/fastq-sort.c b/src/fastq-sort.c
index c8f80840232a06dd3ec729edfb3401b76d0b89fc..3a859bc69577c53b26f6f68a391af623d931fd86 100644 (file)
--- a/src/fastq-sort.c
+++ b/src/fastq-sort.c
@@ -406,7 +406,7 @@ void print_help()
 "  -R, --random       randomly shuffle the sequences\n"
 "      --seed[=SEED]  seed to use for random shuffle.\n"
 "  -G, --gc           sort by GC content\n"
-"  -M, --mean-qual  sort by median quality score\n" /* TODO */
+"  -M, --mean-qual    sort by median quality score\n"
 "  -h, --help         print this message\n"
 "  -V, --version      output version information and exit\n"
    );