Zulip Chat Archive
Stream: mathlib4
Topic: missing docstrings?
Jared green (Jan 29 2025 at 14:09):
im on lean 4.15.0, rev# 9837ca9d65d9de6fad1ef4381750ca688774e608.
i tried to import import Mathlib.Data.Lists.Sublists, Mathlib.Data.Multiset.Basic, Mathlib.Algebra.BigOperators.Group.List.Basic. in the infoview a get errors saying a bunch of definitions are missing a doc-string, the first one looks like this:
⚠ [24/474] Replayed Mathlib.Control.Combinators
warning: .\.\.lake/packages\mathlib\.\.\Mathlib\Control\Combinators.lean:35:4: Monad.mapM'
is missing a doc-string, please add one.
Declarations whose name ends with a '
are expected to contain an explanation for the presence of a '
in their doc-string. This may consist of discussion of the difference relative to the unprimed version, or an explanation as to why no better naming scheme is possible.
note: this linter can be disabled with set_option linter.docPrime false
any one of those imports triggers hundreds of errors just like that.
Eric Wieser (Jan 29 2025 at 14:10):
This was a bug in the linter's ignore mechanism, though I believe it doesn't hapen if you use lake exe cache get
first
Jared green (Jan 29 2025 at 14:18):
nothing changes. do i also have to restart vs code?
Jared green (Jan 29 2025 at 14:36):
i had mistyped one of the imports.
Last updated: May 02 2025 at 03:31 UTC