From fe7e1ae8aa880641d239a94d0d0df57e2dc39a7e Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Tue, 30 Oct 2018 21:50:37 +0100
Subject: [PATCH] doc/*.rst: revise captions and section types

---
 doc/developer.rst |  5 ++---
 doc/protocol.rst  | 12 ++++++------
 doc/user.rst      | 41 ++++++++++++++++++++---------------------
 3 files changed, 28 insertions(+), 30 deletions(-)

diff --git a/doc/developer.rst b/doc/developer.rst
index 7f8d9aecc..6acabd1dc 100644
--- a/doc/developer.rst
+++ b/doc/developer.rst
@@ -1,6 +1,5 @@
-============================================
-The Music Player Daemon - Developer's Manual
-============================================
+Developer's Manual
+##################
 
 Introduction
 ============
diff --git a/doc/protocol.rst b/doc/protocol.rst
index 618e784ec..bcdc0e0ca 100644
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -1,9 +1,9 @@
-================================
-The Music Player Daemon protocol
-================================
+########
+Protocol
+########
 
 General protocol syntax
-#######################
+***********************
 
 Protocol overview
 =================
@@ -254,7 +254,7 @@ may contain :ref:`song tags <tags>` and other metadata, specifically:
   "*2008-09-28T20:04:57Z*"
 
 Recipes
-#######
+*******
 
 Queuing
 =======
@@ -285,7 +285,7 @@ effect on the sequence.  During playback, a song's priority is
 reset to zero.
 
 Command reference
-#################
+*****************
 
 .. note:: For manipulating playlists and playing, there are two sets of
    commands.  One set uses the song id of a song in the playlist,
diff --git a/doc/user.rst b/doc/user.rst
index ce8b160a8..e88ea16d8 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -1,16 +1,15 @@
-=======================================
-The Music Player Daemon - User's Manual
-=======================================
+User's Manual
+#############
 
-Chapter 1. Introduction
-=======================
+Introduction
+************
 
 Music Player Daemon (:program:`MPD`) is a flexible, powerful, server-side application for playing music. Through plugins and libraries it can play a variety of sound files while being controlled by its network protocol.
 
 This document is work in progress. Most of it may be incomplete yet. Please help!
 
-Chapter 2. Installation
-=======================
+Installation
+************
 
 Installing on Debian/Ubuntu
 ---------------------------
@@ -207,8 +206,8 @@ To auto-start :program:`MPD` upon login, type:
 
     systemctl --user enable mpd
 
-Chapter 3. Configuration
-========================
+Configuration
+*************
 
 The Configuration File
 ----------------------
@@ -648,8 +647,8 @@ settings control this feature:
    * - **zeroconf_name NAME**
      - The service name to publish via Zeroconf. The default is "Music Player".
 
-Chapter 4. Advanced configuration
-=================================
+Advanced configuration
+**********************
 
 .. _satellite:
 
@@ -720,8 +719,8 @@ Note
 
 There is a rumor that real-time scheduling improves audio quality. That is not true. All it does is reduce the probability of skipping (audio buffer xruns) when the computer is under heavy load.
 
-Chapter 5. Using MPD
-====================
+Using MPD
+*********
 
 The client
 ----------
@@ -817,8 +816,8 @@ Stored Playlists
 
 Stored playlists are some kind of secondary playlists which can be created, saved, edited and deleted by the client. They are addressed by their names. Its contents can be loaded into the queue, to be played back. The playlist_directory setting specifies where those playlists are stored. 
 
-Chapter 6. Advanced usage
-=========================
+Advanced usage
+**************
 
 Bit-perfect playback
 --------------------
@@ -874,8 +873,8 @@ DSD (`Direct Stream Digital <https://en.wikipedia.org/wiki/Direct_Stream_Digital
 
 Native DSD playback is used automatically if available. DoP is only used if enabled explicitly using the dop option, because there is no way for :program:`MPD` to find out whether the DAC supports it. DSD to PCM conversion is the fallback if DSD cannot be used directly.
 
-Chapter 7. Client Hacks
-=======================
+Client Hacks
+************
 
 .. _external_mixer:
 
@@ -884,8 +883,8 @@ External Mixer
 
 The setting :code:`mixer_type "null"` asks MPD to pretend that there is a mixer, but not actually do something. This allows you to implement a :program:`MPD` client which listens for mixer events, queries the current (fake) volume, and uses it to program an external mixer. For example, your client can forward this setting to your amplifier.
 
-Chapter 8. Troubleshooting
-==========================
+Troubleshooting
+***************
 
 Where to start
 --------------
@@ -976,8 +975,8 @@ As soon as you have reproduced the crash, type "bt" on the gdb command prompt. C
 
 .. _plugin_references:
 
-Chapter 9. Plugin reference
-===========================
+Plugin reference
+****************
 
 .. _database_plugins: