From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: =?UTF-8?Q?Cl=c3=a9ment_Pit-Claudel?= Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Fri, 29 Nov 2019 16:42:28 -0500 Message-ID: <4f3fe5b0-3a63-346e-5cea-bb5ed057e028@gmail.com> References: <837e3iq0ks.fsf@gnu.org> <87h82my0fm.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="266269"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.1 Cc: Eli Zaretskii , Stefan Kangas , Anonymous , Emacs developers To: Michael Albinus , Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 29 22:57:38 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 1iaoGf-00178u-7Q for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 22:57:37 +0100 Original-Received: from localhost ([::1]:35524 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iaoGe-0007cQ-1f for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 16:57:36 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49221) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iao25-0001FM-97 for emacs-devel@gnu.org; Fri, 29 Nov 2019 16:42:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iao24-0001Of-6I for emacs-devel@gnu.org; Fri, 29 Nov 2019 16:42:33 -0500 Original-Received: from mail-qk1-x72a.google.com ([2607:f8b0:4864:20::72a]:41274) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iao23-0001Gq-Vn; Fri, 29 Nov 2019 16:42:32 -0500 Original-Received: by mail-qk1-x72a.google.com with SMTP id m125so26716376qkd.8; Fri, 29 Nov 2019 13:42:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Rm+dQGZjdAJlady5K12AtaUPMSs4aPWVtBthNl8/D2Y=; b=q7Z31MFAtQEjR6FpncWbT5tAAebUnbpmJhP1aH+ml5r+kJIP+RbDwTODi/7Ri09GGH /qHNA5V1z4KnSm3/F4IzcR+VX+d8V/gllBGj3eOQ79uW9rgZytU7bU8Ij4jYnLSZQtH/ bvB7CLLB3N8lt7HipZbb0qE8h+OA4Cmhl/yxnvzNgAK5+gPCj/8sjjGdNfVLCPtg9qkI m9KhxzO5DizqYTsVGUA12AThpjzwevdETa6CLmMgU2k6074ka3xtLxFydYtZ27qWXtUp rdsaUac+YY5ulJaH18+nus+s2VwNal+05abiv4PLxlRSAYqhIiyxT+VlgVbbZ2aDesUk v/qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Rm+dQGZjdAJlady5K12AtaUPMSs4aPWVtBthNl8/D2Y=; b=rw9G7TLHUKmSnnZkseQlwwoeYuJ23fbAsMme47M/gEMhURHqAiwt7xRKa20FLzDXxY Gz4KzxHmx/aGdSI9P4yW1BBOR4aMEhyPp169brp4mrs2MVz+7bWH2JxaKPevf2oHfAte QVgMotp+5hvc0pb023L1LaLbHOac8DnwooXqZdXYlMezo4PSw8qUV1hisH+Ofsgwlq8Y q4dYVvWzFZcL5qZ2fjotcXE3QrPU/cGM5UakYpCR9hZ7uh3EXJ6xPuGBQUKs6gluQOoU 3861H8ZjnAcCqMTvHpRD1adY+pBX8oOrdcEHElEJxxRXS6lgLidlAIg75byCoaM3wG4q n7DQ== X-Gm-Message-State: APjAAAVqV5/IIAeXmktQ6S7+zKcoakR9F5gt+uhRhiaOXoSEKLl7OgkQ MM26C7rgM6nXweIT61G8GtewNdAx X-Google-Smtp-Source: APXvYqwoATE+Gtds4nRwKKPJaQOUb4nM5J5zCGIGLoiflRfoYxeKTGkQsQMVMQHSTmIj7OQGpQZ6yQ== X-Received: by 2002:a05:620a:68c:: with SMTP id f12mr7662015qkh.500.1575063749813; Fri, 29 Nov 2019 13:42:29 -0800 (PST) Original-Received: from ?IPv6:2601:184:4180:66e7:c1ed:a694:851c:6c56? ([2601:184:4180:66e7:c1ed:a694:851c:6c56]) by smtp.googlemail.com with ESMTPSA id 139sm4440237qkj.116.2019.11.29.13.42.28 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 29 Nov 2019 13:42:29 -0800 (PST) In-Reply-To: <87h82my0fm.fsf@gmx.de> Content-Language: en-GB X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::72a 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:242900 Archived-At: 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.