From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mario Martelli Subject: Re: org-protocol documentation Date: Thu, 29 Jun 2017 20:30:01 +0200 Message-ID: References: <68E12968-9AF5-440A-B22C-AC55B70BA910@schnuddelhuddel.de> <87k248b6p8.fsf@nicolasgoaziou.fr> <7C76EDC3-CC7E-4AFE-B45B-867752C1B33A@schnuddelhuddel.de> <87a8519rlg.fsf@nicolasgoaziou.fr> <8760fp9mui.fsf@nicolasgoaziou.fr> <2FAD7DF2-2A0C-4703-A383-BA8D3346C691@schnuddelhuddel.de> <18D83D3C-C472-4614-988F-1F1DA5EB5CEC@schnuddelhuddel.de> <87efub7psj.fsf@nicolasgoaziou.fr> <87lgobrmm7.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42044) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dQeCh-0005vc-UN for emacs-orgmode@gnu.org; Thu, 29 Jun 2017 14:30:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dQeCd-0006tA-25 for emacs-orgmode@gnu.org; Thu, 29 Jun 2017 14:30:11 -0400 Received: from mail-wm0-x231.google.com ([2a00:1450:400c:c09::231]:35976) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dQeCc-0006rw-S7 for emacs-orgmode@gnu.org; Thu, 29 Jun 2017 14:30:07 -0400 Received: by mail-wm0-x231.google.com with SMTP id 62so90335707wmw.1 for ; Thu, 29 Jun 2017 11:30:05 -0700 (PDT) In-Reply-To: <87lgobrmm7.fsf@nicolasgoaziou.fr> 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" To: Nicolas Goaziou Cc: emacs-orgmode@gnu.org Hi, > Besides the changes suggested above, we should put some thinking in = the > structure, which may be not adapter for a manual. In particular, it > should be made shorter. My attempt was to copy the existing documentation from worg to the core = documentation and to leave as much as possible unchanged. I also think that a much shorter documentation of Org protocol would be = the better approach.=20 > Also, index entries are sorely missing for now. It seems that writing the documentation in Org and exporting it to texi = might not be the best approach. I=E2=80=99ll start with a fresh approach and try to bring up a short = manual in org.texi. BTW: Papers are signed Kind regards Mario =E2=80=94=20