-
-
Notifications
You must be signed in to change notification settings - Fork 5.5k
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
more consistently show lists with spaces #20288
Conversation
with the addition of the space-separate ` where ` syntax, the printing of types in lists was otherwise unbalanced also remove multiline handling from show_delim_array. this was a relic from before multiline handling was consistent in show. now it just (incorrectly) adds excessive newlines after multi-dimensional arrays.
if we print `lb`, then we must print `ub`, even if it does not contain essential information, otherwise type signatures might not be able to round-trip correctly through parsing
No strong opinion on this but I notice it still doesn't use spaces in type parameters:
Except of course the method one will have to change anyway. |
RIP doctests |
But seriously, it's pretty much impossible to work with doctests now. That this wasn't taken into considering before merging is a bit disappointing. Guess I will work on a branch where this is reverted. |
I suspect it didn't occur to @vtjnash that this would trash the doctests. It seems like the way to work with doctests should be to generate the new output so that you can do a |
Why aren't we running the doctests on CI? |
I think it has to do with how Documenter works. IIRC it's only set up to build the docs when merging to master, but I could be wrong on that. cc @MichaelHatherly |
Because @KristofferC, @kshyatt and @fredrikekre have been busting their butts to get the doctests to actually pass! Which this completely screws up. It breaks the doctests again and causes all their PRs to conflict. |
We've never had doctests running on CI because they never stayed passing on master long enough for someone to follow that through all the way, but we were getting really close this time. Ref #19528 |
So ... I'll make a PR adding a mode to Documenter that can auto-update the doctest output. That seems like a positive outcome? (and the work to get doctests written will be able to keep going?) |
See #20274 for the umbrella doctest tracking issue. |
#yolo