Skip to content

gh-149187: Doc: Add frozendict to functions.rst#149185

Open
oyvindronningstad wants to merge 1 commit intopython:mainfrom
oyvindronningstad:doc-frozendict-functions
Open

gh-149187: Doc: Add frozendict to functions.rst#149185
oyvindronningstad wants to merge 1 commit intopython:mainfrom
oyvindronningstad:doc-frozendict-functions

Conversation

@oyvindronningstad
Copy link
Copy Markdown

@oyvindronningstad oyvindronningstad commented Apr 30, 2026

Add frozendict to the Built-in Functions table, and add a short entry on the page, derived from the dict and frozenset entries.

Also, mention frozendict in the dict entry.

@python-cla-bot
Copy link
Copy Markdown

python-cla-bot Bot commented Apr 30, 2026

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Apr 30, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Apr 30, 2026
@read-the-docs-community
Copy link
Copy Markdown

read-the-docs-community Bot commented Apr 30, 2026

Documentation build overview

📚 cpython-previews | 🛠️ Build #32582038 | 📁 Comparing 786e218 against main (7686abe)

  🔍 Preview build  

74 files changed · + 1 added · ± 73 modified

+ Added

± Modified

@oyvindronningstad oyvindronningstad changed the title Doc: Add frozendict to functions.rst gh-149187: Doc: Add frozendict to functions.rst Apr 30, 2026
Copy link
Copy Markdown
Member

@sobolevn sobolevn left a comment

Choose a reason for hiding this comment

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

Thank you!

Comment thread Doc/library/functions.rst
| | :func:`dir` | | :func:`isinstance` | | | | |
| | :func:`divmod` | | :func:`issubclass` | | | | **_** |
| | | | :func:`iter` | | | | :func:`__import__` |
| | :func:`bin` | | |func-frozendict|_ | | :func:`min` | | :func:`sentinel` |
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.

That's unfortunate that we have to make so many code changes for a single line :(

But, AFAIK there's no other way, see 29a92ab as an example.

Copy link
Copy Markdown
Author

@oyvindronningstad oyvindronningstad May 2, 2026

Choose a reason for hiding this comment

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

It's possible to forego the empty space before the "G:", which will give a 2-line change instead. Your call.

Copy link
Copy Markdown
Author

@oyvindronningstad oyvindronningstad May 2, 2026

Choose a reason for hiding this comment

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

0c3441a <- 2-line change alternative

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.

Would using a list-table help for future edits?

https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table

Comment thread Doc/library/functions.rst Outdated
Comment thread Doc/library/functions.rst Outdated
@oyvindronningstad oyvindronningstad force-pushed the doc-frozendict-functions branch from f0b8048 to 2bbe0c7 Compare May 2, 2026 15:58
@oyvindronningstad oyvindronningstad requested a review from sobolevn May 2, 2026 16:02
@oyvindronningstad
Copy link
Copy Markdown
Author

@sobolevn Thanks for the review! Are there other reviewers I should add?

@StanFromIreland
Copy link
Copy Markdown
Member

Are there other reviewers I should add?

Please don't ping people at random. CODEOWNERS/experts are generally requested automatically.

Comment thread Doc/library/functions.rst Outdated
frozendict(iterable, /, **kwargs)
:noindex:

Create a new frozen dictionary. The :class:`frozendict` object is a builtin class.
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.

@nedbat, is the linklint update ready so that we can fix the rendering here?

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.

linklint==1.0.0 will do it correctly. I'm not sure at the moment how the requirements are handled. It looks like it's still with a manually updated pylock.toml file. That file still uses linklint=0.4.1.

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.

It looks like it's still with a manually updated pylock.toml file.

Do you plan to open a PR for that, otherwise I think we can bundle it in here?

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 wasn't planning to because I don't know the intent for the future. Hugo seemed in charge of it.

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.

Go for it! Either here or a new PR.

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.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I rebased on main after 149467, tell me if I need to do more.

@oyvindronningstad oyvindronningstad force-pushed the doc-frozendict-functions branch from 2bbe0c7 to c50a587 Compare May 7, 2026 08:16
@oyvindronningstad
Copy link
Copy Markdown
Author

oyvindronningstad commented May 7, 2026

CODEOWNERS/experts are generally requested automatically.

I'm new here, but it might seem like that automation for this doesn't work for functions.rst. No reviewers were added for a number of days. Just FYI

Comment thread Doc/library/functions.rst Outdated
frozendict(iterable, /, **kwargs)
:noindex:

Create a new frozen dictionary. The :class:`frozendict` object is a builtin class.
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.

Suggested change
Create a new frozen dictionary. The :class:`frozendict` object is a builtin class.
Create a new frozen dictionary. The :class:`frozendict` object is a built-in class.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Thanks, done

@StanFromIreland
Copy link
Copy Markdown
Member

No reviewers were added for a number of days.

That's because all reviewers have already been added.

@oyvindronningstad
Copy link
Copy Markdown
Author

oyvindronningstad commented May 7, 2026

That's because all reviewers have already been added.

I meant before that. The PR had been open for 5 days when you were added. But again, I don't know anything about your codeowners system.

Add frozendict to the Built-in Functions table, and add a short entry
on the page, derived from the dict and frozenset entries.

Also, mention frozendict in the dict entry.

Signed-off-by: Øyvind Rønningstad <oyvind.ronningstad@nordicsemi.no>
@oyvindronningstad oyvindronningstad force-pushed the doc-frozendict-functions branch from c50a587 to 786e218 Compare May 7, 2026 09:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

5 participants