http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi File Documentation/contributor/programming-work.itexi (right):
http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1832 Documentation/contributor/programming-work.itexi:1832: a @emph{prima face}. If you write a pure-function, you are promising What does 'prima face' mean? http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1858 Documentation/contributor/programming-work.itexi:1858: @var{start} and @var{end} is facultative, as items only occupy one 'facultative' is an odd word here. I guess you mean it in the sense of 'optional', where the user of the optional thing can turn to a substitute if it is not provided. Then just say start and end are optional parameters where the function provides the defaults. http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1861 Documentation/contributor/programming-work.itexi:1861: @var{end} are important, as we may can get a `purer' estimation of a I'm getting confused. "pure(lilypond)" generally means 'crappy' in the sense of pure-height of a slur being the crappy estimate of height one can get without triggering the line-breaking and note-spacing. When you say 'purer' above, you seem to be using the superlative of "pure(English)" rather than "pure(LilyPond)". http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1913 Documentation/contributor/programming-work.itexi:1913: LilyPond is smart enough to know if a series of chained functions are So if one function in the series has no pure equivalent, but you call the first function at a time when only pure functions may be called, what is LilyPond smart enough to do? http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1959 Documentation/contributor/programming-work.itexi:1959: Pure Y values should be used in any functions that are called before should or must? http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1996 Documentation/contributor/programming-work.itexi:1996: overly-distort the Y-extent of an system, which could result in a very extra-spacing-height does not distort the Y-extent http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode1997 Documentation/contributor/programming-work.itexi:1997: @q{loose} looking score with lots of space between systems. So, to Prove it. http://codereview.appspot.com/5364048/diff/4001/Documentation/contributor/programming-work.itexi#newcode2041 Documentation/contributor/programming-work.itexi:2041: not be changed later in the compiling process due to other changes? This sounds like "pure(ComputerScience)" in the sense of a function that depends only on its arguments, not on any other program state. Does "pure(LilyPond)" include this concept. http://codereview.appspot.com/5364048/ _______________________________________________ lilypond-devel mailing list lilypond-devel@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-devel
