sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.63k stars 2.13k forks source link

Man page rendering leaks bold with parsed-literal #10837

Open cmouse opened 2 years ago

cmouse commented 2 years ago

Describe the bug

When creating manpages with make man, parsed-literal secrtions end up leaking bold somehow.

How to Reproduce


EXAMPLE
=======

Add a director with vhost count 150 (or change existing one's vhost
count to 150):

.. parsed-literal::

   **doveadm -v director add x1357.imap.ha.example.net 150**
   2001:db8:543:6861:143::1357: OK

Remove a director:

.. parsed-literal::

   **doveadm director remove x1357.imap.ha.example.net**
   test 

Query the status of mail hosts in a director:

.. parsed-literal::

   **doveadm director status**
   mail server ip       vhosts  users
   192.168.10.1            100    125
   192.168.10.2            100    144
   192.168.10.3            100    115

Query the status of a user's assignment:

.. parsed-literal::

   **doveadm director status user@example.com**
   Current: 192.168.10.1 (expires 2010-06-18 20:17:04)
   Hashed: 192.168.10.2
   Initial config: 192.168.10.3

### Expected behavior

This should render as

EXAMPLE
Add a director with vhost count 150 (or change existing one's vhost count to 150):

**doveadm -v director add x1357.imap.ha.example.net 150**
2001:db8:543:6861:143::1357: OK

Remove a director:

**doveadm director remove x1357.imap.ha.example.net**
test

Query the status of mail hosts in a director:

**doveadm director status**
mail server ip       vhosts  users
192.168.10.1            100    125
192.168.10.2            100    144
192.168.10.3            100    115

Query the status of a user's assignment:

**doveadm director status user@example.com**
Current: 192.168.10.1 (expires 2010-06-18 20:17:04)
Hashed: 192.168.10.2
Initial config: 192.168.10.3

But instead it renders as

This should render as

EXAMPLE
Add a director with vhost count 150 (or change existing one's vhost count to 150):

**doveadm -v director add x1357.imap.ha.example.net 150**
2001:db8:543:6861:143::1357: OK

**Remove a director:**

**doveadm director remove x1357.imap.ha.example.net**
**test**

**Query the status of mail hosts in a director:**

**doveadm director status**
**mail server ip       vhosts  users**
**192.168.10.1            100    125**
**192.168.10.2            100    144**
**192.168.10.3            100    115**

**Query the status of a user's assignment:**

**doveadm director status user@example.com**
**Current: 192.168.10.1 (expires 2010-06-18 20:17:04)**
**Hashed: 192.168.10.2**
**Initial config: 192.168.10.3**

but only with "man" driver

### Your project

https://github.com/dovecot/documentation

### Screenshots

_No response_

### OS

Linux

### Python version

3.10.4

### Sphinx version

4.2.0

### Sphinx extensions

phinx.ext.autodoc, sphinx.ext.doctest, sphinx.ext.mathjax, sphinx.ext.ifconfig, sphinx.ext.todo, sphinx_copybutton, sphinx_removed_in, dovecot_sphinx

### Extra tools

_No response_

### Additional context

_No response_
cmouse commented 2 years ago

The ** are not actually visible in the output, they are needed on github to point out the strong text