Skip to content

Use :guilabel: markup in IDLE doc#141371

Open
StanFromIreland wants to merge 5 commits intopython:mainfrom
StanFromIreland:idle-markup
Open

Use :guilabel: markup in IDLE doc#141371
StanFromIreland wants to merge 5 commits intopython:mainfrom
StanFromIreland:idle-markup

Conversation

@StanFromIreland
Copy link
Copy Markdown
Member

@StanFromIreland StanFromIreland commented Nov 10, 2025

# Conflicts:
#	Doc/library/idle.rst
#	Lib/idlelib/help.html
@StanFromIreland
Copy link
Copy Markdown
Member Author

@terryjreedy could you take a look please?

which window type it is associated with.

Output windows, such as used for Edit => Find in Files, are a subtype of editor
Output windows, such as used for :menuselection:`&Edit --> Find in Files`,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand what is going on with & and underlines. The github .rst diff above shows the E of Edit underlined, as does the resulting preview. But the unchanged suggestion (with 'suggestion tag removed')

Output windows, such as used for :menuselection:`&Edit --> Find in Files`,

does not. This suggests that there is no underline in the revised text (and how could there be) and that gh is slightly lying as to the file content. I found the guilabel and menuselection doc in the devguide but no mention of & as inline text markup in the devguide or reST docs. Can you explain?

I still need to check the IDLE's Help --> IDLE doc result produced by help.py.

[It occurs to me that IDLE could improve upon Sphinx's html, and not just copy it, by adding color, but this would be follow-up issue, enabled by this one.]

Copy link
Copy Markdown
Member Author

@StanFromIreland StanFromIreland Feb 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you explain?

The Sphinx docs can :-)

IDLE's Help --> IDLE doc result produced by help.py.

I added one to the PR description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants