From bf0cb27489b0e0e00190c4ea2e08290fb3817626 Mon Sep 17 00:00:00 2001 From: Martin Herkt Date: Fri, 24 Apr 2015 03:27:50 +0200 Subject: [PATCH] man: fix PDF build MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The build failed because rst2pdf apparently has problems with page breaks. In this case, the link to the ALSA upmix guide was causing a page break in an admonition block. My guess is that rst2pdf screws up when it can’t fill at least one line of text following a page break, so I worked around this by making that paragraph a little longer. Seems to do the trick. I also shortened the URL using GitHub’s service because it was causing some rather unsightly formatting in the manpage output. Maybe we should just build HTML instead of a PDF. --- DOCS/man/ao.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/DOCS/man/ao.rst b/DOCS/man/ao.rst index 5ca960c4ea..534f62588c 100644 --- a/DOCS/man/ao.rst +++ b/DOCS/man/ao.rst @@ -107,8 +107,10 @@ Available audio output drivers are: ``--audio-device`` to select the device (use ``--audio-device=help`` to get a list of all devices and their mpv name). - You can also try - `Using the upmix plugin `_. + You can also try `using the upmix plugin `_. + This setup enables multichannel audio on the ``default`` device + with automatic upmixing with shared access, so playing stereo + and multichannel audio at the same time will work as expected. ``oss`` OSS audio output driver