Ruthlessly tidied up the examples directory.

The Makefile and C programs are gone. They didn't build and mostly
were redundant anyway. Arguably chk_indel.c and bam2bed.c could still
have a use, but as toy examples they would belong in an htslib rather
than here anyway.

The README file was updated to use more modern command alternatives
(view vs import, mpileup vs pileup), but does not yet contain any
references to CRAM.  This can be added once -T is working.
Revert to ex1.sam.gz; fix mpileup command lines

At present there doesn't seem to be any way to get mpileup to read
@SQ-headerless SAM files, so use the BAM files in the example instead.
Merge examples/ tidy up (PR #226)

(Cherry-picked from the pull request so as to avoid introducing ex1.sam,
which is uncompressed and voluminous.  Closes #226.)