Text Formatting ⇒ Environment? To print text in draft mode only?

[jamesqf]

Is there an environment (or can I easily write one?) which will output a section of text (possibly many paragraphs) in draft mode, but omit it entirely in final?

I'm writing a document, and each chapter (and some sections, etc) begins with an outline of the chapter and some notes about e,g, what I need to add. I'd like to keep this for reference, and have it appear in drafts, but not in the final document.

So what I would have would look something like this:

Code: Select all

\begin {ChaptOutline}
  \begin {framed}
     \begin {outline}
       ... the outline text...
     \end {outline}
     ... and maybe some comments...
  \end {framed}
\end {ChapOutline}
\chapter {the title}

Is there an easy way to do this?

Thanks,
James

[frabjous]

Take a look at the comment package.

[jamesqf]

Thanks - the comment package does just about what I want.

Unfortunately, it seems to have an annoying bug. If I write the commands as I normally would

Code: Select all

\begin {comment}
  This is a comment
\end {comment}

Latex comes to a screeching halt with a message about "Runaway argument...". But if I mangle the formatting by taking out the space

Code: Select all

\begin{comment}
  This is a comment
\end{comment}

it works. Anyone know how to fix this? I looked at the code in the package, but I don't know enough about Tex programming to even make a guess at what it's doing.