LaTeX: use current parskip package for better spacing around titles #12833
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
For years now we have been using LaTeX parskip v1 version. But this old package adds extra spacing around section titles which is definitely not good.
This was done at #5964 because (as reported in #5960) the parskip package changed suddenly its behavior in 2018 and as a result people could see their projects on RTD give different results from compiling at their locale due to one location using the new and nother location using the old
parskip
(definitely the new parskip should have been released as parskip2, i.e. not keep the same name).2018 is now 6 years ago.
I think it is time to use the currently maintained
parskip
version not the earlier version from 2001 (and even earlier).This will change all PDFs to have less exaggerated vertical spacings around section headings.
The current spacing is definitely anomalous.
In order to not re-create the #5960 problem that people may get different looking PDFs if compiling on a current system and simultaneously on an old one not up-to-date, we could also ship a
sphinxparskip.sty
which would be a clone of currentparskip.sty
with removal of dependency on LaTeX kernel features requiring its 2018-04-01 release (only a few lines to remove at top of theparskip.sty
file).+1 for that option which is the safest one (although it will override any upstream change to
parskip.sty
) and makes sure #5960 does not resuscitate. I will wait for advices.EDIT: attention that parskip v2 requires
etoolbox
package. It is part in Ubuntu of texlive-latex-recommended which we document as required and on Fedora part of texlive package people probably already require.