Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Nested formatter status - missing from current version of API docs #4111

Closed
eldjh3 opened this issue Aug 6, 2024 · 2 comments
Closed

Nested formatter status - missing from current version of API docs #4111

eldjh3 opened this issue Aug 6, 2024 · 2 comments
Labels

Comments

@eldjh3
Copy link

eldjh3 commented Aug 6, 2024

RE: #2086 (comment)

This comment on an earlier issue mentions the recommended way to perform formatting of nested/complex objects.
It mentions it's experimental at that point in time.

The documentation is no longer present in the API page of the docs. It was commented out in 97117cb "Migrate to mkdocs".

What's the status now? Is it's omission from the docs an oversight or is it no longer experimental but deprecated?

I was experimenting with it and noticed that some of the specifiers are applied to the constituents but some only to the complete value. I wasn't sure if that was intentional at first. It is in fact documented, but only in the (now commented out) section.

@eldjh3
Copy link
Author

eldjh3 commented Aug 7, 2024

Incidentally, it looks like the width is actually applied to elements, contrary to what the commented out doc states.
https://godbolt.org/z/KsM5shEnY

Notice that fill, align and width are applied to the whole object which
is the recommended behavior while the remaining specifiers apply to
elements.

ED: Seems to be dependent on the value type. Works as documented for string types, width applies to entire value.

@vitaut
Copy link
Contributor

vitaut commented Aug 7, 2024

It was removed intentionally from the docs and requires a bit more work to fix width/precision handling, see #3860.

@vitaut vitaut closed this as completed Aug 7, 2024
@vitaut vitaut added the question label Aug 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants