Bug#1110218: release-notes: debian-security sources in trixie shows URI not formated correctly on the PDF

Chris Hofstaedtler <[email protected]> Fri, 1 Aug 2025 16:39:30 +0200
Newsgroups gmane.linux.debian.devel.documentation
Message-ID <aIzRok0LLjZGTtFf__26588.1290471711$1754059295$gmane$org@per.namespace.at>
On Fri, Aug 01, 2025 at 03:29:45PM +0200, Holger Wansing wrote:
> Justin B Rye <[email protected]> wrote (Fri, 1 Aug 2025 13:29:34 +0100):
> > Guillermo Torres Zamora wrote:
> > >    * 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.

> diff --git a/source/upgrading.rst b/source/upgrading.rst
> index 8c581b3c..9c2b3ed4 100644
> --- a/source/upgrading.rst
> +++ b/source/upgrading.rst
  
> -.. parsed-literal::
> +.. code-block:: console
>  
>     Types: deb
>     URIs: https://deb.debian.org/debian
>     Suites: |RELEASENAME| |RELEASENAME|-updates

This is now rendered literally. `parsed-literal` is required to 
interpolate |RELEASENAME|.

Some other way will have to be found.

Chris