From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Sebastian Wiesner Newsgroups: gmane.emacs.devel Subject: Re: cl-defstruct-based package.el, now with ert tests and no external tar! Date: Mon, 24 Jun 2013 14:44:04 +0200 Message-ID: References: <87y5cx0wh7.fsf@yandex.ru> <87ppy7e5ke.fsf@lifelogs.com> <87vc5x1uzj.fsf@yandex.ru> <87txlcdyl1.fsf@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1372077851 29349 80.91.229.3 (24 Jun 2013 12:44:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 24 Jun 2013 12:44:11 +0000 (UTC) Cc: Daniel Hackney , Stefan Monnier , Emacs development discussions To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 24 14:44:13 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 1Ur67v-000111-W3 for ged-emacs-devel@m.gmane.org; Mon, 24 Jun 2013 14:44:12 +0200 Original-Received: from localhost ([::1]:41579 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ur67v-0006tp-5H for ged-emacs-devel@m.gmane.org; Mon, 24 Jun 2013 08:44:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49283) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ur67r-0006sQ-GC for emacs-devel@gnu.org; Mon, 24 Jun 2013 08:44:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ur67p-00078H-BT for emacs-devel@gnu.org; Mon, 24 Jun 2013 08:44:07 -0400 Original-Received: from mail-qc0-x233.google.com ([2607:f8b0:400d:c01::233]:36280) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ur67p-000783-8P for emacs-devel@gnu.org; Mon, 24 Jun 2013 08:44:05 -0400 Original-Received: by mail-qc0-f179.google.com with SMTP id e11so6190392qcx.24 for ; Mon, 24 Jun 2013 05:44:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; bh=O8yykNKEe+ewTjFHuCdHH6KKKjJZuYluBz8TJ7Bv+AI=; b=InRWgCQbrIe2UEQwthRdp5jNwBYA8BA1TQWL+lRm3cSx+d2xHGpJ6ILpMmKuH576Ip 9Os1CIWPmrMqV9hqyQnFEjwl0NjDHrB4UZiHCDQWRlLOawhYTY1ilnhIf3je8dNV4Lym WlmFVEKLnrbSe8e4bgMHxjXj5Ga3uLbZqcKqNTEKsX9NTJZ8Coa3R3l+yS4akfmkKcRP J2be5lIUnx9jtFcxsjLeXZj8meKkHzBbZPTPBPoTX5KGgcBi8g7HIVn2Lx/Gi485wJ6E Hcr/mhLroySuSu+ftN/QNcYBfiampXtm5vkxNa/rvcv+oCEET6BdMYrAvK9EhWGrK4GE yVYw== X-Received: by 10.49.58.240 with SMTP id u16mr27203198qeq.16.1372077844666; Mon, 24 Jun 2013 05:44:04 -0700 (PDT) Original-Received: by 10.224.178.193 with HTTP; Mon, 24 Jun 2013 05:44:04 -0700 (PDT) In-Reply-To: <87txlcdyl1.fsf@yandex.ru> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:400d:c01::233 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:160935 Archived-At: 2013/6/5 Dmitry Gutov : > Daniel Hackney writes: >>> You can start with ChangeLog files. When writing a changelog entry, >>> one usually briefly describes and sometimes justifies the mechanical >>> transformations being performed on the code, and it helps other people >>> understand the changes. >> >> Since it is a complete refactoring, what should I say? Should I include >> a line for each new or changed function > > I think so: http://www.gnu.org/prep/standards/html_node/Change-Logs.html > >>> I see you've also already started on NEWS entries. >> >> How does it look so far? Any suggestions on how to improve it? > > Actually, I'm not entirely sure the NEWS entries are appropriate in this > case. > > Compare: "file named NEWS which contains a list of user-visible changes > worth mentioning" > (http://www.gnu.org/prep/standards/html_node/NEWS-File.html). > > and > > "User-facing commands have not changed and existing archives and files > will continue to work as before;" The API *has* changed. We (that is, the Carton team [1]) =E2=80=9Cuse=E2= =80=9D this API. We need to port Carton to the new API, and NEWS entries explaining the changes would help. [1]: https://github.com/rejeep/carton