From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Sat, 30 Nov 2019 00:12:35 +0000 Message-ID: <87o8wuusr0.fsf@gmail.com> References: <837e3iq0ks.fsf@gnu.org> <87h82my0fm.fsf@gmx.de> <4f3fe5b0-3a63-346e-5cea-bb5ed057e028@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="19877"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Stefan Kangas , Emacs developers , Michael Albinus , Stefan Monnier , Eli Zaretskii , Anonymous To: =?utf-8?Q?Cl=C3=A9ment?= Pit-Claudel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 30 01:13:19 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iaqNx-00052u-1J for ged-emacs-devel@m.gmane.org; Sat, 30 Nov 2019 01:13:17 +0100 Original-Received: from localhost ([::1]:36030 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iaqNv-0004v3-QO for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 19:13:15 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44760) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iaqNS-0004uq-VT for emacs-devel@gnu.org; Fri, 29 Nov 2019 19:12:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iaqNS-0004o9-0Y for emacs-devel@gnu.org; Fri, 29 Nov 2019 19:12:46 -0500 Original-Received: from mail-wr1-x435.google.com ([2a00:1450:4864:20::435]:32789) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iaqNR-0004lv-OB; Fri, 29 Nov 2019 19:12:45 -0500 Original-Received: by mail-wr1-x435.google.com with SMTP id b6so7422171wrq.0; Fri, 29 Nov 2019 16:12:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=yP9V7K2p2eh82xfS+ON3c8H77v4hHwveDyrgKgZ/5LU=; b=JtXr3La2yvUsSqASpVrHjwnKahN/wWHzPSgsD/Q2qB+aAFvmkAtxVT36aj3vFooGk0 F0mHzuNffCS2tbFig9doqSTyqMpm27/Ez8D2/vGmue/0vehp/78QSPcTjYhWAb8rQtWm KRF0HZD0k8OwI43w1zdbyOmN2raX5Gkn3H+yZoiI4xjYooAAO/v9tSt24hD4FAgJec1p aPczBxoE8Ns9IPhUqXsjmMAsXRDt3Q4ZHjD3UbdUiWRK49jPihetqEL4AKIxxCb3ZxsR zshLUqZcXgz5xLOisVp+rN/TYEMi/kl+Mke+zlQUVQst15Xa+h3h5BAhiesXYR09yYaa 9OXA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=yP9V7K2p2eh82xfS+ON3c8H77v4hHwveDyrgKgZ/5LU=; b=mELr5WtmnH4Ntyi5soQ1kNdRQAw6jbdmvnolSpfL6u/iYnljD8zd8FthAUh9mDLgdl PIcOZjNpJzjIO6zd7c6gavl8nZzNgm7B86gSQImezwPFkqetiu57RiP8SQTgh28rTafx gzkcId45WBiZTx/9BSvlbl3ijvMQXBb0bRHZfTJzJD3698qrFtEnAv2j0izDC1Zp+Klv GIwhnq6ls3KFki2UyeJNMtbJRHffNr8ve0qj3ZVL4/Hhimaf74ExHQOrjdEqMA2blkOU XP9Ccw16bKiNdHtgXxxCZcGgW2edfdzztoRsmOOMX8DUsMhwSXutRix2lc3aYHTcwOyT 1Fbg== X-Gm-Message-State: APjAAAXfmyhkrSqHyTgMJuNN59iNs07LdD9idlyYCRLc5ERVnunoJzkS ziV9x8iwUImTKiW1IohKEzlnOHmBz50= X-Google-Smtp-Source: APXvYqzWK10/TzO9G/fmDtjhINEnsbOBPc7bDhPQTAu8+LM3IT6xxegWfSZXftmfg3DTz9/4qnu83A== X-Received: by 2002:adf:a746:: with SMTP id e6mr942139wrd.329.1575072763798; Fri, 29 Nov 2019 16:12:43 -0800 (PST) Original-Received: from lolita.yourcompany.com ([2001:818:d820:9500:1ebb:afd8:ab26:f0f6]) by smtp.gmail.com with ESMTPSA id c9sm14656954wmb.42.2019.11.29.16.12.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Nov 2019 16:12:41 -0800 (PST) In-Reply-To: <4f3fe5b0-3a63-346e-5cea-bb5ed057e028@gmail.com> (=?utf-8?Q?=22Cl=C3=A9ment?= Pit-Claudel"'s message of "Fri, 29 Nov 2019 16:42:28 -0500") X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::435 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:242901 Archived-At: Cl=C3=A9ment Pit-Claudel writes: > On 2019-11-29 13:58, Michael Albinus wrote: >> Personally, I don't like docstring to be too verbose. Usually, when a >> function is documented with both docstrings and a manual, I prefer to >> put the examples in the manual. > > I very seldom look at the ELisp manual, mostly because I don't think > of it; one thing that would be great would be if there were links to > the manual from the docstrings for functions that are covered in both. Agree. There are some already. But many many more would be needed Though wouldn't that unnecessarily spam the docstrings? Perhaps we could automatically mark a .el file as documented in a specific node of the manual and make that node automatically be referenced as "read more about this in node..." in the docstring. Jo=C3=A3o