From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 19 19:13:40 2020 Received: (at submit) by debbugs.gnu.org; 20 Nov 2020 00:13:40 +0000 Received: from localhost ([127.0.0.1]:41340 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kfu3X-0004bz-MQ for submit@debbugs.gnu.org; Thu, 19 Nov 2020 19:13:40 -0500 Received: from lists.gnu.org ([209.51.188.17]:59008) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kfpzT-0002XG-K9 for submit@debbugs.gnu.org; Thu, 19 Nov 2020 14:53:11 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:50110) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kfpzR-0007FG-7N for bug-auctex@gnu.org; Thu, 19 Nov 2020 14:53:11 -0500 Received: from exoco.falsifian.org ([168.235.109.198]:28261) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kfpz9-00015e-Jd for bug-auctex@gnu.org; Thu, 19 Nov 2020 14:53:08 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=2020-07-31; bh=3IMQmNZWU Nn9jqy0dlFTQgnjS6csPAV3tjONS2GCJuk=; h=subject:to:from:date; d=falsifian.org; b=qhPS+YMpc3DS36BAAqL1CoRrsTyokZX3P1IMAiEyHlf9azfnRXo RH8/S0Ne2hGcebomM+hK5uf6tq44xxlP67mcp4AzhHLjzqAWy+nvfxane53FY8iD6XQj0q Fq2LbcRRCpKryLwG0Vepo3tJsuDIQbPAak+LYwXOQ/QFCGaLLA2Nr/I7LzTOgEzsn3peLp nFI+dgAk+MO3mnFy1T05RcEX3qIYRbJuC94WrAAAVgeUtW3VQegwr0owGhuifM2AcD5W2R gra9r8kYZGmcfZDMUTdgFYcgPjJtqqVSvgoPsaYEXYBuUsvalUGxjxJcRueNny5DGE7D3G iiFkocAURqw== Received: from angel.falsifian.org (cpef81d0f9cb2f3-cmf81d0f9cb2f0.cpe.net.fido.ca [72.140.58.252]) by exoco.falsifian.org (OpenSMTPD) with ESMTPSA id 4e8c5b5d (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO) for ; Thu, 19 Nov 2020 19:52:45 +0000 (UTC) Received: from localhost (angel.falsifian.org [local]) by angel.falsifian.org (OpenSMTPD) with ESMTPA id a6262633 for ; Thu, 19 Nov 2020 19:52:44 +0000 (UTC) Date: Thu, 19 Nov 2020 19:52:44 +0000 From: James Cook To: bug-auctex@gnu.org Subject: 12.2.4; Incomplete documentation for TeX-view-program-list Message-ID: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Received-SPF: pass client-ip=168.235.109.198; envelope-from=falsifian@falsifian.org; helo=exoco.falsifian.org 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, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, UNPARSEABLE_RELAY=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Thu, 19 Nov 2020 19:13:37 -0500 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 (--) I wanted to add mupdf TeX-view-program-list, but the documentation (appearing in customize-variable for example) was missing one crucial piece of information: how I should actually format the command. I eventually figured out it needs to be "mupdf %o". Either %o should be documented right there, or there should be a link to a place where it and other substitutions are documented. (I'm sure they are somewhere; I just have no idea where to start looking.) Emacs : GNU Emacs 27.1 (build 1, x86_64-unknown-openbsd, GTK+ Version 3.24.23) of 2020-10-31 Package: 12.2.4 current state: ============== (setq AUCTeX-date "2020-06-29" window-system 'x LaTeX-version "2e" TeX-style-path '("~/.emacs.d/auctex" "/home/falsifian/.emacs.d/elpa/auctex-12.2.4/style" "/home/falsifian/.emacs.d/auctex/auto" "/home/falsifian/.emacs.d/auctex/style" "auto" "style") TeX-auto-save nil TeX-parse-self nil TeX-master 'shared TeX-command-list '(("TeX" "%(PDF)%(tex) %(file-line-error) %`%(extraopts) %S%(PDFout)%(mode)%' %t" TeX-run-TeX nil (plain-tex-mode ams-tex-mode texinfo-mode) :help "Run plain TeX") ("LaTeX" "%`%l%(mode)%' %T" TeX-run-TeX nil (latex-mode doctex-mode) :help "Run LaTeX") ("Makeinfo" "makeinfo %(extraopts) %t" TeX-run-compile nil (texinfo-mode) :help "Run Makeinfo with Info output") ("Makeinfo HTML" "makeinfo %(extraopts) --html %t" TeX-run-compile nil (texinfo-mode) :help "Run Makeinfo with HTML output") ("AmSTeX" "amstex %(PDFout) %`%(extraopts) %S%(mode)%' %t" TeX-run-TeX nil (ams-tex-mode) :help "Run AMSTeX") ("ConTeXt" "%(cntxcom) --once --texutil %(extraopts) %(execopts)%t" TeX-run-TeX nil (context-mode) :help "Run ConTeXt once") ("ConTeXt Full" "%(cntxcom) %(extraopts) %(execopts)%t" TeX-run-TeX nil (context-mode) :help "Run ConTeXt until completion") ("BibTeX" "bibtex %s" TeX-run-BibTeX nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode context-mode) :help "Run BibTeX") ("Biber" "biber %s" TeX-run-Biber nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run Biber") ("View" "%V" TeX-run-discard-or-function t t :help "Run Viewer") ("Print" "%p" TeX-run-command t t :help "Print the file") ("Queue" "%q" TeX-run-background nil t :help "View the printer queue" :visible TeX-queue-command) ("File" "%(o?)dvips %d -o %f " TeX-run-dvips t (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Generate PostScript file") ("Dvips" "%(o?)dvips %d -o %f " TeX-run-dvips nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Convert DVI file to PostScript") ("Dvipdfmx" "dvipdfmx %d" TeX-run-dvipdfmx nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Convert DVI file to PDF with dvipdfmx") ("Ps2pdf" "ps2pdf %f" TeX-run-ps2pdf nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Convert PostScript file to PDF") ("Glossaries" "makeglossaries %s" TeX-run-command nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run makeglossaries to create glossary\n file") ("Index" "makeindex %s" TeX-run-index nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run makeindex to create index file") ("upMendex" "upmendex %s" TeX-run-index t (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run upmendex to create index file") ("Xindy" "texindy %s" TeX-run-command nil (plain-tex-mode latex-mode doctex-mode ams-tex-mode texinfo-mode) :help "Run xindy to create index file") ("Check" "lacheck %s" TeX-run-compile nil (latex-mode) :help "Check LaTeX file for correctness") ("ChkTeX" "chktex -v6 %s" TeX-run-compile nil (latex-mode) :help "Check LaTeX file for common mistakes") ("Spell" "(TeX-ispell-document \"\")" TeX-run-function nil t :help "Spell-check the document") ("Clean" "TeX-clean" TeX-run-function nil t :help "Delete generated intermediate files") ("Clean All" "(TeX-clean t)" TeX-run-function nil t :help "Delete generated intermediate and output files") ("Other" "" TeX-run-command t t :help "Run an arbitrary command")) ) From debbugs-submit-bounces@debbugs.gnu.org Fri Nov 20 08:24:10 2020 Received: (at 44744) by debbugs.gnu.org; 20 Nov 2020 13:24:10 +0000 Received: from localhost ([127.0.0.1]:42263 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kg6OX-0003BA-VK for submit@debbugs.gnu.org; Fri, 20 Nov 2020 08:24:10 -0500 Received: from eggs.gnu.org ([209.51.188.92]:32840) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kg6OT-0003Ae-9k for 44744@debbugs.gnu.org; Fri, 20 Nov 2020 08:24:08 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:59668) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kg6ON-0006JD-0c; Fri, 20 Nov 2020 08:23:59 -0500 Received: from pd9fb7cc0.dip0.t-ipconnect.de ([217.251.124.192]:49480 helo=MUTANT) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.82) (envelope-from ) id 1kg6OL-0003hl-ST; Fri, 20 Nov 2020 08:23:58 -0500 From: Arash Esbati To: James Cook Subject: Re: bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list References: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> Date: Fri, 20 Nov 2020 14:20:35 +0100 In-Reply-To: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> (James Cook's message of "Thu, 19 Nov 2020 19:52:44 +0000") Message-ID: <86pn48mafw.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 44744 Cc: 44744@debbugs.gnu.org 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 (---) Hi James, James Cook writes: > I wanted to add mupdf TeX-view-program-list, but the documentation > (appearing in customize-variable for example) was missing one crucial > piece of information: how I should actually format the command. Admittedly, there are no examples in the docstring, but ... ,----[ C-h v TeX-view-program-list RET ] | TeX-view-program-list is a variable defined in =E2=80=98tex.el=E2=80=99. | Its value is nil |=20 | You can customize this variable. |=20 | Documentation: | List of viewer specifications. | This variable can be used to specify how a viewer is to be | invoked and thereby add new viewers on top of the built-in list | of viewers defined in =E2=80=98TeX-view-program-list-builtin=E2=80=99 or = override | entries in the latter. This is a link where you can find examples for built-in viewers. > I eventually figured out it needs to be "mupdf %o". Either %o should > be documented right there, or there should be a link to a place where > it and other substitutions are documented. (I'm sure they are > somewhere; I just have no idea where to start looking.) | Note that the command line can contain placeholders as defined in | =E2=80=98TeX-expand-list=E2=80=99 which are expanded before the viewer is= called. The placeholders (%o and such) are again linked to `TeX-expand-list' which then redirects you to `TeX-expand-list-builtin'. What would you suggest in order to make the docstring more clear? Best, Arash From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 22 01:25:55 2020 Received: (at 44744) by debbugs.gnu.org; 22 Nov 2020 06:25:56 +0000 Received: from localhost ([127.0.0.1]:46883 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kgior-0002GZ-Ul for submit@debbugs.gnu.org; Sun, 22 Nov 2020 01:25:55 -0500 Received: from exoco.falsifian.org ([168.235.109.198]:3050) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kggKK-0006ol-Fy for 44744@debbugs.gnu.org; Sat, 21 Nov 2020 22:46:13 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=2020-07-31; bh=H2Os/5Bl0 eGoTLHP3CZO1OvtZUsdmo8WUGxbDuwK0+o=; h=in-reply-to:references:subject: cc:to:from:date; d=falsifian.org; b=IsSdG102VM7hQwT9XWyx9HZpZQqJga5tGm HCqbpA6nLWPq76W4fJq7g8pM5EqGzLxyl5XFa3k3tBwiW+gfHGXUstW48qkh5ICz1Mgogr AsVyVCfdvaFKbe9WhzO07KsSbupFNxFx+q9ffIQvslYTQ6TWT7vkMztGAQmS1ONsFHUe7G YDMbMmIToIRhQt7XNQ2ILkgTY5mo9AWO6dM6QNGuQmbr/hovN7xi9G10S0IvdJJ67WSWjc BlkQb4/DaL9KBRV2+lLc0aureJrY0uOdaLNX0IccTAm0xE07EgG3rfUiMCzoazwXHZEbIh pAlZs41ZJm6C+08YjxQ7M5qYWnxw== Received: from angel.falsifian.org (cpef81d0f9cb2f3-cmf81d0f9cb2f0.cpe.net.fido.ca [72.140.58.252]) by exoco.falsifian.org (OpenSMTPD) with ESMTPSA id 71a0153c (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Sun, 22 Nov 2020 03:46:11 +0000 (UTC) Received: from localhost (angel.falsifian.org [local]) by angel.falsifian.org (OpenSMTPD) with ESMTPA id 1270da57; Sun, 22 Nov 2020 03:46:10 +0000 (UTC) Date: Sun, 22 Nov 2020 03:46:10 +0000 From: James Cook To: Arash Esbati Subject: Re: bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list Message-ID: <20201122034610.obsjwqcdgahp4v7e@angel.falsifian.org> References: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> <86pn48mafw.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <86pn48mafw.fsf@gnu.org> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 44744 X-Mailman-Approved-At: Sun, 22 Nov 2020 01:25:53 -0500 Cc: 44744@debbugs.gnu.org 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: -1.0 (-) On Fri, Nov 20, 2020 at 02:20:35PM +0100, Arash Esbati wrote: > Hi James, > > James Cook writes: > > > I wanted to add mupdf TeX-view-program-list, but the documentation > > (appearing in customize-variable for example) was missing one crucial > > piece of information: how I should actually format the command. > > Admittedly, there are no examples in the docstring, but ... > > ,----[ C-h v TeX-view-program-list RET ] > | TeX-view-program-list is a variable defined in ‘tex.el’. > | Its value is nil > | > | You can customize this variable. > | > | Documentation: > | List of viewer specifications. > | This variable can be used to specify how a viewer is to be > | invoked and thereby add new viewers on top of the built-in list > | of viewers defined in ‘TeX-view-program-list-builtin’ or override > | entries in the latter. > > This is a link where you can find examples for built-in viewers. I did find the examples, but was looking for an explicit description. > > I eventually figured out it needs to be "mupdf %o". Either %o should > > be documented right there, or there should be a link to a place where > > it and other substitutions are documented. (I'm sure they are > > somewhere; I just have no idea where to start looking.) > > | Note that the command line can contain placeholders as defined in > | ‘TeX-expand-list’ which are expanded before the viewer is called. > > The placeholders (%o and such) are again linked to `TeX-expand-list' > which then redirects you to `TeX-expand-list-builtin'. > > What would you suggest in order to make the docstring more clear? > > Best, Arash Oops, I missed the reference to TeX-expand-list. Thanks for your response. It might help to mention the existence of placeholders more prominently. E.g. by inserting this sentence: Placeholders in the strings are expanded as defined in `TeX-expand-list`. immediately after the sentence The command line can either be specified as a single string or a list of strings and two-part lists. Adding an example would also help. Below is a more radical attempt to rewrite it to (a) include some structure to help the reader jump to the information they're looking for and (b) include an example. I'm sure it has deficiencies compared to the current documentation but maybe you can use part of it. --- (First paragraph same as before.) Each item is a list with two or three elements: (NAME RUN REQUIRED_EXECUTABLE) or (NAME RUN) The elements are explained in more detail below. For example, ("MuPDF" "mupdf %o" "mupdf") adds an entry "MuPDF" assuming 'TeX-expand-list' expands %o to the name of the file to be opened. NAME is a user-readable name. RUN specifies how to run the viewer, and can be a command line to be run as a process or a Lisp function to be executed. The command line can either be specified as a single string or a list of strings and two-part lists. The first element of the two-part lists is a symbol or a list of symbols referring to one or more of the predicates in ‘TeX-view-predicate-list’ or ‘TeX-view-predicate-list-builtin’. The second part of the two-part lists is a command line part. The command line for the viewer is constructed by concatenating the command line parts. Parts with a predicate are only considered if the predicate was evaluated with a positive result. The command line can contain placeholders as defined in ‘TeX-expand-list’ which are expanded before the viewer is called. REQUIRED_EXECUTABLE is optional and specifies the name of the executable, or executables, needed to open the file in the viewer. It should be a string or list of strings. Placeholders defined in ‘TeX-expand-list’ can be used here. This element is used to check whether the viewer is actually available on the system. -- James From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 24 02:16:17 2024 Received: (at 44744) by debbugs.gnu.org; 24 Aug 2024 06:16:17 +0000 Received: from localhost ([127.0.0.1]:40289 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1shk4P-00035J-1t for submit@debbugs.gnu.org; Sat, 24 Aug 2024 02:16:17 -0400 Received: from eggs.gnu.org ([209.51.188.92]:48668) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1shk4N-000357-RV for 44744@debbugs.gnu.org; Sat, 24 Aug 2024 02:16:16 -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 1shk3U-0004ie-Eo; Sat, 24 Aug 2024 02:15:21 -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=m6q6olVEv3JTirxiOGbreOfT52/HD+Sj8L61rOaN3sc=; b=EBaKXI4nLtp9DwrbdSOQ jCnMCK0+WuzivsJE7gJfJmBHBfFbhE/NDSY4bzdX9cYq5uSNPWbVqpzg+felufYXSnoXVcUVkAk8x n4Z3Pe29WRYSyJ5Cw0CEAYi0yRYpWtDra9eN5UIhYOLETsIz4QxkAgUMM+fZJ1CmhoUspnBe1eA91 cgjMjYT6/gP+TuWfvPQQDNuA09wkYZXc42HBaIDnk5S9r0NI4W+jrU2+hVPW2gIp9unFmO1RiSaez 1CAl8z5J5HLMrSlVeX4pozvZpqL7oTB0adUQKu//6Ak2+7TJkvsQfcrF3dVnSruZbTWsltybfoZft nwFKbuys39Gu8Q==; From: Arash Esbati To: James Cook Subject: Re: bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list In-Reply-To: <20201122034610.obsjwqcdgahp4v7e@angel.falsifian.org> (James Cook's message of "Sun, 22 Nov 2020 03:46:10 +0000") References: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> <86pn48mafw.fsf@gnu.org> <20201122034610.obsjwqcdgahp4v7e@angel.falsifian.org> Date: Sat, 24 Aug 2024 08:15:08 +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: 44744 Cc: 44744@debbugs.gnu.org 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 (---) Hi James, James Cook writes: > Oops, I missed the reference to TeX-expand-list. Thanks for your > response. > > It might help to mention the existence of placeholders more > prominently. E.g. by inserting this sentence: > > Placeholders in the strings are expanded as defined in > `TeX-expand-list`. > > immediately after the sentence > > The command line can either be specified as a single string or a list > of strings and two-part lists. > > Adding an example would also help. this report went lost in action, sorry for that. I'd like to propose this change in order to fix and close this issue; the patch is more complicated to read because of the re-filling, but I hope you get the point. As a note, I'm not sure if an example in the docstring makes things more clear, therefore I add a reference to `TeX-view-program-list-builtin' for examples: --8<---------------cut here---------------start------------->8--- diff --git a/tex.el b/tex.el index ea688f17..503072a5 100644 --- a/tex.el +++ b/tex.el @@ -1376,38 +1376,37 @@ description of the data format.") (defcustom TeX-view-program-list nil "List of viewer specifications. -This variable can be used to specify how a viewer is to be -invoked and thereby add new viewers on top of the built-in list -of viewers defined in `TeX-view-program-list-builtin' or override -entries in the latter. - -The car of each item is a string with a user-readable name. The -second element can be a command line to be run as a process or a -Lisp function to be executed. The command line can either be -specified as a single string or a list of strings and two-part -lists. The first element of the two-part lists is a symbol or a -list of symbols referring to one or more of the predicates in -`TeX-view-predicate-list' or `TeX-view-predicate-list-builtin'. -The second part of the two-part lists is a command line part. -The command line for the viewer is constructed by concatenating -the command line parts. Parts with a predicate are only -considered if the predicate was evaluated with a positive result. -Note that the command line can contain placeholders as defined in -`TeX-expand-list' which are expanded before the viewer is called. -The third element of the item is optional and is a string, or a -list of strings, with the name of the executable, or executables, -needed to open the output file in the viewer. Placeholders -defined in `TeX-expand-list' can be used here. This element is -used to check whether the viewer is actually available on the -system. - -The use of a function as the second element only works if the -View command in `TeX-command-list' makes use of the hook +This variable can be used to specify how a viewer is to be invoked and +thereby add new viewers on top of the built-in list of viewers defined +in `TeX-view-program-list-builtin' or override entries in the latter +which also serves as an example for usage. + +The car of each item is a string with a user-readable name. The second +element can be a command line to be run as a process or a Lisp function +to be executed. The command line can either be specified as a single +string or a list of strings and two-part lists. The first element of +the two-part lists is a symbol or a list of symbols referring to one or +more of the predicates in `TeX-view-predicate-list' or +`TeX-view-predicate-list-builtin'. The second part of the two-part +lists is a command line part. The command line for the viewer is +constructed by concatenating the command line parts. Parts with a +predicate are only considered if the predicate was evaluated with a +positive result. Note that the command line can contain placeholders as +defined in the variable `TeX-expand-list' or in +`TeX-expand-list-builtin' which are expanded before the viewer is +called. The third element of the item is optional and is a string, or a +list of strings, with the name of the executable, or executables, needed +to open the output file in the viewer. Placeholders defined in the +variable `TeX-expand-list' or in `TeX-expand-list-builtin' can be used +here. This element is used to check whether the viewer is actually +available on the system. + +The use of a function as the second element only works if the View +command in `TeX-command-list' makes use of the hook `TeX-run-discard-or-function'. -Note: Predicates defined in the current Emacs session will only -show up in the customization interface for this variable after -restarting Emacs." +Note: Predicates defined in the current Emacs session will only show up +in the customization interface for this variable after restarting Emacs." :group 'TeX-view :type `(repeat --8<---------------cut here---------------end--------------->8--- Any comments welcome. Best, Arash From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 30 04:49:46 2024 Received: (at 44744-done) by debbugs.gnu.org; 30 Aug 2024 08:49:46 +0000 Received: from localhost ([127.0.0.1]:52495 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sjxKE-0005Ds-Hj for submit@debbugs.gnu.org; Fri, 30 Aug 2024 04:49:46 -0400 Received: from eggs.gnu.org ([209.51.188.92]:58622) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sjxKD-0005Dd-58 for 44744-done@debbugs.gnu.org; Fri, 30 Aug 2024 04:49:45 -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 1sjxJC-0007Uj-FV; Fri, 30 Aug 2024 04:48:42 -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=G2tiG4S3JyY2qOHlvrQsUWr2E4NpmqO/l+CEjygHWsA=; b=OoxAsm03YoTufaRQLbUR ++3CtbJu8ylE+Ah7gKjgl3YwmBksd7lnTqzSN1B94lX1IUe3gSC3gvqKMRQLeLe2CeKSAqduwC1No Qv39ghoAah7vPKxK7Dh/biAtOPDLVtZ1zf80aZrlEm370xvfLxZC0kkseKQo6Vwcnqp5ErDvKdckq KmTIW/Xvnfny5t6fJuurchlMQ9Z86A4VofGQ9+bPgZfJaihmwaYcAnn0pCBNc885WXJsX4BWiXEVF LAb7F87/u/5WZCIR6UIowMQuY+BFkKDwoTKRMvcOLpxmwAJRmnvmwUubeH2BAyTvEOKaEH9XBpT3W GWLCf/j5yIfVjQ==; From: Arash Esbati To: James Cook Subject: Re: bug#44744: 12.2.4; Incomplete documentation for TeX-view-program-list In-Reply-To: (Arash Esbati's message of "Sat, 24 Aug 2024 08:15:08 +0200") References: <20201119195244.5tbxdkhwwquom2vl@angel.falsifian.org> <86pn48mafw.fsf@gnu.org> <20201122034610.obsjwqcdgahp4v7e@angel.falsifian.org> Date: Fri, 30 Aug 2024 10:48:24 +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: 44744-done Cc: 44744-done@debbugs.gnu.org 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 (---) Arash Esbati writes: > I'd like to propose this change in order to fix and close this issue; I installed that change, and therefore closing this report. Best, Arash From unknown Tue Jun 17 20:21:35 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 27 Sep 2024 11:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator