From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: tom.horsley@att.net (Thomas A. Horsley) Newsgroups: gmane.emacs.devel Subject: Re: minibuffer-prompt-end badly named Date: 13 Aug 2002 19:17:42 -0400 Sender: emacs-devel-admin@gnu.org Message-ID: References: <20020813013725.QILD11162.mtiwmhc22.worldnet.att.net@SPIKE.att.net> <200208132247.g7DMlC607271@wijiji.santafe.edu> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1029280634 4502 127.0.0.1 (13 Aug 2002 23:17:14 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 13 Aug 2002 23:17:14 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 17ekuX-0001AV-00 for ; Wed, 14 Aug 2002 01:17:13 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17elJG-0002EP-00 for ; Wed, 14 Aug 2002 01:42:46 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10) id 17ekvR-0003Ze-00; Tue, 13 Aug 2002 19:18:09 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10) id 17ekv8-0003XN-00 for emacs-devel@gnu.org; Tue, 13 Aug 2002 19:17:50 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10) id 17ekv3-0003WW-00 for emacs-devel@gnu.org; Tue, 13 Aug 2002 19:17:49 -0400 Original-Received: from mtiwmhc24.worldnet.att.net ([204.127.131.49] helo=mtiwmhc21.worldnet.att.net) by monty-python.gnu.org with esmtp (Exim 4.10) id 17ekv3-0003WA-00; Tue, 13 Aug 2002 19:17:45 -0400 Original-Received: from SPIKE.att.net ([24.54.160.28]) by mtiwmhc21.worldnet.att.net (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020813231744.RRWP8147.mtiwmhc21.worldnet.att.net@SPIKE.att.net>; Tue, 13 Aug 2002 23:17:44 +0000 Original-To: rms@gnu.org In-Reply-To: <200208132247.g7DMlC607271@wijiji.santafe.edu> Original-Lines: 30 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2 Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:6516 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:6516 >I will improve this area. > > The function minibuffer-prompt-end (and all the other related functions > added for emacs21) are very badly documented. > >Could you give me a precise list of the functions that you think >are badly documented? I could afford to look at specific functions >to try to improve their doc strings, but I'd rather not take the extra >time to hunt for the right functions. Upon further review, it may only be minibuffer-prompt-end that has the really screwy doc string. The other functions right next to it all say they must be used in the minibuffer, and in those cases, the rest of the doc string is correct. I'd still like a function that actually does what the current doc string for minibuffer-prompt-end claims to do :-). The best I've come up with so far is: (defun writable-point-min () "Return first writable position in current buffer." (let ( (rval (point-min)) ) (if (get-text-property rval 'read-only) (setq rval (next-single-property-change rval 'read-only)) ) rval ) ) -- >>==>> The *Best* political site >>==+ email: Tom.Horsley@worldnet.att.net icbm: Delray Beach, FL | Free Software and Politics <<==+