On Thursday, 24 September 2015 10:11:24 UTC-7, Nathann Cohen wrote: > > > You are invited to open a ticket demanding that the function > > rshcd_from_close_prime_powers() > > be called > > > regular_symmetric_hadamard_matrix_with_constant_diagonal_from_close_prime_powers() > > > > I hope that you will not blame me for shortening this function, as > indeed its full name is (precisely) 80 characters long. You just can't > write this while staying belong the 80-characters limit (especially in > indented code).
> In this context I thought that it was not a problem, as this function > is merely a helper function for: > > how the hell does it matter? Your logic seems to be that a user will stumble upon an abbreviated name it will make him uncomfortable. > def regular_symmetric_hadamard_matrix_with_constant_diagonal > > Which is *not* shortened, as you conveniently failed to notice. > I duly noticed, I even used it to copy/paste the suggested name... > > The only meaningful rule is that well-established abbreviations are used > in > > places where it is meaningful. > > The fact that your functions appear publicly in graphs.<tab> is > another reason for me to be clear about their meaning. > > graphs.T2starGQGraph > > is, you will admit, rather unclear for a public constructor. I believe > that naming it > > graphs.T2starGeneralizedQuadrangleGraph > > would solve it partially. > No I will not admit it is unclear. If one doesn't know what a GeneralizedQuadrangle is, it's won't help. If one does know, he'd know what GQ stands for. Anyhow, it is documented that it has to do with generalised quadrangles. We have dozens of examples in Sage where well-established abbreviations are used, without aliases. E.g. matrices have LU() and LLL() methods, or e.g. groups.matrix.GL groups.matrix.GO groups.matrix.GU > Nathann > > Nathann > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
