From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] master 9ffb6ce 5/5: Quoting fixes in lisp/international and lisp/leim Date: Tue, 1 Sep 2015 12:25:28 -0700 Organization: UCLA Computer Science Department Message-ID: <55E5FBA8.3090807@cs.ucla.edu> References: <20150831061236.27796.57762@vcs.savannah.gnu.org> <55E3F434.2060507@yandex.ru> <55E496DC.1030608@cs.ucla.edu> <877foas9jh.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1441135572 15869 80.91.229.3 (1 Sep 2015 19:26:12 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 1 Sep 2015 19:26:12 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 01 21:25:49 2015 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 1ZWrBj-0004pq-W2 for ged-emacs-devel@m.gmane.org; Tue, 01 Sep 2015 21:25:48 +0200 Original-Received: from localhost ([::1]:57286 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZWrBj-0006jO-I7 for ged-emacs-devel@m.gmane.org; Tue, 01 Sep 2015 15:25:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49417) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZWrBW-0006ib-Mz for emacs-devel@gnu.org; Tue, 01 Sep 2015 15:25:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZWrBS-0007h9-8s for emacs-devel@gnu.org; Tue, 01 Sep 2015 15:25:34 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:53774) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZWrBS-0007gj-4B for emacs-devel@gnu.org; Tue, 01 Sep 2015 15:25:30 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 743C6160633; Tue, 1 Sep 2015 12:25:29 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id bp6CyZfr2GS2; Tue, 1 Sep 2015 12:25:28 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 87BEF160838; Tue, 1 Sep 2015 12:25:28 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 2elHnlCtGe-u; Tue, 1 Sep 2015 12:25:28 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 6F815160633; Tue, 1 Sep 2015 12:25:28 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 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:189419 Archived-At: On 09/01/2015 08:39 AM, Stefan Monnier wrote: > - The `...' markup (and it is markup) is ambiguous. It certainly is (and always has been, alas), but before jumping into=20 improving it, could you explain what ambiguities you'd like to resolve=20 with an improved markup? Currently `...' markup in docstrings is used for: * Symbols, e.g., `load-file' * Info nodes, e.g., `(emacs)Lisp Libraries'. * URLs, e.g., `http://bama.ua.edu/cgi-bin/man-cgi?lp' * Characters, e.g., `&', ` '. * Key sequences, e.g., `C-x ESC O P'. * Strings, e.g., `69'. * Regular expressions, e.g., `\\(_P\\|_PROTO\\)'. * English phrases, e.g., `close in spirit', `things'. * Lisp patterns, e.g., `(ATOM . ELLIPSIS)'. * Lisp code, e.g., `(thai nil nil (mark))'. * Non-Lisp code, e.g., `ls -lR'. * Probably some other stuff I=E2=80=99ve missed. Most of these items are sometimes put in block quotations rather than in=20 quote symbols, if they are long enough. So, when removing ambiguity, how many categories would you like to put=20 the above examples in? And how should the different categories be=20 rendered on plain-text consoles and on graphical displays? I sort of=20 have the impression that by =E2=80=9Cmarkup=E2=80=9D you mean =E2=80=9Cth= ings that should turn=20 into links=E2=80=9D, but maybe you mean =E2=80=9Cthings that should be re= ndered in=20 fixed-width font if we have a nice display=E2=80=9D, or maybe there are t= wo or=20 even more kinds of markup that you have in mind.