From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Org merge Date: Sun, 10 Nov 2013 14:28:52 -0500 Message-ID: References: <8738n5cijg.fsf@bzg.ath.cx> <87vc0016yy.fsf@bzg.ath.cx> <87iow0p1n1.fsf@gmail.com> <87bo1s14yr.fsf@bzg.ath.cx> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1384111756 16837 80.91.229.3 (10 Nov 2013 19:29:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 10 Nov 2013 19:29:16 +0000 (UTC) Cc: Jambunathan K , emacs-devel@gnu.org To: Bastien Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Nov 10 20:29:19 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VfahD-0000mH-G2 for ged-emacs-devel@m.gmane.org; Sun, 10 Nov 2013 20:29:19 +0100 Original-Received: from localhost ([::1]:33489 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VfahD-000700-0e for ged-emacs-devel@m.gmane.org; Sun, 10 Nov 2013 14:29:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53780) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vfah3-0006zo-Ie for emacs-devel@gnu.org; Sun, 10 Nov 2013 14:29:16 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vfagw-0007Mn-9K for emacs-devel@gnu.org; Sun, 10 Nov 2013 14:29:09 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.182]:55681) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vfago-0007M5-Jd; Sun, 10 Nov 2013 14:28:54 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av4EABK/CFFMCpZP/2dsb2JhbABEvw4Xc4IeAQEEAVYjBQsLNBIUGA0kLYdxBsEtkQoDiGGcGYFegxU X-IPAS-Result: Av4EABK/CFFMCpZP/2dsb2JhbABEvw4Xc4IeAQEEAVYjBQsLNBIUGA0kLYdxBsEtkQoDiGGcGYFegxU X-IronPort-AV: E=Sophos;i="4.84,565,1355115600"; d="scan'208";a="37517541" Original-Received: from 76-10-150-79.dsl.teksavvy.com (HELO pastel.home) ([76.10.150.79]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 10 Nov 2013 14:28:53 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id 7E87F60333; Sun, 10 Nov 2013 14:28:52 -0500 (EST) In-Reply-To: <87bo1s14yr.fsf@bzg.ath.cx> (Bastien's message of "Sun, 10 Nov 2013 19:34:04 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.182 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:165123 Archived-At: > Sorry, I should have been clearer: what I meant is that, while most Org> 8.0 exporters functions structurally changed compared to their > Org<7.9.3f ancestors (because of the use of a new export engine), most > options have only seen a change in their name, not in their content or > meaning. Some options have been deleted and others added. The NEWS file should explain how the options have been changed, but the ChangeLog is only concerned about the actual code. From what you say, it seems to actual code shares no history with the previous code (a bit like a "clean room" reimplementation), so the ChangeLog doesn't need to explain the changes. > What is difficult is to document new fonctions: The usual course of action for new functions is to describe them in ChangeLog as: (foo, bar, baz): New function. so other than enumerating them, there's nothing to do. Stefan