From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Fri, 29 Nov 2019 10:36:23 -0500 Message-ID: References: <837e3iq0ks.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="35218"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Eli Zaretskii , Anonymous , Emacs developers To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 29 16:44:29 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 1iaiRY-00092H-BN for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 16:44:28 +0100 Original-Received: from localhost ([::1]:60324 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iaiRX-0004bq-4r for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 10:44:27 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49498) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iaiJr-0001Jv-Jr for emacs-devel@gnu.org; Fri, 29 Nov 2019 10:36:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iaiJo-0005jj-FM for emacs-devel@gnu.org; Fri, 29 Nov 2019 10:36:29 -0500 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:34081) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iaiJn-0005aN-2U; Fri, 29 Nov 2019 10:36:27 -0500 Original-Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 0745B44A446; Fri, 29 Nov 2019 10:36:26 -0500 (EST) Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id C3F6F44954B; Fri, 29 Nov 2019 10:36:24 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1575041784; bh=+uAwVyusITgdNImpwnZf1mXQo4n8tWI+zhkNxps8dCM=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=nQg7Efg965mYnWVHrPLWyKv+Yw+9nvU0OUG4WTvysezKoUyK9CLjrIoCeo1+rjlb3 qUr7eoWrARE6O8GzFgflIIegoYs7qhPczDJFfMs7yLG4NpredqyiE7iikQX0CwtB+D cN07s6lvE7me39Fkh92TzAMzuLCjUYDlim8y0IDil49rllYCnC0H/3r56hfJJTkAen vH1zh1kxlxjh+3YgCm8dJq6kjZmCcmAI5qNJNvFghUwPfIvlaq+fKZkP5Qnn0+TBfF w+P0xNcm6ZoNAWNgh04OXk1whtpJ7pamYEUNf1hgWwtljJPY16DdzLFUtYkP5ZVgbb X/1C7Y6t+EK+Q== Original-Received: from alfajor (modemcable157.163-203-24.mc.videotron.ca [24.203.163.157]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 985001211AF; Fri, 29 Nov 2019 10:36:24 -0500 (EST) In-Reply-To: (Stefan Kangas's message of "Fri, 29 Nov 2019 14:34:44 +0100") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 132.204.25.50 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:242880 Archived-At: > I fail to see why a reference manual can't also include examples. I don't think anyone would suggest that examples don't belong there. Manpages are typical "reference manuals" and many of them include(d) examples. AFACT, currently we have some examples in the Elisp manual and very few examples in docstrings. It might be a good idea to encourage the addition of examples either in docstrings or in the Elisp manual (or both). Stefan