[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: OT: ChangeLog stylistics
From: |
Ralf Wildenhues |
Subject: |
Re: OT: ChangeLog stylistics |
Date: |
Tue, 21 Mar 2006 18:02:37 +0100 |
User-agent: |
Mutt/1.5.11 |
* Stepan Kasal wrote on Mon, Mar 20, 2006 at 06:13:50PM CET:
> >
> > There is considerable variation among ChangeLog entries in packages I
> > know with respect to the passive or active voice. [...]
>
> I though it's a problem of present vs. past tense, not actove/passive voice.
>
> The changelog informs about what _was done_ so there is no reason to use
> present tense or imperative.
I must confess to not have been sure whether it was present vs past, or
active vs passive. FWIW, info standards "Simple Changes" contains:
| * keyboard.c (Fcommand_execute): New arg SPECIAL.
| All callers changed.
as an example; or later:
| * frame.h [HAVE_X_WINDOWS] (FRAME_WINDOW_P): Macro defined.
But also simple present is used. I could not find a direct reference to
what should be used. Neither in gnits.info.
Anyway, personally I don't care much, so unless there are reasons to
prefer one, I'll just go with what the maintainer prefers.
Cheers,
Ralf