Re: [PATCH 1/8] sha1-array: provide oid_array_filter

From: Stefan Beller <sbeller@google.com>
Date: Sep 26, 2018, 19:59 UTC
Message-ID: <CAGZ79kbeQvLuH1nGPkf8hHbs49SmuPeme_XBdz7ek5fU5AZ9Zg@mail.gmail.com>
In-Reply-To: <xmqqtvmcjaxx.fsf@gitster-ct.c.googlers.com>

Show 7 quoted lines

> I agree on both counts.  I just like to read these in plain text
> while I am coding for Git (or reviewing patches coded for Git).
>
> The reason why I have mild preference to D/technical/ over in-header
> doc is only because I find even these asterisks at the left-side-end
> distracting; it is not that materials in D/technical could be passed
> through AsciiDoc.

    /**
    Would we be open to consider another commenting style?
    AFAICT the asterisks are a cultural thing and not enforced by
    and old compiler not understanding these comments.

    Just like ending the comment in an asymetric fashion ;-) */

(I am not seriously proposing unbalanced comments, but for longer documenting comments we may want to consider, omitting the asterisk?)