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: Thu, 8 Jun 2017 17:12:37 +0900 Message-ID: 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> 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 1496909605 8536 195.159.176.226 (8 Jun 2017 08:13:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 8 Jun 2017 08:13:25 +0000 (UTC) To: emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 08 10:13:22 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 1dIsZE-00021G-2A for ged-emacs-devel@m.gmane.org; Thu, 08 Jun 2017 10:13:20 +0200 Original-Received: from localhost ([::1]:48029 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dIsZH-000715-8m for ged-emacs-devel@m.gmane.org; Thu, 08 Jun 2017 04:13:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44723) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dIsYi-00070l-VT for emacs-devel@gnu.org; Thu, 08 Jun 2017 04:12:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dIsYd-0005mQ-TU for emacs-devel@gnu.org; Thu, 08 Jun 2017 04:12:48 -0400 Original-Received: from mail-pg0-x236.google.com ([2607:f8b0:400e:c05::236]:33880) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dIsYd-0005m0-NU for emacs-devel@gnu.org; Thu, 08 Jun 2017 04:12:43 -0400 Original-Received: by mail-pg0-x236.google.com with SMTP id v18so13669851pgb.1 for ; Thu, 08 Jun 2017 01:12:43 -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=NUBtTzxxfdF7Xml7EH+FG8TRZRaSKDWcfWqJKIhqwEE=; b=LI7pgv1PVIruqTyh2n7JaPYhbF/oBF0FB9wscd4DuCqj2ZIXzC5wrVrJfmJHGOqMTI p+/3h4XZwQN1Y5V9maJ3HWo3Okt1de6hyfgoNfOGIJfq/lQ/8eAmeU4ElQVHU1kVTlbv Fins9T8Mlfl+KCbbFvRZLVn6JtRkvpiBvS8o1/146wIn64um2fRflxMQ9rMA8PBGVEeA hXj6nU8TAYH8VXtbucv0AlGseMNE3lF7JGOQgu/M9TotFt8V8tpDGeF+CWk5EFb7Eeb1 OMQ8aE+h4q/e+HbfxrUP4OGaHZ/Wm03wjB2diIhyWSNib12BWj0e9bgEVwO4QGlT06Rs i3ww== 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=NUBtTzxxfdF7Xml7EH+FG8TRZRaSKDWcfWqJKIhqwEE=; b=Zz48iAbku1kCDT53cUZ977QmoQUyLvdILn9yb+d0z574jDz9T8MHfJ9Xq/PzcKZn7m tVdzHRc09iriPM21HdRDn7ui7JL4nsHqaX0RMlqMaRqpizPg5+/nY3+1nx6P83yk0QQi YWjkNfwpJBozq+NyHXGYlpslex2F+m6CUF3srQE5Xz9QizZMc+Klqg3tmGx7uR1ymPJA Y7kuIx6o00tQ/1lQGIh8Feuy3V04Ciuxmp0fpIZBItWZCRIVe3ZhIVnz5T9P6Jzgu00I 5buM+Zuqvkuw5NeOJXwEbV3amONHtGqOVNYqt47BJtn0EcFm4lNK2VJ8S4PfL59MxVvP pSAA== X-Gm-Message-State: AODbwcCQmkSGQYVeQP/cJNSwKcxl6kwPcXjgT/eymtfY3DF7uKS8lT14 qOxs8SQ/UByn3DlcG5E= X-Received: by 10.99.119.6 with SMTP id s6mr25182210pgc.215.1496909562520; Thu, 08 Jun 2017 01:12:42 -0700 (PDT) Original-Received: from [10.249.4.52] ([210.160.37.43]) by smtp.gmail.com with ESMTPSA id z4sm8240759pgc.22.2017.06.08.01.12.41 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 08 Jun 2017 01:12:41 -0700 (PDT) In-Reply-To: <0B83D1B3-19D8-4F85-BCD8-357FC6F1C9A7@gmail.com> 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::236 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:215519 Archived-At: > On Jun 8, 2017, at 14:39, Chad Brown wrote: >=20 >=20 >> On 7Jun, 2017, at 20:48, Jean-Christophe Helary = wrote: >>=20 >> 2) my remark about javadoc was not intended to suggest a replacement = of the current documentation, but to have a document that has all the = docstring information (Emacs API) in one place. It would be an = alternative to the info system, with exactly the same contents. It would = be a great tool to find API information and also very practical to check = if the rules defined in the GNU Coding Standards are respected. >=20 > Could you perhaps talk about what you see as the benefit to =E2=80=9Can = alternative to the info system, with exactly the same contents=E2=80=9D?=20= An HTML page with the whole API with visual cues. Jean-Christophe=20