Zulip Chat Archive
Stream: mathlib4
Topic: Still struggling with CI
Dominic Steinitz (Jan 23 2026 at 08:41):
I have
/-
Copyright (c) 2026 Dominic Steinitz. All rights reserved.
Released under Apache 2.0 license as described in the file LICENSE.
Authors: Dominic Steinitz
-/
module
public import Mathlib.Init
public import Mathlib.Analysis.InnerProductSpace.PiL2
public import Mathlib.Geometry.Manifold.Sheaf.Basic
public import Mathlib.Geometry.Manifold.VectorBundle.LocalFrame
public import Mathlib.Geometry.Manifold.VectorField.Pullback
open scoped Manifold
and lint(?) complains: "The module doc-string for a file should be the first command after the imports.
Please, add a module doc-string before open scoped Manifold."
But what is a module doc-string?
public import Mathlib.Geometry.Manifold.VectorField.Pullback
/-- A module doc-string -/
Still gives me a lint error.
Also at some point on my CI journey, CI wanted me to have this public import Mathlib.Init but I have no idea why.
As Schiller might have put it: Gegen CI kämpfen selbst die Götter vergebens.
Dominic Steinitz (Jan 23 2026 at 08:47):
/-! # Ehresmann Connections This file defines Ehresmann connections on fiber bundles and establishes basic properties.## Main definitions * verticalSubspace: The vertical subspace at a point in the total space * EhresmannConnection: A smooth distribution of horizontal subspaces complementary to the vertical ## References * [Kobayashi and Nomizu, Foundations of Differential Geometry][kobayashi1963] -/
Apparently I needed a !
Michael Rothgang (Jan 23 2026 at 08:47):
Yes, a module doc-string starts with /-!; a /-- starts a doc comment.
Michael Rothgang (Jan 23 2026 at 08:48):
If you have imported other mathlib files, you shouldn't need public import Mathlib.Init any more.
Michael Rothgang (Jan 23 2026 at 08:59):
If CI still requires it, feel free to DM me and I'll investigate: that would sound like a bug.
Dominic Steinitz (Jan 23 2026 at 09:58):
All good now thanks :-)
Last updated: Feb 28 2026 at 14:05 UTC