Repository navigation
Add miscellaneous missing docs - #960
William-Kenyon wants to merge 8 commits into
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #960 +/- ##
=======================================
Coverage 97.48% 97.48%
=======================================
Files 53 53
Lines 21363 21363
Branches 639 639
=======================================
Hits 20825 20825
Misses 473 473
Partials 65 65 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
james-d-mitchell
left a comment
There was a problem hiding this comment.
A couple of minor TODOs, then we'll be happy to merge, thanks @William-Kenyon this is super helpful!
There was a problem hiding this comment.
There seems to be a TODO:
gap/grahom.gd:45:DeclareAttribute("DigraphSmallestLastOrder", IsDigraph); # TODO: document
which you could also delete.
| <Description> | ||
| <C>UnitEdgeWeightedDigraph</C> returns an edge-weighted copy of | ||
| <A>digraph</A>, with all edge weights set to 1.<P/> | ||
|
|
There was a problem hiding this comment.
There should be a statement about what happens when digraph is mutable/immutable here.
| <Prop Name="IsNegativeEdgeWeightedDigraph" Arg="digraph"/> | ||
| <Returns>A boolean.</Returns> | ||
| <Description> | ||
| This returns <C>true</C> if <A>digraph</A> contains at least one edge |
There was a problem hiding this comment.
| This returns <C>true</C> if <A>digraph</A> contains at least one edge | |
| This returns <K>true</K> if <A>digraph</A> contains at least one edge |
K for "keyword"
| <Description> | ||
| This returns <C>true</C> if <A>digraph</A> contains at least one edge | ||
| with negative weight, and <C>false</C> otherwise. | ||
| <Example><![CDATA[ |
There was a problem hiding this comment.
Ideally the doc would also say what happens when digraph doesn't have edge weights.
I used a small script to find instances where
Declare...("name", ...)existed but had no corresponding mansection, i.e. no<Oper/Attr/Prop/... name="name" ...>, and updated the docs where appropriate. Excluding...Cons,...NC,DIGRAPHS_...etc.