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 07:44:47 +0900 Message-ID: <700BED95-1791-4043-AFF5-2EDB753FED54@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> <834lvq8q3o.fsf@gnu.org> <8737bapcze.fsf@x230.lts> <83vao670lq.fsf@gnu.org> <878tl2nsb5.fsf@x230.lts> 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 1496961905 10391 195.159.176.226 (8 Jun 2017 22:45:05 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 8 Jun 2017 22:45:05 +0000 (UTC) To: emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 09 00:44:58 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 1dJ6Ak-0002A4-8p for ged-emacs-devel@m.gmane.org; Fri, 09 Jun 2017 00:44:58 +0200 Original-Received: from localhost ([::1]:51687 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJ6Am-0003tB-Dg for ged-emacs-devel@m.gmane.org; Thu, 08 Jun 2017 18:45:00 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44915) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJ6Ag-0003t6-ON for emacs-devel@gnu.org; Thu, 08 Jun 2017 18:44:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dJ6Ad-0005ME-Lb for emacs-devel@gnu.org; Thu, 08 Jun 2017 18:44:54 -0400 Original-Received: from mail-pf0-x22d.google.com ([2607:f8b0:400e:c00::22d]:36474) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dJ6Ad-0005Ld-G0 for emacs-devel@gnu.org; Thu, 08 Jun 2017 18:44:51 -0400 Original-Received: by mail-pf0-x22d.google.com with SMTP id x63so21752172pff.3 for ; Thu, 08 Jun 2017 15:44:51 -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=28Om/xqqs7prpbeMHpSvX/lyZXNFg2OMpXKdbU9cyQE=; b=TUmhfc8ON4SUDtjtuhDXhGIH9uk3WmP4G8WqpMo3Qg+I/5sPDvgzvFmNbWL08sP0DE XM3s367fFDxpKKYGELqtJ3cNukjE69K23JuhAOSHrnKdnMQZEZFlQBuHUwbZKr7TcO5J kxBEReFTfhth+951svJSE1tgpUEAEgAGda8dWYCgWJtr7PNpGZfCA24+ktG05E1dGq0x Di6gBtuMcS4aAKnAk7XOOGh+EUN3WjjZsZDDcYxGC/3Kl7nvDMc6D6Yg4RFZMZsTtYX8 DvAc11aT1MKowOJD2srDgYGkg8ok2alx/SQcUoOSI6Q+HPsTpdR+CotgO3SQ6SLwKWgq DA/w== 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=28Om/xqqs7prpbeMHpSvX/lyZXNFg2OMpXKdbU9cyQE=; b=stTK61RU1ZLLndgACwpSoB4wQIk9M7Bs1d/nicSsy/HvkNSyMHp3+tH6JiFwAJ+Uqv AJ3fsNUYYFio4abihTORxiXmf++G2OB5FucYbJ5fe/5SALLhg2ul3IPSqOEGAeHWm1sl nVQtsDp7Varq8hlhoHoAmHo9QnSmWSRey0mH+D0Gq/zAd6kgAKjXUFP7aF9psIgpJqzI caR11cIbm4uyUqtC3upnP0stMxiPvWLj7AyaoBDaKyIzP9huXNTVA54ZNICqfCjcRv9g yRRpYlH18YDuoN85OfZOpA/mmxx2Ny7UBqWf9O4DZs9dvC9J/Is9z934YLwCIbPMX+/e 61Rw== X-Gm-Message-State: AODbwcA1k2GAyLyaOGOOsZTrbctk2sBi4MkkMhfMlkE1ocqxcqCeI15X HkirDhWHWzec93AwnsA= X-Received: by 10.84.231.135 with SMTP id g7mr37063683plk.110.1496961890293; Thu, 08 Jun 2017 15:44:50 -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 i68sm12722957pfi.72.2017.06.08.15.44.48 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 08 Jun 2017 15:44:49 -0700 (PDT) In-Reply-To: <878tl2nsb5.fsf@x230.lts> 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:c00::22d 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:215533 Archived-At: > On Jun 9, 2017, at 5:22, Etienne Prud=E2=80=99homme = wrote: >=20 > Jean-Christophe seems to be right about using more the HTML conversion > templates. Some of the semantic tagging is lost in the HTML = conversion > and that=E2=80=99s where the difficulty was. As I mentioned, there are ways to maintain compatibility with old HTML = tags and systematically add CSS hooks to *every* texinfo tag and more = (for ex. splitting the defun argument list to separate arguments from = identifiers like &optional and &rest, but there are other things too). And if we can do the same for the docstrings and link the two together, = we'll have a really powerful way to find information and learn in html = too. Jean-Christophe=20=