On Thursday, 24 September 2015 15:34:46 UTC-7, Dima Pasechnik wrote: > > > > On Thursday, 24 September 2015 15:02:39 UTC-7, Volker Braun wrote: >> >> On Thursday, September 24, 2015 at 11:18:58 PM UTC+2, Dima Pasechnik >> wrote: >>> >>> IMHO abbreviations are OK when they are known to basically every >>>> mathematician, e.g. ZZ. Which translates to about undergrad level. Just >>>> ask >>>> a undergraduate student what a T2starGQ graph is and you'll have your >>>> answer. >>>> >>> >>> Huh? Ask an undergraduate what a T2starGeneralizedQuadrangle graph is. >>> Result will be the same. >>> >> >> You are missing the point. Of course Sage contains stuff that are beyond >> the undergrad syllabus. All I'm saying that you shouldn't abbreviate it, >> then. E.g. searching for "Generalized Quadrangle" easily finds an >> explanation for what that is, whereas searching for GQ brings you to the >> website of the Gentlemen's Quarterly magazine. >> > > the function is documented, and one can easily see what it is about, no > need to google. In comparison, try googling for ZZ, or for GL. > > Signature: graphs.T2starGQGraph(q, dual=False, hyperoval=None, > field=None, check_hyperoval=True) > Docstring: > Return the collinearity graph of the generalized quadrangle > T_2^*(q), or of its dual > > FYI, Mathscinet finds 34 papers with abbreviation GQ in the title; 1 > refers to something else, 33 refer to generalized quadrangles. > > > And by the way, look at the docstring fot LLL: > Docstring: > Return LLL reduced or approximated LLL reduced lattice R for this > matrix interpreted as a lattice. > > "matrix interpreted as lattice..." maybe it should be "lettuce" there? > > FYI, Mathscinet finds 34 papers with abbreviation LLL in the title. > ^^^^ 47, sorry for typo.
> > > Or even better, look at BKZ method for matrices. I must say I didn't know > this abbreviation. Anyone does know? > > FYI, Mathscinet finds 8 papers with abbreviation BKZ. But only 2 are > relevant to BKZ for matrices, the rest are about some stuff in > fluid dynamics known as K-BKZ. > > > Now you seem to be telling me that GQ (33 times mentioned in titles of > maths papers) is an obscure abbreviation and cannot be used in Sage > function names, while LLL > (wow, 20% more times in titles) and BKZ (wow, mentioned 2 times in titles > of maths papers) are just great to have as it is... > > > > --------------------------------------------------------------------------------------------------------------------- > We could have fixed lots of broken docs in Sage, instead of having this > useless discussion. > > -- 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.