[Python-modules-team] Bug#840658: shadows builtin rst.el library

[Dmitry Shachnev]

Hi Antoine, and thanks for your bug report.

On Thu, Oct 13, 2016 at 11:37:20AM -0400, Antoine Beaupré wrote:
> .... i am told that rst.el is distributed with Emacs since
> v23.1. Unfortunately, it seems that if you have docutils-common *and*
> emacs24-common, you have *two* versions of this package installed:
>
> $ dpkg -S rst.el
> emacs24-el: /usr/share/emacs/24.4/lisp/textmodes/rst.el.gz
> emacs24-common: /usr/share/emacs/24.4/lisp/textmodes/rst.elc
> docutils-common: /usr/share/emacs/site-lisp/rst.el
>
> That seems strange to me: shouldn't there be only one rst.el mode out
> there?
>
> I would understand if one would be a symlink to the other, or
> something similar, but they are actually distinct versions:
>
> $ diff -u /usr/share/emacs/site-lisp/rst.el  <(gunzip -c /usr/share/emacs/24.4/lisp/textmodes/rst.el.gz)| head
> --- /usr/share/emacs/site-lisp/rst.el	2014-08-03 21:24:43.000000000 -0400
> +++ /dev/fd/63	2016-10-13 11:34:54.258665200 -0400
> @@ -1,6 +1,6 @@
>  ;;; rst.el --- Mode for viewing and editing reStructuredText-documents.
>
> -;; Copyright (C) 2003-2012  Free Software Foundation, Inc.
> +;; Copyright (C) 2003-2014 Free Software Foundation, Inc.
>
>  ;; Maintainer: Stefan Merten <smerten at oekonux.de>
>  ;; Author: Stefan Merten <smerten at oekonux.de>,
>
> This leads me to believe the one shipped with this package is also
> outdated.
>
> I would recommend simply not shipping rst.el anymore.

While the current docutils package in Debian indeed ships a quite dated
version of rst.el, the docutils upstream trunk has a newer version, and
it is even newer than what emacs ships (it is version 1.5, released this
year). Speaking in terms of your diff, it has copyright 2003-2016 [0].

Also, all the current development happens in upstream docutils project [1],
and the new releases are announced on docutils-users mailing list [2].
So I think docutils is still the right package to ship rst.el.

Will it suit you if I just update the package to include the latest version
of rst.el from upstream trunk?

[0]: https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/tools/editors/emacs/rst.el
[1]: https://sourceforge.net/p/docutils/code/HEAD/log/?path=/trunk/docutils/tools/editors/emacs/rst.el
[2]: https://sourceforge.net/p/docutils/mailman/message/35252938/

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20161020/f451a89b/attachment.sig>