From fe7e1ae8aa880641d239a94d0d0df57e2dc39a7e Mon Sep 17 00:00:00 2001 From: Max Kellermann 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 ` 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