Take the 2-minute tour ×
TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It's 100% free, no registration required.

So to "comment out" a line, I need to insert a % at the beginning of the line (so that line will not be compiled).

Is there way to comment out a large section without having to manually putting a % in front of each line?

share|improve this question
    
Can you explain the sort of situations you want to do this in? If, for example, it's to reduce compile times when writing a long document then you may find it best to use something like the subfiles package. This would mean you don't have to remove the commented out sections before compiling the whole document, but you could still compile individual parts of the document with the proper preamble, and without changing anything except for which file you pass to LaTeX. –  Edd May 10 '11 at 11:03
    
Related: Multi-line (block) comments –  Scott H. Jan 12 '13 at 17:41
1  
I think the most comprehensive answer is still this one from the UK TeX FAQ: tex.ac.uk/cgi-bin/texfaq2html?label=conditional –  Blaisorblade Nov 1 '13 at 14:26

10 Answers 10

up vote 73 down vote accepted

You can use \iffalse ... \fi to make (La)TeX not compile everything between it. However, this might not work properly if you have unmatched \ifxxx ... \fi pairs inside them or do something else special with if-switches. It should be fine for normal user text.

There is also the comment package which gives you the comment environment which ignores everything in it verbatim. It allows you to define own environments and to switch them on and off.

share|improve this answer

For the sake of completeness, I will include the shortcuts for comments on Texmaker (as previously answered in this thread). In short, Ctrl + T to comment and Ctrl + U to uncomment, but of course you can customize them.

share|improve this answer

If using TeXNiC Center: highlight the text. press ctrl + Q to comment the text out. ctrl + W will uncomment it.

share|improve this answer

In vi or vim you could comment a section (say line 102-345) like this:

[esc] [:]

you are in command mode now! And type:

102,345s/^/%/

it means substitute the beginning of the line (^) with a % sign.

share|improve this answer
2  
I find much more easy to use block-visual-mode insert: notfaq.wordpress.com/2006/07/28/vim-comment-blocks-of-code –  Rmano Apr 10 at 20:57

I often paste in plain text such as writing guidelines and comment them out. For me the simplest way is to define a command with an argument which produces no output.

newcommand{\comm}[1]{}

And to comment out text:

\comm{
Text text text
}
share|improve this answer

This answer obviously depents of the frontend one is using, but in the case of using Kile:


Commenting multiple lines with Kile

1) Select the lines you wish to comment out

2) Ctrl - D


Uncommenting multiple lines with Kile

1) Select the lines you wish uncomment

2) Ctrl - Shift - D


These shortcuts can be changed from Settings -> Configure Shortcuts...

share|improve this answer

There are other ways to solve this problem than via (La)TeX.

Something that is good about either of these solutions is that they are independent of particular LaTeX packages and code.

share|improve this answer
    
I'd second this; Most text editors have this, and emacs is great for when I'm writing lots of math. For more text-based things, TeXStudio is also good, and has a similar feature. –  Canageek Jul 3 '12 at 23:03
2  
Actually, <kbd>M-;</kbd> is even better (less keystrokes), and more intelligent (it does different things depending on e.g. whether region is active or not). –  mbork Mar 23 '13 at 22:05
    
Worth noting, though, that my editor (Vim with LaTeX-Suite) is the reason I looked for this question despite already knowing how to line-comment en masse, because it screws up the folding. When I use the comment environment, I can fold up the whole commented-out part and only that part. –  Luke Maurer Jun 30 '13 at 14:25
    
Also, uncommenting lines commented this way doesn't always work even in editors which support it in theory. It is however pretty useful. –  Chris H Mar 31 at 13:29

Another option is the comment package, which, like verbatim provides a comment environment, but offers the option to define arbitrary "throw away" environments that can selectively be enabled or disabled:

\documentclass{article}
\usepackage{comment}

% uncomment to include stuff in standard comment-environment
%\includecomment{comment}

% define a mysection env which content is excluded
\excludecomment{mysection}

\begin{document}
    This text will be displayed
\begin{comment}
    This text will only be displayed, if \includecomment{comment} was given
\end{comment}
\begin{mysection}
    This text will only be displayed, if \includecomemnt{mysection} was given
\end{mysection}
\end{document}

Additionally, the package provides some simple hooks into the defined environments. Instead of \includecomment{mysection} one could also use \specialcomment{mysection}{<before code>}{<after code>} to enable some comment section:

% typeset stuff in mycomment with gray text
\specialcomment{mysection}{\begingroup\color{gray}}{\endgroup}
share|improve this answer

The verbatim package provides a comment environment:

\documentclass{article}
\usepackage{verbatim}
\begin{document}
    This text will be displayed
\begin{comment}
    This text will not be displayed.
\end{comment}
\end{document}

The Not So Short Introduction to LaTeX2e mentions this option on page 6 and remarks: "Note that this won’t work inside complex environments, like math for example."

share|improve this answer

You can use \iffalse:

\iffalse
One morning, as Gregor Samsa was waking up from anxious dreams, he discovered
that in his bed he had been changed into a monstrous verminous bug. He lay on
his armour-hard back and saw, as he lifted his head up a little, his brown,
arched abdomen divided up into rigid bow-like sections.
\fi

Of course, this has to align with other syntactical TeX structures in you document whereas you can use % much more freely. The good news is that you can introduce your own switch to make this optional:

\newif\ifdraft
\drafttrue % or \draftfalse

\ifdraft
<only shown in draft mode>
\else 
<only shown in non-draft mode>
\fi

The \else part is optional and you could use \ifdraft ... \fi if you don't need it.

share|improve this answer
9  
+1 for the example. –  Skarab Jan 22 '12 at 11:35
3  
I'm sorry to say, but I saw a bug in your code! :) –  McGafter Mar 31 at 13:26

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.