From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kyle Meyer Subject: [DEV] Text quoting backports Date: Sun, 06 Sep 2015 02:12:40 -0400 Message-ID: <87a8t0jctj.fsf@kyleam.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48798) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYTC6-0001Ka-Kz for emacs-orgmode@gnu.org; Sun, 06 Sep 2015 02:12:51 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZYTC2-0003tF-Kd for emacs-orgmode@gnu.org; Sun, 06 Sep 2015 02:12:50 -0400 Received: from mail-qg0-f54.google.com ([209.85.192.54]:33064) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYTC2-0003t6-GM for emacs-orgmode@gnu.org; Sun, 06 Sep 2015 02:12:46 -0400 Received: by qgev79 with SMTP id v79so44092773qge.0 for ; Sat, 05 Sep 2015 23:12:45 -0700 (PDT) Received: from localhost ([2601:18a:c201:560f:9e4e:36ff:fe3d:ae9c]) by smtp.gmail.com with ESMTPSA id x19sm2373517qkx.32.2015.09.05.23.12.44 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 05 Sep 2015 23:12:45 -0700 (PDT) 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: Org-mode Hello, There have been several commits made recently in the Emacs repo related to quoting style in docstrings and messages. I've backported the changes touching Org files and pushed to the branch maint-quotes. I put them there instead of installing them directly on maint to allow time for things in the Emacs repo to settle and to get feedback about how I plan to incorporate these changes. (Judging from the discussion on emacs.devel [1-5], there may be various opinions on this.) Regardless of how we decide to use these changes, I'd prefer to include all the commits and then follow up with additional commits necessary to get to the desired state. This way there is a clear record of each commit being considered. Below is my plan at the moment, organized by different types of changes. Thoughts? ------------------------------------------------------------------------ * s/'symbol/`symbol'/ Keep changes. * s/'.*'/=E2=80=98.*=E2=80=99/ and s/`.*'/=E2=80=98.*=E2=80=99/ Revert changes. Regardless of whether these substitutions are made, these will be handled by message and friends to display according to text-quoting-style, so the displayed result in the help buffer will be the same. * s/\".*\" /=E2=80=9C.*=E2=80=9D/ Revert changes. * s/'/\\=3D'/ Keep changes. * s/'(.*)/(.*)/ Some of the changes removed single quotes. For example, - '((\"c\" \"d\" ((in-mode . \"message-mode\")))) + ((\"c\" \"d\" ((in-mode . \"message-mode\")))) Others protected the single quote. For example, - '((\"p\" \"q\" ((in-file . \"\\\\.txt\\\\'\")))) + \\=3D'((\"p\" \"q\" ((in-file . \"\\\\.txt\\\\'\")))) I've been unable to figure out the logic here as to when a quote form like this was removed versus protected. I plan to convert all cases that were removed to \\=3D' instead. * s/format/format-message/ calls Keep changes. * Added substitute-command-keys calls Keep changes, but extend to use command names instead of hard coding keys. ------------------------------------------------------------------------ [1] http://thread.gmane.org/gmane.emacs.devel/189240 [2] http://thread.gmane.org/gmane.emacs.devel/188822 [3] http://thread.gmane.org/gmane.emacs.devel/189331 [4] http://thread.gmane.org/gmane.emacs.devel/189621 [5] And maybe other threads I'm missing -- Kyle