Clean up AsciiDoc formating, prefer prefix headings

Author: chungy

NEWS.adoc

@@ -1,51 +1,42 @@
-1.5 (2017-08-16)
-----------------
+== 1.5 (2017-08-16)
 
   * reflac has learned to preserve an embedded image in FLAC files.
     Limited to just one image for now, but should cover the most
     common case.
 
-
-1.4 (2016-12-16)
-----------------
+== 1.4 (2016-12-16)
 
   * Add an option to preserve the file modification time.
 
-1.3 (2016-09-25)
-----------------
+== 1.3 (2016-09-25)
 
   * Use the rf64 format during processing, eliminating the 4GiB
     uncompressed file size limit.  This is primarily useful for FLACs
     with lots of channels (eg, surround sound) and high sample sizes
     and rates, as the 4GiB limit isn’t otherwise likely to be hit.
 
-1.2.3 (2016-07-10)
-------------------
+== 1.2.3 (2016-07-10)
 
   * Actually bump the script’s own version identifier.
 
-1.2.2 (2016-07-10)
-------------------
+== 1.2.2 (2016-07-10)
 
   * The first bash in the $PATH is used instead of /bin/bash
   * Shift temporary directory creation after getopt.  reflac won’t
     leave one around anymore after ambiguous options (such as “--v”
     expanding to both “--verbose” and “--version”).
 
-1.2.1 (2016-04-28)
-------------------
+== 1.2.1 (2016-04-28)
 
   * Remove the temporary directory also after using `--version`
 
-1.2 (2016-04-28)
-----------------
+== 1.2 (2016-04-28)
 
   * Sync data by default, add `--no-sync` to disable.  The new
     versions of FLACs files are written out to prevent
     missing/incomplete files in the face of a crash.
 
-1.1 (2016-04-25)
-----------------
+== 1.1 (2016-04-25)
 
   * Add `--no-action`, enabling the view of files that would be
     processed.
@@ -56,20 +47,17 @@
   * Use a temporary staging directory, avoiding the possibility of
     losing all existing tag data in the face of errors.
 
-1.0 (2016-04-17):
------------------
+== 1.0 (2016-04-17)
 
   * Use the so-called “bash strict mode” and enable better processing
     of special file names.
 
-0.2 (2015-05-18):
------------------
+== 0.2 (2015-05-18)
 
   * Added a recursive option, allowing a whole tree to be
     recompressed.
 
-0.1 (2014-02-26):
------------------
+== 0.1 (2014-02-26)
 
   * Initial release, expanded from a ~7 line script the author
     initially wrote around 2003.

README.adoc

@@ -1,5 +1,4 @@
-reflac
-======
+= reflac
 
 This is a script that allows you to recompress FLAC files while
 preserving their tags, intended for whole directories and for safety
@@ -19,8 +18,7 @@ black/white display iPod, and found that `flac -3` was the maximum he
 could compress FLACs while maintaining uninterrupted playback on the
 device.
 
-Requirements
-------------
+== Requirements
 
 Both `flac` and `metaflac` need to be in your $PATH.  These programs
 are normally packaged together as “flac” by distributions.
@@ -33,8 +31,7 @@ compatibility with the same switches found in the GNU versions.
 reflac has only been developed on tested on GNU+Linux, but should work
 on any other operating system with the appropriate tools.
 
-Safety
-------
+== Safety
 
 By default, reflac performs a sync on files after two points of its
 process: after moving the recompressed file from the temporary
@@ -52,8 +49,7 @@ scenarios should arise in the worst case:
   processed, which may or may not be a complete FLAC file, the status
   of which can be tested with `flac -t`.
 
-Running
--------
+== Running
 
 ....
 Usage: reflac [OPTION]... [--] DIRECTORY...
@@ -79,8 +75,7 @@ files. Optionally terminate the argument list with -- so that any
 possible directory names don’t get misinterpreted as arguments.
 ....
 
-Bugs
-----
+== Bugs
 
 What, bugs?  This program is flawless!  Joking aside, although the
 author tries to resolve in reflac itself, it is at the mercy of bugs

reflac.adoc

@@ -1,18 +1,14 @@
-reflac(1)
-=========
+= reflac(1)
 :doctype: manpage
 
 
-NAME
-----
+== NAME
 reflac - recompress FLAC files
 
-SYNOPSIS
---------
+== SYNOPSIS
 *reflac* ['OPTIONS'...] ['--'] 'DIRECTORY'...
 
-DESCRIPTION
------------
+== DESCRIPTION
 reflac recompresses FLAC files while preserving all of their tags, and
 one embedded image.  It should always be safe to run, it handles cases
 of special file names well, allowing odd characters such as *, ?, |,
@@ -69,7 +65,6 @@ encoding and decoding.  Real-time playback may not be possible on some
 embedded-type systems, such as Blu-ray players or portable music
 players.
 
-COPYRIGHT
----------
+== COPYRIGHT
 reflac is licensed under a very permissive ISC license, the same
 prefered by OpenBSD.  See *COPYING* in the distribution for details.