From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: require basic stuff from specific packages Date: Tue, 12 Jul 2016 18:58:02 -0700 (PDT) Message-ID: <8ae64b0e-1ff9-46ed-a9fa-38790f9ffa61@default> 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; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1468375227 24569 80.91.229.3 (13 Jul 2016 02:00:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 13 Jul 2016 02:00:27 +0000 (UTC) To: Howard Melman , 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:00:16 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 1bN9T8-00064w-8a for geh-help-gnu-emacs@m.gmane.org; Wed, 13 Jul 2016 04:00:10 +0200 Original-Received: from localhost ([::1]:44572 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bN9T7-0004Ma-I9 for geh-help-gnu-emacs@m.gmane.org; Tue, 12 Jul 2016 22:00:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bN9Sj-0004MU-Gn for help-gnu-emacs@gnu.org; Tue, 12 Jul 2016 21:59:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bN9Se-0004nC-Ii for help-gnu-emacs@gnu.org; Tue, 12 Jul 2016 21:59:44 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:24988) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bN9Se-00045z-AI for help-gnu-emacs@gnu.org; Tue, 12 Jul 2016 21:59:40 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u6D1w5Xs018346 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 13 Jul 2016 01:58:06 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u6D1w5t9024857 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 13 Jul 2016 01:58:05 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u6D1w347022281; Wed, 13 Jul 2016 01:58:04 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 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:110796 Archived-At: > > Yes, `string-trim' in in subr-x does it! > > How are you supposed to find it tho? >=20 > In this case it's particularly egregious because sub-x.el > isn't documented in the lisp manual or in any other manual. >=20 > Perhaps a page in the lisp manual describing these 11 > functions, saying these are potentially useful, would mean > that someone would find them, use them and then we'd be able > to deem them useful. 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.