Bug#1110218: release-notes: debian-security sources in trixie shows URI not formated correctly on the PDF
Hi,
Justin B Rye <justin.byam.rye@gmail.com> wrote (Fri, 1 Aug 2025 13:29:34 +0100):
> Guillermo Torres Zamora wrote:
> > Dear Maintainer,
> >
> > * What led up to the situation?
> > I was reading the release notes and the URI was like https://security.debian.org/debian\unhbox\voidb@x\kern\z@\char‘\protect\
> > discretionary{\char\defaulthyphenchar}{}{}security when it should probably be https://security.debian.org/debian-security
>
> For others trying to find this: it's the PDF version of section 4.3.1,
> where the .rst source has a completely normal ASCII hyphenminus, so
> I've no idea what sphinx is playing at here.
A workaround would be to change the markup like this:
-.. parsed-literal::
+.. code-block:: console
This way the content gets displayed in a box, as for other console examples
(not bad, even an improvement IMO).
And no issue with the hyphen.
Patch attached.
--
Holger Wansing <hwansing@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
diff --git a/source/upgrading.rst b/source/upgrading.rst
index 8c581b3c..9c2b3ed4 100644
--- a/source/upgrading.rst
+++ b/source/upgrading.rst
@@ -517,21 +517,21 @@ automatically downloaded from a server near you in network terms. As
this is a relatively new service, older installations may have
configuration that still points to one of the main Debian Internet
servers or one of the mirrors. If you haven't done so yet, it is
recommended to switch over to the use of the CDN service in your APT
configuration.
To make use of the CDN service, the correct configuration for APT
(assuming you are using ``main`` and ``non-free-firmware``) is the following
in ``/etc/apt/sources.list.d/debian.sources``:
-.. parsed-literal::
+.. code-block:: console
Types: deb
URIs: https://deb.debian.org/debian
Suites: |RELEASENAME| |RELEASENAME|-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: |RELEASENAME|-security
@@ -564,21 +564,21 @@ For example, your package mirror may be under ``/var/local/debian/``,
and have main directories like this:
.. parsed-literal::
/var/local/debian/dists/|RELEASENAME|/main/...
/var/local/debian/dists/|RELEASENAME|/contrib/...
To use this with **apt**, add the following to your
``/etc/apt/sources.list.d/debian.sources`` file:
-.. parsed-literal::
+.. code-block:: console
Types: deb
URIs: file:/var/local/debian
Suites: |RELEASENAME|
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Again, after adding your new sources, disable the previously existing
archive entries.
Reply to: