From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Subject: Re: Clarification on ChangeLog documentation Date: Mon, 17 Mar 2014 02:08:35 +0100 Message-ID: <87bnx5ocmk.fsf@bzg.ath.cx> References: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38381) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPM2n-0005Np-CK for emacs-orgmode@gnu.org; Sun, 16 Mar 2014 21:08:51 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WPM2h-0006Hj-CY for emacs-orgmode@gnu.org; Sun, 16 Mar 2014 21:08:45 -0400 Received: from rs249.mailgun.us ([209.61.151.249]:44918) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPM2h-0006Hc-7k for emacs-orgmode@gnu.org; Sun, 16 Mar 2014 21:08:39 -0400 In-Reply-To: (John Hendy's message of "Sat, 15 Mar 2014 10:17:17 -0500") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: John Hendy Cc: emacs-orgmode Hi John, John Hendy writes: > In the example provided, the first asterisk lists a file and two > changed nodes. Why is the third just parentheses with no file. > Assumption: it's also in org-timer.el, but the description of the > change just wouldn't have matched the other two. This is the standard way a Changelog file looks like. Try adding chanlog entries with C-x 4 a. >> #+begin_quote: >> The problem here was that a wrong keyword was given in the >> customization type. This let to a string-match against a list value. >> #+end_quote >> >> I couldn't tell if this paragraph was supposed to be a continuation of >> the second "header" above, or if it was it's own standalone summary of >> the gist of both changes. > > Taking this to be general elaboration about /both/ changes; i.e. a > summary of the motivation of the changes in general. Yes, exactly. >> #+begin_quote >> Modified from a patch proposal by Johan Friis. >> #+end_quote >> >> Can I reference mailing list threads, or is this not advised? You are encouraged to reference mailing list threads and/or previous commits refs, for sure. >> Or >> should I be mentioning the person who responded on the mailing list >> for the clarification which led to the documentation modification? Up to you. There are no real conventions in this part: add what you think is useful for groking the how and why of the commit. > Still not sure about this. > >> #+begin_quote >> TINYCHANGE >> #+end_quote >> >> Is the FSF requirement necessary only if one commit > x lines, or is >> it cumulative? > > Also not sure about this, but I've seen enough FSF forms asked for > that I assume I'll be asked if I hit whatever the limit is. The limit is a cumulative change of 20 non-repetitive change lines. Best, -- Bastien