From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Merten Newsgroups: gmane.emacs.devel Subject: Re-including rst.el into Emacs repository Date: Mon, 30 Apr 2012 15:29:08 +0200 Message-ID: <30996.1335792548@eskebo.merten-home.homelinux.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: dough.gmane.org 1335792562 14280 80.91.229.3 (30 Apr 2012 13:29:22 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 30 Apr 2012 13:29:22 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 30 15:29:21 2012 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 1SOqfI-0000s3-Uh for ged-emacs-devel@m.gmane.org; Mon, 30 Apr 2012 15:29:21 +0200 Original-Received: from localhost ([::1]:57276 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SOqfI-0003Bu-Ak for ged-emacs-devel@m.gmane.org; Mon, 30 Apr 2012 09:29:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:34575) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SOqfE-0003Be-Q0 for emacs-devel@gnu.org; Mon, 30 Apr 2012 09:29:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SOqfC-0006gk-M7 for emacs-devel@gnu.org; Mon, 30 Apr 2012 09:29:16 -0400 Original-Received: from moutng.kundenserver.de ([212.227.17.8]:59950) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SOqfC-0006cn-Bd for emacs-devel@gnu.org; Mon, 30 Apr 2012 09:29:14 -0400 Original-Received: from eskebo.merten-home.homelinux.org (krsn-4d0b8a73.pool.mediaWays.net [77.11.138.115]) by mrelayeu.kundenserver.de (node=mreu2) with ESMTP (Nemesis) id 0MdZVI-1SYoRP1yUm-00PLQ1; Mon, 30 Apr 2012 15:29:11 +0200 Original-Received: by eskebo.merten-home.homelinux.org (Postfix, from userid 1000) id 4EC4FC1643; Mon, 30 Apr 2012 15:29:08 +0200 (CEST) Original-Received: from eskebo.merten-home.homelinux.org (localhost [127.0.0.1]) by eskebo.merten-home.homelinux.org (Postfix) with ESMTP id 41BE7C1640 for ; Mon, 30 Apr 2012 15:29:08 +0200 (CEST) X-Mailer: MH-E 8.2; nmh 1.3; GNU Emacs 23.1.1 X-Provags-ID: V02:K0:VvcN2R6vuJuzqL5dO4XiNkGKDF1L5hKDW1RGUn+OAv3 Gb7WK/Uhg7l3ogoAHF5X1stTwXCJEFc6lRf9vSHpS4LdIT63a7 /DBaQEqliHQGB2wHjeKww5kgMq9dxOLS1GaYQCdekzpBijJ6x0 y5xQgF7+2xluA/qpmeMvpc0VDbVgVCsjTcjjtg8FI13k0/AJyc iPwrlntZRQIdkLFJfKdh1fGwNHGfi85jOHwr/1e8EYCjclnUFj WyLCPO11iTUgIq6VW8XMvefnKlU1C1APcrxw1Zomnvlw8A6lM0 bj9C8MvXbGoFZvOfFua5PNDiR1GBQD1RD360FF8/4tTYNmNvq0 eqrfwzTaRts5XokYMbf0jC3CF7a3nFYzM98KXCo/pdnKsC7VBA Mlvns8CEaINRhPC/G2N8MiFgJAM3zCR2/o= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 212.227.17.8 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:150159 Archived-At: --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Hi Emacs developers! I maintain `rst.el`. For some years now `rst.el` is also contained in Emacs (at `lisp/textmodes/rst.el`). However, for various reasons I were not able to maintain it in the Emacs repository. This has now changed :-) . With the help of Stefan Monnier I am now an Emacs developer. I consider it an honor to be allowed to contribute to one of the oldest Free Software projects which at the same time is my standard tool for so many tasks :-) . Having this said I need to add that my involvement here will quite likely focus on maintaining `rst.el`. I work on it once in a while and meanwhile it is really useful. I will continue to maintain `rst.el` in the Docutils project and I guess most feedback comes from there. Well, "meanwhile" also means that I worked a lot on `rst.el` compared to the version still in the Emacs repository. During the last few days I merged the changes to `rst.el` into my development version so these changes are already integrated. Well, how to bring this large "patch" into the Emacs repository? Usually in Free Software projects it's a best practice to submit small patches. In this case this really makes no sense - the diff consists of 288 hunks. May I commit simply the current version to Bazaar or is there a better way? Also a review of the current version by you may make sense. According to the GNU Coding Standards I need to write a ChangeLog entry. I don't see this makes much sense for such a large patch - at least not in the way ChangeLog entries are done according to the GNU Coding Standards. So how to construct a ChangeLog entry which complies with the standards but makes sense? My work at rst.el also resulted in some new features. Where to put a description of these features? I think this will be most interesting for a new version of Emacs. I also wrote a number of unit tests for some aspects of `rst.el` (nearly 6000 LOC) using the great `ert` framework. I looked around a bit in the Emacs repository and discovered the `test` directory. Would this be the right place to put my tests to? If so are there established practices for such a case? If not I'd create a directory `rst` there and put stuff there. Since my tests need a buffer to operate on I also wrote some support code for ert to allow tests on buffer contents. I didn't follow the development of ert - may be something like this exists meanwhile. If not this may be useful for others, too. Finally a general question: On which mailing lists I am supposed to subscribe as an Emacs developer? I just subscribed `emacs-devel` and `bug-gnu-emacs`. Do I need to subscribe to `help-gnu-emacs` also? Any others? Gr=FC=DFe Stefan --=-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.10 (GNU/Linux) iQCVAwUBT56ToQnTZgC3zSk5AQJxfQQAhwE/eJBTySdvDviAq4quig/5Ok/4VRdt kWwux8s/9We396YO9xF7jkcnPZKiaNjrUd0+MojzTB0Ik2EFw89P4VKB8zBjI2B0 OObY8nVpm/LRGyvCoaxyQB+RVHlqePgjq3nUH+P0AAedhnoE5SIs5XrwbEkbazBv 7U8rNwg6+jk= =RIzm -----END PGP SIGNATURE----- --=-=-=--