From unknown Fri Sep 05 18:57:49 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71247: PATCH for docstrings for preview Resent-From: Jeremy Bryant Original-Sender: "Debbugs-submit" Resent-CC: bug-auctex@gnu.org Resent-Date: Tue, 28 May 2024 17:58:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 71247 X-GNU-PR-Package: auctex X-GNU-PR-Keywords: To: 71247@debbugs.gnu.org X-Debbugs-Original-To: bug-auctex@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.171691906224313 (code B ref -1); Tue, 28 May 2024 17:58:01 +0000 Received: (at submit) by debbugs.gnu.org; 28 May 2024 17:57:42 +0000 Received: from localhost ([127.0.0.1]:49671 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC14v-0006K4-UW for submit@debbugs.gnu.org; Tue, 28 May 2024 13:57:42 -0400 Received: from lists.gnu.org ([209.51.188.17]:36178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC14t-0006Jt-8H for submit@debbugs.gnu.org; Tue, 28 May 2024 13:57:40 -0400 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 1sC14i-0005hI-Rj for bug-auctex@gnu.org; Tue, 28 May 2024 13:57:29 -0400 Received: from out-173.mta1.migadu.com ([95.215.58.173]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sC14f-0007H5-Uy for bug-auctex@gnu.org; Tue, 28 May 2024 13:57:28 -0400 X-Envelope-To: bug-auctex@gnu.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jeremybryant.net; s=key1; t=1716919043; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type; bh=sGSYl8GH+UuECOLL/HpXxRaI70629oUDO4SpmgBXSwY=; b=TE+HV+RdpJjrjtwBtp5rLoSVEDPiBu170ARIm8s24bcRAElPoqoirmkghYmXvwZVjWAeHL Dj1xxW+M69ornjVI4cEX/3o83F7a1T0V0/AIK2upvJnA8ikFD16mX1Vq63zNb8LEKp76qT Rn5AFWZBFmdoIzb9NDBVWR+v4Jnohly8g2IFFp2k291trlJZV2r5eONTgCkmT96ylwSqN1 PWQIw04TiSHzX/CqUWQcSQpKHUjnldQxgJRYMOQWvWOxkT57C8a6/ehcLfntKq0I74KZdw zmKR//fu5ZqonaVxalOTCPHu6AovJ+TPf4dO21JHYJk08ogSTNMgPZyIH1u9gA== X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. From: Jeremy Bryant Date: Tue, 28 May 2024 18:57:20 +0100 Message-ID: <875xuxlszj.fsf@jeremybryant.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Migadu-Flow: FLOW_OUT Received-SPF: pass client-ip=95.215.58.173; envelope-from=jb@jeremybryant.net; helo=out-173.mta1.migadu.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) --=-=-= Content-Type: text/plain Here is a patch for checkdoc fixes for preview.el --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Checkdoc-fixes-for-interactive-commands.patch >From f0195452b77298e2150f547b18ec913bad3c24a4 Mon Sep 17 00:00:00 2001 From: Jeremy Bryant Date: Tue, 28 May 2024 18:53:08 +0100 Subject: [PATCH] ; Checkdoc fixes for interactive commands * preview.el.in (preview-copy-region-as-mml): Add docstring. (preview-install-styles): Add arg in docstring, and add checkdoc fix for prompt. --- preview.el.in | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/preview.el.in b/preview.el.in index e8c2c695..9404bc94 100644 --- a/preview.el.in +++ b/preview.el.in @@ -2881,6 +2881,7 @@ using MML mode." (preview-regenerate ov)))) (defun preview-copy-region-as-mml (start end) + "Copy into kill ring an MML representation of region from START to END." (interactive "r") (when (catch 'badcolor (let (str lst dont-ask) @@ -3048,7 +3049,7 @@ changes get properly reflected in the environment." ;;;###autoload (defun preview-install-styles (dir &optional force-overwrite force-save) - "Installs the TeX style files into a permanent location. + "Install the TeX style files into a permanent location DIR. This must be in the TeX search path. If FORCE-OVERWRITE is greater than 1, files will get overwritten without query, if it is less than 1 or nil, the operation will fail. The default of 1 for interactive @@ -3077,7 +3078,7 @@ pp") (> force-overwrite 1)) (t force-overwrite)))) (if (cond ((eq force-save 1) - (y-or-n-p "Stop using non-installed styles permanently ")) + (y-or-n-p "Stop using non-installed styles permanently? ")) ((numberp force-save) (> force-save 1)) (t force-save)) -- 2.42.0 --=-=-=-- From unknown Fri Sep 05 18:57:49 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71247: PATCH for docstrings for preview Resent-From: Arash Esbati Original-Sender: "Debbugs-submit" Resent-CC: bug-auctex@gnu.org Resent-Date: Tue, 28 May 2024 19:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71247 X-GNU-PR-Package: auctex X-GNU-PR-Keywords: To: 71247@debbugs.gnu.org Cc: 71247-done@debbugs.gnu.org, Jeremy Bryant X-Debbugs-Original-To: Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX Received: via spool by submit@debbugs.gnu.org id=B.17169228751217 (code B ref -1); Tue, 28 May 2024 19:02:02 +0000 Received: (at submit) by debbugs.gnu.org; 28 May 2024 19:01:15 +0000 Received: from localhost ([127.0.0.1]:52558 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC24R-0000JZ-HD for submit@debbugs.gnu.org; Tue, 28 May 2024 15:01:15 -0400 Received: from lists.gnu.org ([209.51.188.17]:51702) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC24Q-0000JP-9l for submit@debbugs.gnu.org; Tue, 28 May 2024 15:01:14 -0400 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 1sC24G-0002z4-1M for bug-auctex@gnu.org; Tue, 28 May 2024 15:01:04 -0400 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 1sC24F-0007lU-LW; Tue, 28 May 2024 15:01:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=R20XeJm+8dO2inpd4cLHb45iqCLwO3PDP1ER9ZkjEm0=; b=X/NAYsMrdW8qbsrpR7Hv QZFCFvDJPl9TsOfPchbr2kRFcIfTZ3wnseJ5HXfo1vnirTwNQE9+gRpHfq4SKTEwnBHdhbxk+Jhpg N2E+Y4vI2YFxj1IHzhMT9V8kaaLyFp10iqe8tuU4pd6wnQ3zXsMLEq8rMkNldw3MFw8WPWtnVxw6H ttXWQXWLULMonNwXS5+6AYwnWQx4IDKvCoTv8ou8pIMiIjsktOf0NuQrP/QSTkRIMYd87Z4cQrjYk IV+cF+GPg+XCDDd/VycQi4vNSD+1BuQdbvNcwkYXGBI1JuGddQZQBgKl0fy7IuP935Px6O5h1mcp+ zeUxOzQf71N78Q==; From: Arash Esbati In-Reply-To: <875xuxlszj.fsf@jeremybryant.net> (Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX's message of "Tue, 28 May 2024 18:57:20 +0100") References: <875xuxlszj.fsf@jeremybryant.net> Date: Tue, 28 May 2024 21:00:42 +0200 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX writes: > Here is a patch for checkdoc fixes for preview.el Thanks, installed, and closing. Best, Arash From unknown Fri Sep 05 18:57:49 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Jeremy Bryant Subject: bug#71247: closed (Re: bug#71247: PATCH for docstrings for preview) Message-ID: References: <875xuxlszj.fsf@jeremybryant.net> X-Gnu-PR-Message: they-closed 71247 X-Gnu-PR-Package: auctex Reply-To: 71247@debbugs.gnu.org Date: Tue, 28 May 2024 19:02:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1716922923-1368-1" This is a multi-part message in MIME format... ------------=_1716922923-1368-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #71247: PATCH for docstrings for preview which was filed against the auctex package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 71247@debbugs.gnu.org. --=20 71247: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D71247 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1716922923-1368-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 71247-done) by debbugs.gnu.org; 28 May 2024 19:01:21 +0000 Received: from localhost ([127.0.0.1]:52566 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC24W-0000Jv-Pc for submit@debbugs.gnu.org; Tue, 28 May 2024 15:01:21 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC24U-0000JM-GA for 71247-done@debbugs.gnu.org; Tue, 28 May 2024 15:01:18 -0400 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 1sC24F-0007lU-LW; Tue, 28 May 2024 15:01:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=R20XeJm+8dO2inpd4cLHb45iqCLwO3PDP1ER9ZkjEm0=; b=X/NAYsMrdW8qbsrpR7Hv QZFCFvDJPl9TsOfPchbr2kRFcIfTZ3wnseJ5HXfo1vnirTwNQE9+gRpHfq4SKTEwnBHdhbxk+Jhpg N2E+Y4vI2YFxj1IHzhMT9V8kaaLyFp10iqe8tuU4pd6wnQ3zXsMLEq8rMkNldw3MFw8WPWtnVxw6H ttXWQXWLULMonNwXS5+6AYwnWQx4IDKvCoTv8ou8pIMiIjsktOf0NuQrP/QSTkRIMYd87Z4cQrjYk IV+cF+GPg+XCDDd/VycQi4vNSD+1BuQdbvNcwkYXGBI1JuGddQZQBgKl0fy7IuP935Px6O5h1mcp+ zeUxOzQf71N78Q==; From: Arash Esbati To: Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX Subject: Re: bug#71247: PATCH for docstrings for preview In-Reply-To: <875xuxlszj.fsf@jeremybryant.net> (Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX's message of "Tue, 28 May 2024 18:57:20 +0100") References: <875xuxlszj.fsf@jeremybryant.net> Date: Tue, 28 May 2024 21:00:42 +0200 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71247-done Cc: 71247-done@debbugs.gnu.org, Jeremy Bryant X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Jeremy Bryant via bug-auctex via Bug reporting list for AUCTeX writes: > Here is a patch for checkdoc fixes for preview.el Thanks, installed, and closing. Best, Arash ------------=_1716922923-1368-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 28 May 2024 17:57:42 +0000 Received: from localhost ([127.0.0.1]:49671 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC14v-0006K4-UW for submit@debbugs.gnu.org; Tue, 28 May 2024 13:57:42 -0400 Received: from lists.gnu.org ([209.51.188.17]:36178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sC14t-0006Jt-8H for submit@debbugs.gnu.org; Tue, 28 May 2024 13:57:40 -0400 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 1sC14i-0005hI-Rj for bug-auctex@gnu.org; Tue, 28 May 2024 13:57:29 -0400 Received: from out-173.mta1.migadu.com ([95.215.58.173]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sC14f-0007H5-Uy for bug-auctex@gnu.org; Tue, 28 May 2024 13:57:28 -0400 X-Envelope-To: bug-auctex@gnu.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jeremybryant.net; s=key1; t=1716919043; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type; bh=sGSYl8GH+UuECOLL/HpXxRaI70629oUDO4SpmgBXSwY=; b=TE+HV+RdpJjrjtwBtp5rLoSVEDPiBu170ARIm8s24bcRAElPoqoirmkghYmXvwZVjWAeHL Dj1xxW+M69ornjVI4cEX/3o83F7a1T0V0/AIK2upvJnA8ikFD16mX1Vq63zNb8LEKp76qT Rn5AFWZBFmdoIzb9NDBVWR+v4Jnohly8g2IFFp2k291trlJZV2r5eONTgCkmT96ylwSqN1 PWQIw04TiSHzX/CqUWQcSQpKHUjnldQxgJRYMOQWvWOxkT57C8a6/ehcLfntKq0I74KZdw zmKR//fu5ZqonaVxalOTCPHu6AovJ+TPf4dO21JHYJk08ogSTNMgPZyIH1u9gA== X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. From: Jeremy Bryant To: bug-auctex@gnu.org Subject: PATCH for docstrings for preview Date: Tue, 28 May 2024 18:57:20 +0100 Message-ID: <875xuxlszj.fsf@jeremybryant.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Migadu-Flow: FLOW_OUT Received-SPF: pass client-ip=95.215.58.173; envelope-from=jb@jeremybryant.net; helo=out-173.mta1.migadu.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) --=-=-= Content-Type: text/plain Here is a patch for checkdoc fixes for preview.el --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Checkdoc-fixes-for-interactive-commands.patch >From f0195452b77298e2150f547b18ec913bad3c24a4 Mon Sep 17 00:00:00 2001 From: Jeremy Bryant Date: Tue, 28 May 2024 18:53:08 +0100 Subject: [PATCH] ; Checkdoc fixes for interactive commands * preview.el.in (preview-copy-region-as-mml): Add docstring. (preview-install-styles): Add arg in docstring, and add checkdoc fix for prompt. --- preview.el.in | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/preview.el.in b/preview.el.in index e8c2c695..9404bc94 100644 --- a/preview.el.in +++ b/preview.el.in @@ -2881,6 +2881,7 @@ using MML mode." (preview-regenerate ov)))) (defun preview-copy-region-as-mml (start end) + "Copy into kill ring an MML representation of region from START to END." (interactive "r") (when (catch 'badcolor (let (str lst dont-ask) @@ -3048,7 +3049,7 @@ changes get properly reflected in the environment." ;;;###autoload (defun preview-install-styles (dir &optional force-overwrite force-save) - "Installs the TeX style files into a permanent location. + "Install the TeX style files into a permanent location DIR. This must be in the TeX search path. If FORCE-OVERWRITE is greater than 1, files will get overwritten without query, if it is less than 1 or nil, the operation will fail. The default of 1 for interactive @@ -3077,7 +3078,7 @@ pp") (> force-overwrite 1)) (t force-overwrite)))) (if (cond ((eq force-save 1) - (y-or-n-p "Stop using non-installed styles permanently ")) + (y-or-n-p "Stop using non-installed styles permanently? ")) ((numberp force-save) (> force-save 1)) (t force-save)) -- 2.42.0 --=-=-=-- ------------=_1716922923-1368-1--