[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: some comments and complaints on the code (issue 5651069)
From: |
Han-Wen Nienhuys |
Subject: |
Re: some comments and complaints on the code (issue 5651069) |
Date: |
Mon, 13 Feb 2012 09:54:57 -0200 |
On Mon, Feb 13, 2012 at 9:52 AM, David Kastrup <address@hidden> wrote:
>> I disagree. Reading code the first time is hard, that is true, but
>> unless anything surprising is happening, it does not deserve a
>> comment. The more you read code, the easier it becomes, and think of
>> this as you learning how to read. In an analog: beginners books may
>> feature simpler words, hy-phe-na-te all words explicitly and use
>> pictures, but that doesn't mean literature for grownups should have
>> those.
>
> The problem with much of the LilyPond code base is not that it is short
> in comments paraphrasing the code:
Right.
> I've just looked at the part combiner code, and it creates complex GOOPS
We're talking about the note collision code, though.
--
Han-Wen Nienhuys - address@hidden - http://www.xs4all.nl/~hanwen
- some comments and complaints on the code (issue 5651069), janek . lilypond, 2012/02/10
- Re: some comments and complaints on the code (issue 5651069), janek . lilypond, 2012/02/11
- Re: some comments and complaints on the code (issue 5651069), milimetr88, 2012/02/11
- Re: some comments and complaints on the code (issue 5651069), janek . lilypond, 2012/02/11
- Re: some comments and complaints on the code (issue 5651069), k-ohara5a5a, 2012/02/11
- Re: some comments and complaints on the code (issue 5651069), joeneeman, 2012/02/12
- Re: some comments and complaints on the code (issue 5651069), hanwenn, 2012/02/13
- Re: some comments and complaints on the code (issue 5651069), hanwenn, 2012/02/13
- Re: some comments and complaints on the code (issue 5651069), janek . lilypond, 2012/02/16