From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: Adding examples in the doc Date: Fri, 29 Nov 2019 21:03:39 +0100 Message-ID: <87d0daxxes.fsf@gmx.de> References: <837e3iq0ks.fsf@gnu.org> <87h82my0fm.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="64533"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Eli Zaretskii , Stefan Kangas , Anonymous , Emacs developers To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 29 21:05:53 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 1iamWU-000GUe-Oy for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 21:05:50 +0100 Original-Received: from localhost ([::1]:34932 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iamWR-0002CX-SR for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 15:05:49 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57797) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iamUp-0002C1-Ag for emacs-devel@gnu.org; Fri, 29 Nov 2019 15:04:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iamUk-0002mG-5C for emacs-devel@gnu.org; Fri, 29 Nov 2019 15:04:03 -0500 Original-Received: from mout.gmx.net ([212.227.17.22]:37973) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iamUj-0002Sj-M0; Fri, 29 Nov 2019 15:04:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1575057822; bh=BWe36cB+YsVTorjCURm6GQ5gm9IhzVUP44yF8UZpAB4=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=CBMHhebwtow2kg+qm5RwKZWagjRTG9igZltWWAjmFBJ1pnctHeLpZxwt5brRFLDYW bZP0gcawAO7EDlaezKLgaR4hGxF2Ow/OUrxONHLvmDD97uFWCvdmTuY0jFtlcuM78H jXU9BIumuE+7adoiXMyizv6J5UWYUjbEfBu2K/I4= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from detlef.gmx.de ([212.91.243.137]) by mail.gmx.com (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1M3UV8-1ibKil3rcI-000bAb; Fri, 29 Nov 2019 21:03:42 +0100 In-Reply-To: (Stefan Monnier's message of "Fri, 29 Nov 2019 14:13:25 -0500") X-Provags-ID: V03:K1:xSuEl0aLH3a7y2mViBFDQzww6W45335NY/PPeEkSetjo2DDqfY+ lgyX1dKVJxJEE89IcDv/lwaXErx3vdgh8xzu+t7NbZLj36bhVolEcxKHAE1j53HxzLIcjQ+ UTJnSoeg0la7IacCHBRqYDWE3jVJROjRxfDefRQXIrmolc8NUih5NFu6PHglDGDpmXRXEcz U1OUG0ctBpUdt5Eji0Oww== X-UI-Out-Filterresults: notjunk:1;V03:K0:z4esxHjpZZI=:FmI7AcsY/JaJ4l0TXiSuix bXavpdaz8LyVDWs5KBSr5XSrZvupULnW+g+4QtbJIc5Psn5xx9uNpCPYxUfOMzEteqXE+bKBO yPt3nEGbbpWMvraak+0vAhpKHAghlZ1ZYfYJVPueoNAq4CqDChjwsgE2DqNAxkbu1XX30hNCm D6jabBzlK/O0EXyJhoBWmWDReO34v1BmLT+92Bxvf7QVJ7eXHBGIkrvHTzUJz5LUff8FHzbrm xHcHQv9Sw65u5FCF9LfXBINoCZwi6OVPWVsMg2GZcgepmA/2mpq7JTeuU4h/+0gEKt06FS0DR 8FbWeEt7McQdmoShHlfPPqphyjwFHuzMdgUE4JB5YMqzm3xX4rgVjU33w83I+URS/QvEN1PEH yzlmf5aY5FS9VSGYfOjs8LLFKSgFebCwNkmD5Totn12vo4LGGhb1+mVqlQoUu/5DqeWtLDRlp vTwN1UQkN3fRqFTGmgzwcGObNPeTTLvcK6anL61XsxBtEf6HLq0aFo/U+Z9dSGOLQyxU4EVZZ MIWVcK3TrzN3Je7LcoF+o4cmpZicUJ8/d1eylde0FE/aQgHR3BQrcf5X0iW3zPm8sU+GYLhp0 SUXEZGbyDEdTy+yQrb/23NqeRa6DkKYbVKNRXCBAGsjLNWAFY3je1fDBpM7PPT0O9bNmZK1l7 g8kbs+fB7L/prgI2URn9G2mvvQ6zGsyvD3+dIyothSxqXF4x0d1AMiQCn/xYg1JwlwawCstaL RWvmqjC4ER0Cl+mZACvCbl8EF0LP4YG2USunHKVflWpZtsGBT1Zzy+TSmokkrMge5TSD+KzI X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 212.227.17.22 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:242889 Archived-At: Stefan Monnier writes: >> Usually, when a function is documented with both docstrings and >> a manual, I prefer to put the examples in the manual. > > I find code in texi files to be less convenient to edit/use. I always prepare the example in *scratch*. Copied to the texi file only when it works. > Stefan Best regards, Michael.