From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 22978 invoked by alias); 22 Feb 2020 19:57:56 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 22966 invoked by uid 89); 22 Feb 2020 19:57:55 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-7.7 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_HELO_PASS autolearn=ham version=3.3.1 spammy=viewport, crystal, There's X-HELO: gateway36.websitewelcome.com Received: from gateway36.websitewelcome.com (HELO gateway36.websitewelcome.com) (50.116.125.2) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 22 Feb 2020 19:57:53 +0000 Received: from cm10.websitewelcome.com (cm10.websitewelcome.com [100.42.49.4]) by gateway36.websitewelcome.com (Postfix) with ESMTP id 370DD400C5ED2 for ; Sat, 22 Feb 2020 13:12:29 -0600 (CST) Received: from box5379.bluehost.com ([162.241.216.53]) by cmsmtp with SMTP id 5auOjOlj1Efyq5auOjViNB; Sat, 22 Feb 2020 13:57:52 -0600 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tromey.com; s=default; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=gncPKPEKiG6VGu3cfCTXLBTxYW3uTFZNy0/Y54+oV9E=; b=nn2U4h/N2g1Um2kbPDtf6MabGg qVWo1u22GKvxNRyR/27NOujZcbS9RTotwTTvmpu4diDmfGgCgBJjTQGVMJ8O9vAdTIqDxwTm/e4R8 sMreFPGf9J3QS02tVKamcrLMB; Received: from 75-166-123-50.hlrn.qwest.net ([75.166.123.50]:57842 helo=bapiya) by box5379.bluehost.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92) (envelope-from ) id 1j5auO-000KGQ-Am; Sat, 22 Feb 2020 12:57:52 -0700 From: Tom Tromey To: Eli Zaretskii Cc: Tom Tromey , gdb-patches@sourceware.org Subject: Re: [PATCH 20/24] Allow TUI windows in Python References: <20200104183410.17114-1-tom@tromey.com> <20200104183410.17114-21-tom@tromey.com> <8336cvgid8.fsf@gnu.org> Date: Sat, 22 Feb 2020 19:57:00 -0000 In-Reply-To: <8336cvgid8.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 04 Jan 2020 20:57:07 +0200") Message-ID: <87h7zi5r9c.fsf@tromey.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-SW-Source: 2020-02/txt/msg00893.txt.bz2 >>>>> "Eli" == Eli Zaretskii writes: >> +terminal escape styling sequences; @value{GDBN} will convert translate >> +these as appropriate for the terminal. ^^^^^^^^^^^^^^^^^ Eli> One of these two words should be removed. Fixed. >> +@defun Window.hscroll (@var{num}) >> +This is a request to scroll the window horizontally. @var{num} is the >> +amount by which to scroll, with negative numbers meaning to scroll >> +right. >> +@end defun >> + >> +@defun Window.vscroll (@var{num}) >> +This is a request to scroll the window vertically. @var{num} is the >> +amount by which to scroll, with negative numbers meaning to scroll >> +backward. Eli> There's a well-known source of confusion with describing scrolling Eli> direction: does it refer to scrolling of the text in the window Eli> (i.e. the window is considered to be fixed and the text to be Eli> scrolled) or the other way around? The confusion stems from the fact Eli> that we say "scroll the window", but what is actually scrolled is the Eli> text. Can we please make it crystal clear here what will move right Eli> and backward here? I did this, like so: @defun Window.hscroll (@var{num}) This is a request to scroll the window horizontally. @var{num} is the amount by which to scroll, with negative numbers meaning to scroll right. In the TUI model, it is the viewport that moves, not the contents. A positive argument should cause the viewport to move right, and so the content should appear to move to the left. @end defun @defun Window.vscroll (@var{num}) This is a request to scroll the window vertically. @var{num} is the amount by which to scroll, with negative numbers meaning to scroll backward. In the TUI model, it is the viewport that moves, not the contents. A positive argument should cause the viewport to move down, and so the content should appear to move up. @end defun Tom