From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.help Subject: Re: Getting functions usage examples [Was: Re: Knowing where a function has been used (e.g. for optimizing) [Was: Re: Optimising Elisp code]] Date: Sun, 07 Oct 2018 17:38:47 +0200 Organization: Aioe.org NNTP Server Message-ID: <867eitydfc.fsf@zoho.com> References: <638fb7dc-6fc5-4645-8793-97a00038a3a8@googlegroups.com> <86tvlyx71z.fsf@zoho.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1538926705 20362 195.159.176.226 (7 Oct 2018 15:38:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 7 Oct 2018 15:38:25 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun Oct 07 17:38:21 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 1g9B8M-00059A-Ge for geh-help-gnu-emacs@m.gmane.org; Sun, 07 Oct 2018 17:38:18 +0200 Original-Received: from localhost ([::1]:42739 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9BAS-0004H2-N2 for geh-help-gnu-emacs@m.gmane.org; Sun, 07 Oct 2018 11:40:28 -0400 X-Received: by 2002:a1c:f213:: with SMTP id s19-v6mr1964418wmc.23.1538926728309; Sun, 07 Oct 2018 08:38:48 -0700 (PDT) Original-Path: usenet.stanford.edu!q200-v6no4447597wmd.0!news-out.google.com!z184-v6ni15926wmz.0!nntp.google.com!feeder1-2.proxad.net!proxad.net!feeder1-1.proxad.net!ecngs!feeder2.ecngs.de!78.46.240.70.MISMATCH!weretis.net!feeder4.news.weretis.net!news.mixmin.net!aioe.org!.POSTED!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 17 Original-NNTP-Posting-Host: xQsFb8j6c/kdg9AvIrnVFA.user.gioia.aioe.org Original-X-Complaints-To: abuse@aioe.org Mail-Copies-To: never X-Notice: Filtered by postfilter v. 0.8.3 Cancel-Lock: sha1:ZceOu/biGQWd6V5ihd1zLK1Vo4U= Original-Xref: usenet.stanford.edu gnu.emacs.help:224056 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:118182 Archived-At: Garreau, Alexandre wrote: > as not everybody needs examples, and ideally > we should just keep using only definitions, > nobody (we hope) will waste a lot of precious > time putting 2-3 call examples in the > docstrings I was speaking broadly, not about Elisp docstrings. Like computer books. Learn to do it all in 21 days. A friend once asked if you really could learn it all in 21 days. I said, "yes, if you already know it." -- underground experts united http://user.it.uu.se/~embe8573