From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.emacs.devel Subject: Re: docstrings and elisp reference Date: Fri, 9 Jun 2017 00:42:52 +0900 Message-ID: <1F24A0CB-E8B7-4A55-B014-FEB60B6561B0@gmail.com> References: <0BB64F35-233A-471F-B99F-51F96C4E6CCB@gmail.com> <8360g99n07.fsf@gnu.org> <86lgp4q2xa.fsf@stephe-leake.org> <7acc7d4f-23cc-4b6a-b062-ef92805e465b@default> <878tl3rz38.fsf@x230.lts> <0B83D1B3-19D8-4F85-BCD8-357FC6F1C9A7@gmail.com> <8360g68qfo.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1496936621 31625 195.159.176.226 (8 Jun 2017 15:43:41 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 8 Jun 2017 15:43:41 +0000 (UTC) To: emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 08 17:43:32 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dIzat-0007cE-SC for ged-emacs-devel@m.gmane.org; Thu, 08 Jun 2017 17:43:31 +0200 Original-Received: from localhost ([::1]:50293 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dIzax-0001OO-Ng for ged-emacs-devel@m.gmane.org; Thu, 08 Jun 2017 11:43:35 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57217) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dIzaO-0001OI-1q for emacs-devel@gnu.org; Thu, 08 Jun 2017 11:43:00 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dIzaK-00023u-S7 for emacs-devel@gnu.org; Thu, 08 Jun 2017 11:43:00 -0400 Original-Received: from mail-pg0-x22e.google.com ([2607:f8b0:400e:c05::22e]:35235) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dIzaK-000233-MB for emacs-devel@gnu.org; Thu, 08 Jun 2017 11:42:56 -0400 Original-Received: by mail-pg0-x22e.google.com with SMTP id k71so17288539pgd.2 for ; Thu, 08 Jun 2017 08:42:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:content-transfer-encoding:mime-version:subject:date:references :to:in-reply-to:message-id; bh=VB9E45d9X6slF+j7dY5EuIrEhf0P53CtWK2JuKRQmgo=; b=G7A6lJHaZXMGgPSzWzq92cnT9VIUP5q5YdxgT7TvRSsfVMScG5kdK0rMHHZGIprcl2 WdnTp2c5R+eJqL04rM0gEEx2wyxBAV8WDllMUNgdTG4A8Vt095llXdCiZ012dUkc0FvB uqsH+Z+dzrKtPFxdKz/MweNjNJhJdg53uF71ZZxBqv23nF6n8ieQ0u7hviG10vAkPItx p5xM7QA97lvisPzChWg37x9J6CqT8/VRfrEaAmhWCIpKiND9w2EKpss3q+qWuRIarkHo bE8Vq8jzXCZMpZyF9L23B0kj4R73iK5kMX0FP8BPBamEP19H89iqHPkjL4CuHyPUCoYN iGLA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:content-transfer-encoding:mime-version :subject:date:references:to:in-reply-to:message-id; bh=VB9E45d9X6slF+j7dY5EuIrEhf0P53CtWK2JuKRQmgo=; b=qi07KRb53YwYDMVm30gkjOqL5JXKyYpfnHOZAWwrVADRLOzBNd2mlVb7fYrFpHAioJ D0Esmv34PdxCbtmV+08quCzf1AKnqufIeBlkC+EDTQZuWmqpJO0gqYTEVXdJZjnFGxs3 j4m6VZUQKPf4n3CPulw9prjenoUaN8LWA+UriohHR6sX53WkpNZE84bmNq4N5X1vE/f6 CYvJp21DtwbP9YQBV2AkgoRWFR/VG1m9Jywiit3qTnpkJcPYPboagBJ9a/kfoTqetN61 2ovYg17oO0lXX0S2hDwybl324ckGdmDmzmIU4uohja7m10DpF1uNSvBdOGbjBaHSURIi 0Djg== X-Gm-Message-State: AODbwcASp32H8jFoukag8o4vDHu53bBZqzkXATFghhsIgDGpNu671ngy LEOoC+sXUUDxFkwr4Es= X-Received: by 10.84.199.170 with SMTP id r39mr23493968pld.204.1496936575501; Thu, 08 Jun 2017 08:42:55 -0700 (PDT) Original-Received: from [192.168.24.55] (pl2587.ag0304.nttpc.ne.jp. [128.53.196.27]) by smtp.gmail.com with ESMTPSA id z13sm6592566pfk.99.2017.06.08.08.42.54 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 08 Jun 2017 08:42:54 -0700 (PDT) In-Reply-To: <8360g68qfo.fsf@gnu.org> X-Mailer: Apple Mail (2.3273) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:400e:c05::22e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:215522 Archived-At: > On Jun 9, 2017, at 0:11, Eli Zaretskii wrote: >=20 >> From: Jean-Christophe Helary >> Date: Thu, 8 Jun 2017 17:12:37 +0900 >>=20 >>> Could you perhaps talk about what you see as the benefit to =E2=80=9Ca= n alternative to the info system, with exactly the same contents=E2=80=9D?= =20 >>=20 >> An HTML page with the whole API with visual cues. >=20 > Can you elaborate on the "visual cues" part? I mean a data set that makes full use of CSS selectors and provides = visual information about where are the function names, the arguments, = the types of arguments, etc. by using something like syntax highlighting = and things like this. But the contents would be exclusively the docstrings, with 2 way links = to the elisp reference. I guess when we develop an extraction process = for l10n, it will be possible to implement. Jean-Christophe=