Skip to content

Commit

Permalink
Fix indentation of doc strings (#3744)
Browse files Browse the repository at this point in the history
(cherry picked from commit 5bad134)
  • Loading branch information
joschmitt authored and benlorenz committed May 23, 2024
1 parent 644dc96 commit 83f0c18
Show file tree
Hide file tree
Showing 21 changed files with 54 additions and 54 deletions.
2 changes: 1 addition & 1 deletion experimental/LieAlgebras/src/LieSubalgebra.jl
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ function basis(S::LieSubalgebra, i::Int)
end

@doc raw"""
dim(S::LieSubalgebra) -> Int
dim(S::LieSubalgebra) -> Int
Return the dimension of the Lie subalgebra `S`.
"""
Expand Down
2 changes: 1 addition & 1 deletion experimental/LieAlgebras/src/RootSystem.jl
Original file line number Diff line number Diff line change
Expand Up @@ -720,7 +720,7 @@ function Base.deepcopy_internal(w::WeightLatticeElem, dict::IdDict)
end

@doc raw"""
getindex(w::WeightLatticeElem, i::Int) -> ZZRingElem
getindex(w::WeightLatticeElem, i::Int) -> ZZRingElem
Returns the coefficient of the `i`-th fundamental weight in `w`.
"""
Expand Down
2 changes: 1 addition & 1 deletion experimental/QuadFormAndIsom/src/lattices_with_isometry.jl
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ QuadSpaceWithIsom
ambient_space(Lf::ZZLatWithIsom) = Lf.Vf

@doc raw"""
ambient_isometry(Lf::ZZLatWithIsom) -> QQMatrix
ambient_isometry(Lf::ZZLatWithIsom) -> QQMatrix
Given a lattice with isometry $(L, f)$, return an isometry of the ambient
space of $L$ inducing $f$ on $L$.
Expand Down
8 changes: 4 additions & 4 deletions experimental/Schemes/Sheaves.jl
Original file line number Diff line number Diff line change
Expand Up @@ -121,10 +121,10 @@ function restriction_map(F::PreSheafOnScheme{<:Any, OpenType, OutputType, Restri
end

@doc raw"""
add_incoming_restriction!(F::AbsPreSheaf{<:Any, OpenType, <:Any, RestrictionType},
U::OpenType,
rho::RestrictionType
) where {OpenType, RestrictionType}
add_incoming_restriction!(F::AbsPreSheaf{<:Any, OpenType, <:Any, RestrictionType},
U::OpenType,
rho::RestrictionType
) where {OpenType, RestrictionType}
**Note:** This is a method for internal use!
Expand Down
2 changes: 1 addition & 1 deletion experimental/Schemes/SpaceGerms.jl
Original file line number Diff line number Diff line change
Expand Up @@ -1004,7 +1004,7 @@ end
# We want the singular locus of an `AbsSpaceGerm` to be a `SpaceGerm` again and
# not a plain `AffineScheme`.
@doc raw"""
singular_locus(X::AbsSpaceGerm) --> SpaceGerm, ClosedEmbedding
singular_locus(X::AbsSpaceGerm) --> SpaceGerm, ClosedEmbedding
Return the space germ (Y,p) for a given germ (X,p) and the closed embedding of (Y,p) into (X,p), where Y is the singular locus of X.
Expand Down
4 changes: 2 additions & 2 deletions experimental/Schemes/elliptic_surface.jl
Original file line number Diff line number Diff line change
Expand Up @@ -1284,7 +1284,7 @@ function horizontal_decomposition(X::EllipticSurface, F::Vector{QQFieldElem})
end

@doc raw"""
elliptic_parameter(X::EllipticSurface, F::Vector{QQFieldElem}) -> LinearSystem
elliptic_parameter(X::EllipticSurface, F::Vector{QQFieldElem}) -> LinearSystem
Return the elliptic parameter ``u`` of the divisor class `F`.
Expand Down Expand Up @@ -1324,7 +1324,7 @@ end


@doc raw"""
extended_ade(ADE::Symbol, n::Int)
extended_ade(ADE::Symbol, n::Int)
Return the dual intersection matrix of an extended ade Dynkin diagram
as well as the isotropic vector (with positive coefficients in the roots).
Expand Down
10 changes: 5 additions & 5 deletions src/AlgebraicGeometry/Curves/ProjectivePlaneCurve.jl
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ end
# multiplicity

@doc raw"""
multiplicity(C::ProjectivePlaneCurve{S}, P::AbsProjectiveRationalPoint)
multiplicity(C::ProjectivePlaneCurve{S}, P::AbsProjectiveRationalPoint)
Return the multiplicity of `C` at `P`.
"""
Expand Down Expand Up @@ -155,8 +155,8 @@ end
################################################################################
# tangent lines

@doc raw"""
tangent_lines(C::ProjectivePlaneCurve{S}, P::AbsProjectiveRationalPoint) where S <: FieldElem
@doc raw"""
tangent_lines(C::ProjectivePlaneCurve{S}, P::AbsProjectiveRationalPoint) where S <: FieldElem
Return the tangent lines at `P` to `C` with their multiplicity.
"""
Expand All @@ -177,7 +177,7 @@ function tangent_lines(C::ProjectivePlaneCurve, P::AbsProjectiveRationalPoint)
end

@doc raw"""
intersection_multiplicity(C::S, D::S, P::AbsProjectiveRationalPoint) where S <: ProjectivePlaneCurve
intersection_multiplicity(C::S, D::S, P::AbsProjectiveRationalPoint) where S <: ProjectivePlaneCurve
Return the intersection multiplicity of `C` and `D` at `P`.
"""
Expand All @@ -193,7 +193,7 @@ end


@doc raw"""
is_transverse_intersection(C::S, D::S, P::AbsProjectiveRationalPoint) where S <: ProjectivePlaneCurve
is_transverse_intersection(C::S, D::S, P::AbsProjectiveRationalPoint) where S <: ProjectivePlaneCurve
Return `true` if `C` and `D` intersect transversally at `P` and `false` otherwise.
"""
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -521,7 +521,7 @@ end
# TODO: projective schemes, covered schemes

@doc raw"""
reduced_scheme(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
reduced_scheme(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
Return the induced reduced scheme of `X`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -527,7 +527,7 @@ end
# TODO: projective schemes, covered schemes

@doc raw"""
is_equidimensional(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
is_equidimensional(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
Check whether the scheme `X` is equidimensional.
Expand Down Expand Up @@ -589,7 +589,7 @@ end
# TODO: projective schemes

@doc raw"""
is_reduced(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
is_reduced(X::AbsAffineScheme{<:Field, <:MPolyAnyRing})
Check whether the affine scheme `X` is reduced.
"""
Expand Down Expand Up @@ -722,7 +722,7 @@ is_smooth(X::AbsAffineScheme{<:Field, <:MPolyLocRing}) = true
# irreducible = nilradical of OO(X) is prime #
###################################################################
@doc raw"""
is_irreducible(X::AbsAffineScheme)
is_irreducible(X::AbsAffineScheme)
Check whether the affine scheme `X` is irreducible.
Expand All @@ -741,7 +741,7 @@ is_irreducible(X::AbsAffineScheme{<:Field,<:MPolyRing}) = true
is_irreducible(X::AbsAffineScheme{<:Field,<:MPolyLocRing}) = true

@doc raw"""
is_integral(X::AbsAffineScheme)
is_integral(X::AbsAffineScheme)
Check whether the affine scheme `X` is integral, i.e. irreducible and reduced.
"""
Expand Down Expand Up @@ -777,7 +777,7 @@ end
# Connectedness #
###################################################################
@doc raw"""
is_connected(X::AbsAffineScheme)
is_connected(X::AbsAffineScheme)
Check whether the affine scheme `X` is connected.
"""
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
# (1) Check and store, whether a covered scheme is empty #
########################################################################
@doc raw"""
is_empty(X::AbsCoveredScheme)
is_empty(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is empty.
Expand All @@ -25,7 +25,7 @@ end
# (2) Check and store, whether a covered scheme is smooth #
########################################################################
@doc raw"""
is_smooth(X::AbsCoveredScheme)
is_smooth(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is smooth.
"""
Expand Down Expand Up @@ -70,7 +70,7 @@ end
# i.e. irreducible and reduced #
########################################################################
@doc raw"""
is_integral(X::AbsCoveredScheme)
is_integral(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is integral.
Expand All @@ -85,7 +85,7 @@ end
# Note: This does not work with gluing_graph, because empty patches
# need to be ignored without changing the covering
@doc raw"""
is_connected_gluing(X::AbsCoveredScheme)
is_connected_gluing(X::AbsCoveredScheme)
Return the boolean value whether the gluing graph of the default
covering of the scheme X is connected.
Expand All @@ -102,7 +102,7 @@ end
# (4) Check and store, whether a covered scheme is connected #
########################################################################
@doc raw"""
is_connected(X::AbsCoveredScheme)
is_connected(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is connected.
Expand All @@ -119,7 +119,7 @@ end
# (5) Check and store, whether a scheme is reduced
##############################################################################
@doc raw"""
is_reduced(X::AbsCoveredScheme)
is_reduced(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is reduced.
Expand All @@ -132,7 +132,7 @@ end
# (6) Check and store, whether a covered scheme is irreducible
##############################################################################
@doc raw"""
is_irreducible(X::AbsCoveredScheme)
is_irreducible(X::AbsCoveredScheme)
Return the boolean value whether a covered scheme `X` is irreducible.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ underlying_morphism(f::AbsProjectiveSchemeMorphism) = error("no underlying morph
domain(phi::ProjectiveSchemeMor) = phi.domain
codomain(phi::ProjectiveSchemeMor) = phi.codomain
@doc raw"""
pullback(phi::ProjectiveSchemeMor)
pullback(phi::ProjectiveSchemeMor)
For a morphism `phi` of projective schemes, this returns the associated
morphism of graded affine algebras.
Expand Down
2 changes: 1 addition & 1 deletion src/Combinatorics/PhylogeneticTrees.jl
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ function phylogenetic_tree(T::Type{<:Union{Float64, QQFieldElem}}, newick::Strin
end

@doc raw"""
phylogenetic_tree(M::Matrix{T}, taxa::Vector{String}) where T <: Union{Float64, QQFieldElem}
phylogenetic_tree(M::Matrix{T}, taxa::Vector{String}) where T <: Union{Float64, QQFieldElem}
Constructs a phylogenetic tree with cophenetic matrix `M` and taxa `taxa`. The matrix `M` must be
ultrametric, otherwise an error will be thrown.
Expand Down
2 changes: 1 addition & 1 deletion src/Combinatorics/SimplicialComplexes.jl
Original file line number Diff line number Diff line change
Expand Up @@ -552,7 +552,7 @@ end
###############################################################################

@doc raw"""
is_isomorphic(K1::SimplicialComplex, K2::SimplicialComplex)
is_isomorphic(K1::SimplicialComplex, K2::SimplicialComplex)
Checks if the given simplicial complexes are isomorphic.
Expand Down
8 changes: 4 additions & 4 deletions src/InvariantTheory/invariant_rings.jl
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ function reynolds_operator(IR::InvRing{FldT, GrpT, PolyRingElemT}) where {FldT,
end

@doc raw"""
reynolds_operator(IR::InvRing{FldT, GrpT, T}, f::T) where {FldT, GrpT, T <: MPolyRingElem}
reynolds_operator(IR::InvRing{FldT, GrpT, T}, f::T) where {FldT, GrpT, T <: MPolyRingElem}
In the non-modular case, return the image of `f` under the Reynolds operator
projecting onto `IR`.
Expand Down Expand Up @@ -342,8 +342,8 @@ function reynolds_operator(IR::InvRing{FldT, GrpT, PolyRingElemT}, chi::GAPGroup
end

@doc raw"""
reynolds_operator(IR::InvRing{FldT, GrpT, T}, f::T, chi::GAPGroupClassFunction)
where {FldT, GrpT, T <: MPolyRingElem}
reynolds_operator(IR::InvRing{FldT, GrpT, T}, f::T, chi::GAPGroupClassFunction)
where {FldT, GrpT, T <: MPolyRingElem}
In the case of characteristic zero, return the image of `f` under the twisted
Reynolds operator projecting onto the isotypic component of the polynomial ring
Expand Down Expand Up @@ -412,7 +412,7 @@ end
################################################################################

@doc raw"""
basis(IR::InvRing, d::Int, algorithm::Symbol = :default)
basis(IR::InvRing, d::Int, algorithm::Symbol = :default)
Given an invariant ring `IR` and an integer `d`, return a basis for the invariants in degree `d`.
Expand Down
2 changes: 1 addition & 1 deletion src/InvariantTheory/iterators.jl
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ function dimension_via_molien_series(::Type{T}, R::InvRing, d::Int, chi::Union{G
end

@doc raw"""
iterate_basis(IR::InvRing, d::Int, algorithm::Symbol = :default)
iterate_basis(IR::InvRing, d::Int, algorithm::Symbol = :default)
Given an invariant ring `IR` and an integer `d`, return an iterator over a basis
for the invariants in degree `d`.
Expand Down
16 changes: 8 additions & 8 deletions src/Modules/homological-algebra.jl
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
##############################################################################

@doc raw"""
fitting_ideal(M::ModuleFP{T}, i::Int) where T <: MPolyRingElem
fitting_ideal(M::ModuleFP{T}, i::Int) where T <: MPolyRingElem
Return the `i`-th Fitting ideal of `M`.
Expand Down Expand Up @@ -86,7 +86,7 @@ end
##############################################################################

@doc raw"""
is_flat(M::ModuleFP{T}) where T <: MPolyRingElem
is_flat(M::ModuleFP{T}) where T <: MPolyRingElem
Return `true` if `M` is flat, `false` otherwise.
Expand Down Expand Up @@ -141,7 +141,7 @@ function is_flat(M::SubquoModule{T}) where T <: MPolyRingElem
end

@doc raw"""
non_flat_locus(M::ModuleFP{T}) where T <: MPolyRingElem
non_flat_locus(M::ModuleFP{T}) where T <: MPolyRingElem
Return an ideal of `base_ring(M)` which defines the non-flat-locus of `M`
in the sense that the localization of `M` at a prime ideal of `base_ring(M)`
Expand Down Expand Up @@ -203,7 +203,7 @@ end
##############################################################################

@doc raw"""
is_regular_sequence(V::Vector{T}, M::ModuleFP{T}) where T <: MPolyRingElem
is_regular_sequence(V::Vector{T}, M::ModuleFP{T}) where T <: MPolyRingElem
Return `true` if the elements of `V` form, in the given order, a regular sequence on `M`.
Return `false`, otherwise.
Expand Down Expand Up @@ -273,7 +273,7 @@ end
##############################################################################

@doc raw"""
koszul_homology(V::Vector{T}, M::ModuleFP{T}, p::Int) where T <: MPolyRingElem
koszul_homology(V::Vector{T}, M::ModuleFP{T}, p::Int) where T <: MPolyRingElem
If $f_1, \dots, f_r$ are the entries of `V` in the given order, return the `p`-th homology
module of the complex $K(f_1, \dots, f_r)\otimes_R M$, where $K(f_1, \dots, f_r)$ is the
Expand Down Expand Up @@ -428,7 +428,7 @@ end
##############################################################################

@doc raw"""
depth(I::MPolyIdeal{T}, M::ModuleFP{T}) where T <: MPolyRingElem
depth(I::MPolyIdeal{T}, M::ModuleFP{T}) where T <: MPolyRingElem
Return the depth of `I` on `M`.
Expand Down Expand Up @@ -572,7 +572,7 @@ end
##############################################################################

@doc raw"""
koszul_matrix(V::Vector{T}, p::Int) where T <: MPolyRingElem
koszul_matrix(V::Vector{T}, p::Int) where T <: MPolyRingElem
If $f_1, \dots, f_r$ are the entries of `V` in the given order, return the matrix representing
the `p`-th map of the Koszul complex $K(f_1, \dots, f_r)$.
Expand Down Expand Up @@ -626,7 +626,7 @@ function _koszul_matrix_from_singular(V::Vector{T}, i::Int) where T <: MPolyRing
end

@doc raw"""
koszul_complex(V::Vector{T}) where T <: MPolyRingElem
koszul_complex(V::Vector{T}) where T <: MPolyRingElem
If $f_1, \dots, f_r$ are the entries of `V` in the given order, return the Koszul complex $K(f_1, \dots, f_r)$.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ end


@doc raw"""
k_skeleton(PC::PolyhedralComplex,k::Int)
k_skeleton(PC::PolyhedralComplex,k::Int)
Return the k-skeleton of a polyhedral complex.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2192,7 +2192,7 @@ function rand_normal_polytope(d::Int, n::Int; seed=nothing, precision=nothing)
end

@doc raw"""
rss_associahedron(n::Int)
rss_associahedron(n::Int)
Produce a polytope of constrained expansions in ambient dimension `n` according to [RSS03](@cite).
Expand Down
Loading

0 comments on commit 83f0c18

Please sign in to comment.