Sphinx-prompt[1] helps bring-in '.. prompt::' option that allows a better rendered documentation, yet be able to copy paste without picking up the prompt from the rendered documentation. [1] https://pypi.org/project/sphinx-prompt/ Link: https://lore.kernel.org/all/87fs48rgto.fsf@xxxxxxxxxxxx/ Suggested-by: Mattijs Korpershoek <mkorpershoek@xxxxxxxxxxxx> Suggested-by: Heinrich Schuchardt <heinrich.schuchardt@xxxxxxxxxxxxx> Signed-off-by: Nishanth Menon <nm@xxxxxx> --- I would have added Reported-by for Simon, since he reported the issue in the first place.. but it was for the u-boot documentation, so skipping here. Documentation/conf.py | 2 +- Documentation/sphinx/requirements.txt | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index d4fdf6a3875a..2eff713c4728 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -55,7 +55,7 @@ needs_sphinx = '1.7' extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', 'kfigure', 'sphinx.ext.ifconfig', 'automarkup', 'maintainers_include', 'sphinx.ext.autosectionlabel', - 'kernel_abi', 'kernel_feat'] + 'kernel_abi', 'kernel_feat', 'sphinx-prompt'] if major >= 3: if (major > 3) or (minor > 0 or patch >= 2): diff --git a/Documentation/sphinx/requirements.txt b/Documentation/sphinx/requirements.txt index 335b53df35e2..24a59ceda582 100644 --- a/Documentation/sphinx/requirements.txt +++ b/Documentation/sphinx/requirements.txt @@ -1,3 +1,4 @@ # jinja2>=3.1 is not compatible with Sphinx<4.0 jinja2<3.1 Sphinx==2.4.4 +sphinx-prompt==1.5.0 -- 2.40.0