Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Ratio.create_ratio and Ratio.create_normalized_ratio have behaviors that can be seen as misleading #5310
Original bug ID: 5310
In (undocumented) Ratio module:
I would have expected the exact contrary to happen (normalized_ratio should normalize and create should not).
If you feel the current naming is appropriate, could you at least document the implemented behavior of these functions in the interface of ratio?
(And while you are at it, have ocamldoc generate a html file for this module too, because it is isconcerting to browse the doc of the num library and see this Ratio module appears without documentation).
The referred behavior can be instrumented with the attached ml file.