From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: David PONCE Newsgroups: gmane.emacs.devel Subject: Re: windows.texi doc fix Date: Thu, 21 Oct 2004 12:31:00 +0200 (CEST) Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <29461185.1098354660491.JavaMail.www@wwinf0203> Reply-To: david.ponce@wanadoo.fr NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1098354727 2543 80.91.229.6 (21 Oct 2004 10:32:07 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 21 Oct 2004 10:32:07 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Oct 21 12:31:52 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CKaEa-0002Oj-00 for ; Thu, 21 Oct 2004 12:31:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CKaM0-00013c-Tj for ged-emacs-devel@m.gmane.org; Thu, 21 Oct 2004 06:39:33 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CKaLM-00012Z-UG for emacs-devel@gnu.org; Thu, 21 Oct 2004 06:38:53 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CKaLL-000116-RP for emacs-devel@gnu.org; Thu, 21 Oct 2004 06:38:52 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CKaLK-000110-HQ for emacs-devel@gnu.org; Thu, 21 Oct 2004 06:38:51 -0400 Original-Received: from [193.252.22.29] (helo=mwinf0201.wanadoo.fr) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CKaDm-0001Jo-7c; Thu, 21 Oct 2004 06:31:02 -0400 Original-Received: from me-wanadoo.net (localhost [127.0.0.1]) by mwinf0201.wanadoo.fr (SMTP Server) with SMTP id 8570E300043D; Thu, 21 Oct 2004 12:31:00 +0200 (CEST) Original-Received: from wwinf0203 (wwinf0203 [172.22.133.30]) by mwinf0201.wanadoo.fr (SMTP Server) with ESMTP id 7DA2A300040D; Thu, 21 Oct 2004 12:31:00 +0200 (CEST) Original-To: rms@gnu.org X-Originating-IP: [195.75.25.231] X-WUM-FROM: |~| X-WUM-TO: |~| X-WUM-CC: |~| X-WUM-REPLYTO: |~| X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:28692 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28692 > It is good to notice that this needed to be fixed, but the style that > we use in doc strings is too terse and not correct enough for the > manual. The former uses incomplete sentences, such as this: > > + Optional third arg @var{preserve-before}, if non-@code{nil}, means > > Could you please try rewriting this text using the style that we use > for such cases elsewhere in the manual? Please just try your best--I > can polish it up after you install it. OK. WDYT of this version, which is much simpler. As the documentation explicitly says that `shrink-window' is like `enlarge-window' but negates the size argument, I didn't duplicated the description of `preserve-before'. David *** windows.texi.orig 2004-07-24 17:33:15.000000000 +0200 --- windows.texi 2004-10-21 12:32:38.681402600 +0200 *************** *** 1922,1928 **** window size. Emacs does not permit overlapping windows or gaps between windows, so resizing one window affects other windows. ! @deffn Command enlarge-window size &optional horizontal This function makes the selected window @var{size} lines taller, stealing lines from neighboring windows. It takes the lines from one window at a time until that window is used up, then takes from another. --- 1922,1928 ---- window size. Emacs does not permit overlapping windows or gaps between windows, so resizing one window affects other windows. ! @deffn Command enlarge-window size &optional horizontal preserve-before This function makes the selected window @var{size} lines taller, stealing lines from neighboring windows. It takes the lines from one window at a time until that window is used up, then takes from another. *************** *** 1945,1950 **** --- 1945,1955 ---- size of a fixed-size window, @code{enlarge-window} gets an error instead. + If @var{preserve-before} is non-@code{nil}, this function does not + changes the size of the siblings above or to the left of the selected + window. Only the size of the siblings below or to the right of the + selected window are changed. + If @var{size} is negative, this function shrinks the window by @minus{}@var{size} lines or columns. If that makes the window smaller than the minimum size (@code{window-min-height} and *************** *** 1965,1971 **** @end example @end deffn ! @deffn Command shrink-window size &optional horizontal This function is like @code{enlarge-window} but negates the argument @var{size}, making the selected window smaller by giving lines (or columns) to the other windows. If the window shrinks below --- 1970,1976 ---- @end example @end deffn ! @deffn Command shrink-window size &optional horizontal preserve-before This function is like @code{enlarge-window} but negates the argument @var{size}, making the selected window smaller by giving lines (or columns) to the other windows. If the window shrinks below