.SH DESCRIPTION
.PP
Samtools is a set of utilities that manipulate alignments in the BAM
-format. It imports from and exports to the SAM (Sequence
-Alignment/Map) format, does sorting, merging and indexing, and
-allows to retrieve reads in any regions swiftly.
+format. It imports from and exports to the SAM (Sequence Alignment/Map)
+format, does sorting, merging and indexing, and allows to retrieve reads
+in any regions swiftly.
Samtools is designed to work on a stream. It regards an input file `-'
-as the standard input (stdin) and an output file `-' as the standard output
-(stdout). Several commands can thus be combined with Unix pipes. Samtools
-always output warning and error messages to the standard error output (stderr).
-
-Samtools is also able to open a BAM (not SAM) file on a remote FTP server if the BAM
-file name starts with `ftp://'.
-Samtools checks the current working directory for the index file and will
-download the index upon absence. Samtools achieves random FTP file access
-with the `REST' ftp command. It does not retrieve the entire
-alignment file unless it is asked to do so.
+as the standard input (stdin) and an output file `-' as the standard
+output (stdout). Several commands can thus be combined with Unix
+pipes. Samtools always output warning and error messages to the standard
+error output (stderr).
+
+Samtools is also able to open a BAM (not SAM) file on a remote FTP
+server if the BAM file name starts with `ftp://'. Samtools checks the
+current working directory for the index file and will download the index
+upon absence. Samtools achieves random FTP file access with the `REST'
+ftp command. It does not retrieve the entire alignment file unless it is
+asked to do so.
.SH COMMANDS AND OPTIONS
alignments overlapping the specified regions will be output. An
alignment may be given multiple times if it is overlapping several
regions. A region can be presented, for example, in the following
-format: `chr2', `chr2:1000000' or `chr2:1,000,000-2,000,000'. The coordinate
-is 1-based.
+format: `chr2', `chr2:1000000' or `chr2:1,000,000-2,000,000'. The
+coordinate is 1-based.
.B OPTIONS:
.RS
Output in the BAM format.
.TP
.B -u
-Output uncompressed BAM. This option saves time spent on compression/decomprssion
-and is thus preferred when the output is piped to another samtools command.
+Output uncompressed BAM. This option saves time spent on
+compression/decomprssion and is thus preferred when the output is piped
+to another samtools command.
.TP
.B -h
Include the header in the output.
Text alignment viewer (based on the ncurses library). In the viewer,
press `?' for help and press `g' to check the alignment start from a
-region in the format like `chr10:10,000,000'. Note that if the region
-showed on the screen contains no mapped reads, a blank screen will be
-seen. This is a known issue and will be improved later.
+region in the format like `chr10:10,000,000'.
.RE