diff --git a/tool_conf.xml.sample b/tool_conf.xml.sample
index 527ea47a7f5..bdd1f354af1 100644
--- a/tool_conf.xml.sample
+++ b/tool_conf.xml.sample
@@ -72,10 +72,6 @@
-
-
-
-
@@ -175,32 +171,27 @@
+
+
-
-
-
-
-
-
-
-
+
-
-
-
+
+
+
diff --git a/tools/fastx_toolkit/fastq_quality_converter.xml b/tools/fastx_toolkit/fastq_quality_converter.xml
index 514814fd9fd..88cdf41e19b 100644
--- a/tools/fastx_toolkit/fastq_quality_converter.xml
+++ b/tools/fastx_toolkit/fastq_quality_converter.xml
@@ -2,7 +2,7 @@
(ASCII-Numeric)zcat -f $input | fastq_quality_converter $QUAL_FORMAT -o $output -Q $offset
-
+
@@ -11,7 +11,7 @@
-
+
@@ -47,7 +47,7 @@
-
+
diff --git a/tools/fastx_toolkit/fastq_to_fasta.xml b/tools/fastx_toolkit/fastq_to_fasta.xml
index fe4496f0ed9..ccfb30453d0 100644
--- a/tools/fastx_toolkit/fastq_to_fasta.xml
+++ b/tools/fastx_toolkit/fastq_to_fasta.xml
@@ -3,7 +3,7 @@
gunzip -cf $input | fastq_to_fasta $SKIPN $RENAMESEQ -o $output -v
-
+
diff --git a/tools/fastx_toolkit/fastx_quality_statistics.xml b/tools/fastx_toolkit/fastx_quality_statistics.xml
index 713caff0550..22a9485edbf 100644
--- a/tools/fastx_toolkit/fastx_quality_statistics.xml
+++ b/tools/fastx_toolkit/fastx_quality_statistics.xml
@@ -3,11 +3,8 @@
zcat -f $input | fastx_quality_stats -o $output -Q $offset
-
-
-
-
-
+
+
diff --git a/tools/metag_tools/split_paired_reads.xml b/tools/metag_tools/split_paired_reads.xml
index 58b6408bb43..5803347ab21 100644
--- a/tools/metag_tools/split_paired_reads.xml
+++ b/tools/metag_tools/split_paired_reads.xml
@@ -4,7 +4,7 @@
split_paired_reads.py $input $output1 $output2
-
+
@@ -12,8 +12,8 @@
-
-
+
+
diff --git a/tools/next_gen_conversion/fastq_gen_conv.xml b/tools/next_gen_conversion/fastq_gen_conv.xml
index 3102137b754..64c2be7a6fc 100644
--- a/tools/next_gen_conversion/fastq_gen_conv.xml
+++ b/tools/next_gen_conversion/fastq_gen_conv.xml
@@ -1,5 +1,5 @@
- converts any type of FASTQ file to Sanger type and validates data
+ converts any FASTQ to Sanger
fastq_gen_conv.py
--input=$input
@@ -18,24 +18,24 @@
--output=$output
-
+
-
-
-
-
+
+
+
+
-
-
-
+
+
+
-
+
@@ -62,39 +62,45 @@
**What it does**
-This tool takes a FASTQ file (Solexa or Illumina) and converts it to Sanger format. It only converts valid blocks. It also can confirm the validity of Sanger FASTQ.
+Galaxy pipeline for mapping of Illumina data requires data to be in fastq format with quality values conforming to so called "Sanger" format. Unfortunately there are many other types of fastq. Thus the main objective of this tool is to "groom" multiple types of fastq into Sanger-conforming fastq that can be used in downstream application such as mapping.
+
+.. class:: infomark
+
+**TIP**: If the input dataset is already in Sanger format the tool does not perform conversion. However validation (described below) is still performed.
-----
-**Example**
+**Types of fastq datasets**
-- Converting the following Solexa FASTQ file::
+A good description of fastq datasets can be found `here`__, while a description of Galaxy's fastq "logic" can be found `here`__. Because ranges of quality values within different types of fastq datasets overlap it very difficult to detect them automatically. This tool supports conversion of two commonly found types (Solexa/Illumina 1.0 and Illumina 1.3+) into fastq Sanger.
- @seq1
- AGTCGTGGTCATCGTGACTAGTCGATCTAGCTAGCTCTCTAGAGTGT
- +
- ;>@BCEFGHJKLMNOPQRSTUVWXYZ[\]^_?abcdefghijklmno
- @seq2
- AGTCGTTGTCATCGTGACTAGTCGATCTAGCTAGCTCTCTAGAGTGT
- +
- ;>@BCElcH@KLMNOPQ>STZVWbYu[\]^_?a=;d?fghijklmno
- @seq3
- AGTCGTCGTCATCGTGACTAGTCGATCTAGCTAGCTCTCTAGAGTGT
- +
- 7>@BCEFGHJKLMNOPQRSTUVWXYZ[\]^_?abcdefghijklmno
+ .. __: http://en.wikipedia.org/wiki/FASTQ_format
+ .. __: http://bitbucket.org/galaxy/galaxy-central/wiki/NGS
-- will produce the following Sanger FASTQ data::
+.. class:: warningmark
+
+**NOTE** that there is also a type of fastq format where quality values are represented by a list of space-delimited integers (e.g., 40 40 20 15 -5 20 ...). This tool **does not** handle such fastq. If you have such a dataset, it needs to be converted into ASCII-type fastq (where quality values are encoded by characters) by "Numeric-to-ASCII" utility before it can accepted by this tool.
+
+-----
+
+**Validation**
+
+In addition to converting quality values to Sanger format the tool also checks the input dataset for consistency. Specifically, it performs these four checks:
+
+- skips empty lines
+- checks that blocks are properly formed by making sure that:
+
+ #. there are four lines per block
+ #. the first line starts with "@"
+ #. the third line starts with "+"
+ #. lengths of second line (sequences) and the fourth line (quality string) are identical
+
+- checks that quality values are within range for the chosen fastq format (e.g., the format provided by the user in **How do you think quality values are scaled?** drop down.
+
+To see exactly what the tool does you can take a look at its source code `here`__.
+
+ .. __: http://bitbucket.org/galaxy/galaxy-central/src/tip/tools/next_gen_conversion/fastq_gen_conv.py
- @seq1
- AGTCGTGGTCATCGTGACTAGTCGATCTAGCTAGCTCTCTAGAGTGT
- +
- "#$%%''()+,-./0123456789:;<=>?@#BCDEFGHIJKLMNOP
- @seq2
- AGTCGTTGTCATCGTGACTAGTCGATCTAGCTAGCTCTCTAGAGTGT
- +
- "#$%%'MD)$,-./012#45;78C:V%lt;=>?@#B""E#GHIJKLMNOP
-
-- Note that seq3 was not converted, because it contained an invalid Solexa quality value (7).