From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#68254: EWW =?UTF-8?Q?=E2=80=98readable=E2=80=99?= by default Date: Mon, 18 Mar 2024 14:37:54 +0200 Message-ID: <86ttl34swt.fsf@gnu.org> References: <83v888uhdn.fsf@gnu.org> <83frzbvr66.fsf@gnu.org> <6ee278b0-1511-cfd9-7695-7e019d879f7b@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25175"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 68254@debbugs.gnu.org, yvv0@proton.me To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Mar 18 13:38:47 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1rmCGM-0006Mj-GV for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 18 Mar 2024 13:38:46 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rmCG2-0002XG-U8; Mon, 18 Mar 2024 08:38:28 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rmCG0-0002Wp-2d for bug-gnu-emacs@gnu.org; Mon, 18 Mar 2024 08:38:25 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rmCFz-0002iZ-Kk for bug-gnu-emacs@gnu.org; Mon, 18 Mar 2024 08:38:23 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rmCGb-0002PA-LQ for bug-gnu-emacs@gnu.org; Mon, 18 Mar 2024 08:39:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Mar 2024 12:39:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68254 X-GNU-PR-Package: emacs Original-Received: via spool by 68254-submit@debbugs.gnu.org id=B68254.17107655399233 (code B ref 68254); Mon, 18 Mar 2024 12:39:01 +0000 Original-Received: (at 68254) by debbugs.gnu.org; 18 Mar 2024 12:38:59 +0000 Original-Received: from localhost ([127.0.0.1]:51031 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rmCGP-0002Oc-VW for submit@debbugs.gnu.org; Mon, 18 Mar 2024 08:38:59 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:37020) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rmCGK-0002OG-A7 for 68254@debbugs.gnu.org; Mon, 18 Mar 2024 08:38:48 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rmCFb-0002ff-Dy; Mon, 18 Mar 2024 08:37:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=8FaAemM36KckMupPOEQ5zV3zkiKu6moUbf8n4EHdRf4=; b=Y2HywC+wy+fk3qkR3JPW /RQeGkK0/qwa1GSkjc+Ik9aICNBP3VHAtK/tf95CoTWohWmwgF2vd0hL1/eWA21PPMfm/OGapq9+U jR+8Nj7DGFkEBi6OZfexC/rcVMdEBPFww8GVVBph/hSJkfaasbZgyURL4LbfBYIMkoocgICYvkh53 IztDnCrInAh2P5Re43YZqlY6/QMsHFP3Mwxd9G/sQUt1rdLl1vmlt1UL/Y6g+qb4Nuf13IEwMWPrM dZo85JI6wn+kOm46wekV4qivAZJOFQyFbytyxy4p8ESnkyyOvRuGZJNhRVfMsCC9DIhvxynZi/amI qMAouY3RHK+Umw==; In-Reply-To: <6ee278b0-1511-cfd9-7695-7e019d879f7b@gmail.com> (message from Jim Porter on Sun, 17 Mar 2024 12:24:26 -0700) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:281799 Archived-At: > Date: Sun, 17 Mar 2024 12:24:26 -0700 > Cc: 68254@debbugs.gnu.org > From: Jim Porter > > Here's a patch for this. It turns 'eww-readable' into a toggle (using > the same semantics as minor modes), and also adds an option to prevent > adding a new history entry for each call. Thanks. > +When called interactively, this command toggles the display of the > +readable parts. With a positive prefix argument, always display the > +readable parts, and with a zero or negative prefix, display the full > +page. The imperative form ("display") is what we use in the doc strings, but it is not really appropriate for the manual. Here we say "the function displays" or "it displays" instead, which is consistent with the first sentence in the above paragraph. > +(defun eww-readable (&optional arg) > + "Toggle display of only the main \"readable\" parts of the current web page. > This command uses heuristics to find the parts of the web page that > -contains the main textual portion, leaving out navigation menus and > -the like." > - (interactive nil eww-mode) > +contains the main textual portion, leaving out navigation menus and the "contain" (since it refers to "parts", in plural). > +If called interactively, toggle the display of the readable parts. If > +the prefix argument is positive, display the readable parts, and if it > +is zero or negative, display the full page. > + > +If called from Lisp, toggle the display of the readable parts if ARG is > +`toggle'. Display the readable parts if ARG is nil, omitted, or is a > +positive number. Display the full page if ARG is a negative number." This doc string should mention eww-readable-adds-to-history.