On Tue, 6 Jan 2015, James Greenhalgh wrote: > > and "Update text." is thoroughly unhelpful as a ChangeLog entry to > > explain the intent of the changes. > > Well, indeed, but ChangeLog entries have always been a > thoroughly unhelpful "what changed" rather than "why did it > change". (grep ": Update\." gcc/ChangeLog*) !
That should be for cases where it's e.g. a completely mechanical change following from a more fully described change to a file listed earlier in the ChangeLog entry. For this sort of documentation patch, "what changed" should be more specific (e.g. if you're updating the description of passes to refer to gimplification then say so in the ChangeLog entry). -- Joseph S. Myers jos...@codesourcery.com