Skip to content

Doc fixes#420

Merged
james-d-mitchell merged 9 commits intolibsemigroups:stable-1.4from
james-d-mitchell:doc-fixes
May 1, 2026
Merged

Doc fixes#420
james-d-mitchell merged 9 commits intolibsemigroups:stable-1.4from
james-d-mitchell:doc-fixes

Conversation

@james-d-mitchell
Copy link
Copy Markdown
Member

A bunch of doc fixes many coming from codex.

@james-d-mitchell
Copy link
Copy Markdown
Member Author

Any comments @Joseph-Edwards ? O/w I'll merge

@Joseph-Edwards
Copy link
Copy Markdown
Collaborator

Any comments @Joseph-Edwards ? O/w I'll merge

I'll take a look at it now

Copy link
Copy Markdown
Collaborator

@Joseph-Edwards Joseph-Edwards left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few small tweaks, then I'd be happy to merge. Thanks @james-d-mitchell!

Comment thread src/aho-corasick.cpp
:rtype: int | Undefined

:raises LibsemigroupsError: if ``throw_if_node_index_not_active(parent)`` throws.
:raises LibsemigroupsError: if ``throw_if_node_index_not_active(parent)`` raises an exception.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is a good change, but we should be consistent. There are instances of this in other files that we should probably change too.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

> rg "if .* throws\."
src/sims.cpp
113::raises LibsemigroupsError: if :any:`Presentation.throw_if_bad_alphabet_or_rules` throws.

src/ukkonen.cpp
64::raises LibsemigroupsError:  if ``throw_if_contains_unique_letter(w)`` throws.
120::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
179::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
213::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
247::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
279::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
315::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
348::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
382::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
418::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
451::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
489::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.
529::raises LibsemigroupsError:  if ``u.throw_if_contains_unique_letter(w)`` throws.

src/present.cpp
1297::raises LibsemigroupsError:  if :any:`throw_if_bad_alphabet_or_rules` throws.
1322::raises LibsemigroupsError:  if :any:`throw_if_bad_alphabet_or_rules` throws.
1363::raises LibsemigroupsError:  if throw_if_bad_alphabet_or_rules throws.
1431::raises LibsemigroupsError:  if ``p.throw_if_bad_alphabet_or_rules()`` throws.
1482:  if :any:`Presentation.throw_if_bad_alphabet_or_rules` throws.
1516:  if :any:`throw_if_bad_alphabet_or_rules` throws.
1586::raises LibsemigroupsError:  if no inverses have been set, or if ``index(x)`` throws.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed but I think I'll fix this in a separate PR, so you don't have to re-review this one.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in #423

Comment thread src/aho-corasick.cpp Outdated
Comment thread src/forest.cpp
Comment thread src/forest.cpp
Comment thread src/forest.cpp
Comment thread src/forest.cpp
Comment thread src/forest.cpp
@james-d-mitchell james-d-mitchell mentioned this pull request Apr 30, 2026
@james-d-mitchell james-d-mitchell merged commit 3760b62 into libsemigroups:stable-1.4 May 1, 2026
26 checks passed
@james-d-mitchell james-d-mitchell deleted the doc-fixes branch May 1, 2026 10:23
@james-d-mitchell james-d-mitchell mentioned this pull request May 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants