Am 20.11.2017 um 01:36 schrieb Junio C Hamano: > René Scharfe <l.s.r@xxxxxx> writes: > >> your suggested full-comment metric, i.e. more than nothing. But more >> importantly it's the actual comment payload. The leading "/*" line is >> included as a consequence of the employed heuristic, but a more >> refined one might omit it as it doesn't actually contain any comment. > > I am slightly in favor of than against the above reasoning, but it > probably deserves to be recorded somewhere more readily accessible > than the mailing list archive. The title of the test "context > *includes* comment" can be read to hint it by not saying that the > precontext shows the *entire* comment, but that is a very weak hint > that will be missed by anybody unaware of the reasoning behind this > decision. > > When showing function context it would be helpful to show comments > immediately before declarations, as they are most likely relevant. Add > a test for that. > > ... but without specifying the choice of lines too rigidly in the > test---we may want to stop before and not include "/*" in the > future, for example. > > perhaps? That's fine with me. Thanks, René
