From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Van L Newsgroups: gmane.emacs.help Subject: Re: Getting functions usage examples [ Date: Tue, 9 Oct 2018 20:33:59 +1100 Message-ID: <5D82E5B3-0C46-48C2-9931-711294037830@scratch.space> References: <638fb7dc-6fc5-4645-8793-97a00038a3a8@googlegroups.com> <86tvlyx71z.fsf@zoho.com> <92FE2531-09A4-4FCF-8A8B-1EA35640E0D9@scratch.space> <87lg785tvu.fsf@portable.galex-713.eu> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1539077587 1305 195.159.176.226 (9 Oct 2018 09:33:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 9 Oct 2018 09:33:07 +0000 (UTC) To: Emacs Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue Oct 09 11:33:03 2018 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g9oNv-00007A-JI for geh-help-gnu-emacs@m.gmane.org; Tue, 09 Oct 2018 11:32:59 +0200 Original-Received: from localhost ([::1]:50380 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9oQ1-0000Qy-UC for geh-help-gnu-emacs@m.gmane.org; Tue, 09 Oct 2018 05:35:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49063) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9oP6-0000On-DJ for help-gnu-emacs@gnu.org; Tue, 09 Oct 2018 05:34:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g9oP3-00052f-90 for help-gnu-emacs@gnu.org; Tue, 09 Oct 2018 05:34:12 -0400 Original-Received: from relay10.mail.gandi.net ([217.70.178.230]:59423) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g9oP2-0004zx-Vj for help-gnu-emacs@gnu.org; Tue, 09 Oct 2018 05:34:09 -0400 Original-Received: from epi.local (220-244-158-222.tpgi.com.au [220.244.158.222]) (Authenticated sender: van@scratch.space) by relay10.mail.gandi.net (Postfix) with ESMTPSA id 07744240009 for ; Tue, 9 Oct 2018 09:34:03 +0000 (UTC) In-Reply-To: <87lg785tvu.fsf@portable.galex-713.eu> X-Mailer: Apple Mail (2.3124) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 217.70.178.230 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:118228 Archived-At: >>>> then one simple example, then a more >>>> complicated example, then the example that >>>> confirms the rule. >>>=20 >>> as not everybody needs examples, and ideally we should just keep = using >>> only definitions >>=20 >> Examples are likely cache hits for 80% of people for bridging their = gap. >=20 > Can you be more precise about what do you exactely mean by =E2=80=9Cbrid= ging > their gap=E2=80=9D (to what?) in this context? Most people have a goal wanting to be achieved. They consult the documentation examples to get their=20 fill-in the gap in understanding to get there. Picture Ikea furniture assembly as a way of getting the thing done. Some non-technology experts or new comers learn technology in comic or graphic novel reading form.