GNU bug report logs - #63083
13.1.4; Table of contents should ignore commented out text

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 63083 in the body.
You can then email your comments to 63083 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Hugo Paquet <paquet <at> lipn.univ-paris13.fr>
To: bug-auctex <at> gnu.org
Subject: 13.1.4; Table of contents should ignore commented out text
Date: Tue, 25 Apr 2023 17:10:56 +0200

The command "C-c =" is supposed to scan the .tex file(s) and generate a table of contents. 
But the table seems to include all sections, even those when the code "\section{....}" appears in a comment block.
This makes the table of contents inconsistent with the resulting pdf.



Emacs  : GNU Emacs 27.2 (build 1, x86_64-apple-darwin18.7.0, NS appkit-1671.60 Version 10.14.6 (Build 18G95))
of 2021-03-27
Package: 13.1.4

current state:
==============
(setq
AUCTeX-date "2022-08-26"
window-system 'ns
LaTeX-version "2e"
TeX-style-path '("/usr/local/var/auctex"
		  "/Users/huguet/.emacs.d/elpa/auctex-13.1.4/style"
		  "/Users/huguet/.emacs.d/auctex/auto"
		  "/Users/huguet/.emacs.d/auctex/style" "auto" "style")
TeX-auto-save t
TeX-parse-self t
TeX-master "freyd-bicats"
TeX-command-list '(("TeX"
		     "%(PDF)%(tex) %(file-line-error) %`%(extraopts)
%S%(PDFout)%(mode)%' %(output-dir) %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) %(o-dir) %t"
		     TeX-run-compile nil (texinfo-mode) :help
		     "Run Makeinfo with Info output")
		    ("Makeinfo HTML"
		     "makeinfo %(extraopts) %(o-dir) --html %t"
		     TeX-run-compile nil (texinfo-mode) :help
		     "Run Makeinfo with HTML output")
		    ("AmSTeX"
		     "amstex %(PDFout) %`%(extraopts) %S%(mode)%'
%(output-dir) %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 %(O?aux)" TeX-run-BibTeX nil
		     (plain-tex-mode latex-mode doctex-mode
		      ams-tex-mode
		      texinfo-mode context-mode)
		     :help "Run BibTeX")
		    ("Biber" "biber %(output-dir) %s" TeX-run-Biber
		     nil
		     (plain-tex-mode latex-mode doctex-mode
		      ams-tex-mode
		      texinfo-mode)
		     :help "Run Biber")
		    ("Texindex" "texindex %s.??" TeX-run-command nil
		     (texinfo-mode) :help "Run Texindex")
		    ("Texi2dvi" "%(PDF)texi2dvi %t" TeX-run-command
		     nil
		     (texinfo-mode) :help "Run Texi2dvi or Texi2pdf")
		    ("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 -o %(O?pdf) %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 %(O?pdf)" TeX-run-ps2pdf nil
		     (plain-tex-mode latex-mode doctex-mode
		      ams-tex-mode
		      texinfo-mode)
		     :help "Convert PostScript file to PDF")
		    ("Glossaries" "makeglossaries %(d-dir) %s"
		     TeX-run-command nil
		     (plain-tex-mode latex-mode doctex-mode
		      ams-tex-mode
		      texinfo-mode)
		     :help "Run makeglossaries to create glossary
file")
		    ("Index" "makeindex %(O?idx)" 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 %(O?idx)" 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")
		    )
)

Message #8 received at 63083 <at> debbugs.gnu.org (full text, mbox):

From: Arash Esbati <arash <at> gnu.org>
To: Hugo Paquet <paquet <at> lipn.univ-paris13.fr>
Cc: 63083 <at> debbugs.gnu.org
Subject: Re: bug#63083: 13.1.4; Table of contents should ignore commented
 out text
Date: Wed, 26 Apr 2023 10:58:45 +0200

Hugo Paquet <paquet <at> lipn.univ-paris13.fr> writes:

> The command "C-c =" is supposed to scan the .tex file(s) and generate
> a table of contents.  But the table seems to include all sections,
> even those when the code "\section{....}" appears in a comment block.
> This makes the table of contents inconsistent with the resulting pdf.

I think this is by design; I'm not aware of any variable similar to
`reftex-label-ignored-macros-and-environments' for \section and such.  I
think the idea is to comment out the code with %, and then there was
also this bug report[1].

Maybe others have a good idea.

Best, Arash

Footnotes:
[1]  https://debbugs.gnu.org/cgi/bugreport.cgi?bug=59638

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.