From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.help Subject: Re: require basic stuff from specific packages Date: Wed, 13 Jul 2016 04:11:31 +0200 Organization: Aioe.org NNTP Server Message-ID: <86h9bui8x8.fsf@student.uu.se> References: <864m8671sy.fsf@student.uu.se> <86y45glxpy.fsf@student.uu.se> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1468376132 5718 80.91.229.3 (13 Jul 2016 02:15:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 13 Jul 2016 02:15:32 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Wed Jul 13 04:15:29 2016 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bN9hw-0005Vo-V9 for geh-help-gnu-emacs@m.gmane.org; Wed, 13 Jul 2016 04:15:29 +0200 Original-Received: from localhost ([::1]:44610 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bN9hw-0005Ld-8Q for geh-help-gnu-emacs@m.gmane.org; Tue, 12 Jul 2016 22:15:28 -0400 Original-Path: usenet.stanford.edu!goblin2!goblin.stu.neva.ru!aioe.org!.POSTED!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 43 Original-NNTP-Posting-Host: EoOtCC1fCYcttx6jjhWUlA.user.gioia.aioe.org Original-X-Complaints-To: abuse@aioe.org User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux) Cancel-Lock: sha1:LdIrEsnPHpH7uSKkzSSkM8CGIVg= Mail-Copies-To: never X-Notice: Filtered by postfilter v. 0.8.2 Original-Xref: usenet.stanford.edu gnu.emacs.help:218490 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:110799 Archived-At: Drew Adams writes: > Neither the Emacs manual nor the Elisp manual > documents all commands, let alone all > functions, that are useful. (And libraries > are typically not mentioned as such.) > > It's always a judgment call what to put in > a manual, but there will always be tons of > functions and variables that cannot (and in > most cases should not) be documented in > the manuals. > > This one is essentially a utility function. > If it were autoloaded then it would be > relatively easy to discover using completion: > `C-h f string TAB'. (And if you have a better > completion system you can also use `C-h > f trim TAB'.) > > If you think that a particular thing (e.g. > function) should be documented in the manual, > the way to get your voice heard is to file > a bug report (aka enhancement request): `M-x > report-emacs-bug'. Likewise, if you would > like to suggest that such a function > be autoloaded. I think it is probably better to focus on the methods and structure of the problem than on particular data items, but yes, one can do that, for sure. I agree a manual as in a text item isn't going to solve it, perhaps a SQL database (and a web interface) with every single Elisp function (name, argument list, docstring, and location) would be better... -- underground experts united .... http://user.it.uu.se/~embe8573 Emacs Gnus Blogomatic ......... http://user.it.uu.se/~embe8573/blogomatic - so far: 56 Blogomatic articles -