# What does the draft mode change?

I wonder which changes are made by the draft option?

That means what will be changed by calling it as global class option (\documentclass[draft]{<class>}) or locally for a single package if it is available (\usepackage[draft]){<package>}.

Note
I know that this depends on the loaded packages and if they react on the draft option or not. But I thought it could be helpful to have a overview which packages do what.

I suggest the answers to be CW and using this layout

Package/Class: name
Changes

- one
- two

Has final option too: yes/no


If you like we can discuss the layout in meta …

• While I like your question, I don't see a point in adding several CW answers. Why not write a single answer covering everything you know (with appropriate sections) and let other users add their knowledge either in separate answers (provided your answer was non-CW) or by editing your (CW) answer? – lockstep Mar 24 '12 at 18:31
• @lockstep: Hm … I though it’s a little more tidy in separate answers. And furthermore the answers can be sorted by importance/relevance by upvoting them. If you comment get’s 5 upvotes (do we call it upvotes for comments too?) I’ll merge the CW answers. – Tobi Mar 24 '12 at 18:38
• +1 for introducing me to the draft option; -1 for not actually explaining what it is (not that it was very hard to Google for). – Ilmari Karonen Mar 25 '12 at 0:13
• Several packages for setting someting in the page background, e.g draftmark or xwatermark, have a draft and final option, but I was too lazy to search for, what it means in each case. – Speravir Mar 25 '12 at 1:17
• @IlmariKaronen: The question shouldn’t explain it. For that we have the answers below. And since it depends on the packages one can’t say what the option does in general ;-) – Tobi Mar 25 '12 at 8:23

# Overview

## Classes

Print a box at the end of overfull lines.
See this answer below for a list of classes and details.

## Related questions:

Package: microtype

• All microtyping is disabled which may lead to different line breaking

If the draft option is passed to the package, all micro-typographic extensions will be disabled, which may lead to different line, and hence page, breaks. The draft and final options may also be inherited from the class options; of course, you can override them in the package options. E. g., if you are using the class option draft to show any overfull boxes, you should load microtype with the final option.

Has final option: yes

# Document classes

Standard: article, book, report
AMS: amsart, amsbook, amsproc
KOMA-Script: scrartcl, scrbook, scrreprt, scrlttr2
Other: proc, memoir

Changes:

• Print a mark for overfull lines

Have final option too: yes

## Related questions:

Package: graphicx
Changes

• Prints frames containing the file name instead of including the images

Has final option too: yes

• While it wasn't asked for directly, I think the demo option should also be mention where you don't need the actual figure and you get a black box. – StrongBad Mar 25 '12 at 18:58

Package: showkeys

• draft is the default setting

Has final option: yes, it disables all package functionality.

Package: varioref
Changes:

• Turn error messages into warnings.

Has final option: yes

Package: hyperref

Changes:

• Turns all hypertext options off

final option: yes

Package: listings
Changes

• Doesn’t include external file but prints their caption and makes their labels.

Has final option too: yes

• How can I suppress this behaviour, or have it render a box of the SAME size as the listing, so that my DRAFT documents layout isn't heavily modified when the input listings disappear... – Nicholas Hamilton Nov 12 '13 at 12:31
• You can pass the final option directly to a package, while the draft class option stays active for the class and other packages without the explicit option. I.e. \documentclass[draft]{article} ... \usepackage[final]{listings} ... – Tobi Nov 12 '13 at 12:47
• My experience is that draft mode even inhibits the display of regular lstlisting environment listings; i.e., not only code from external files. – Jim Ratliff Sep 30 '18 at 20:07

Package: pdfcomment

• Option draft is the default.

Changes with final option:

“PDF annotations will not be typeset and will not inﬂuence line breaking.”

(In other words: The lines will change, if inline annotations have been used.)

Package: listofsymbols
Changes:

• Option draft is default with this package.
• Option final removes the macronames from the lists. Symbols that are not used in the document are omitted from the List of Symbols and from the List of Subscripts.

Has final option too: yes (see above)

Package: pdfpages
Changes

• Does not insert pages, but prints a box and the filename instead.

Has final option too: yes

• That behaviour is probably inherited from graphicx. – Martin Schröder Mar 24 '12 at 20:53
• @MartinSchröder Yes, probably. Maybe merge the answers for these two? – yo' Mar 25 '12 at 5:21

Package pgf (but not TikZ)

Changes:

• All images will be replaced by empty rectangles.

final option: yes

package: thumbs

Changes:

Option draft (not the default) sets the thumb mark width to 2 pt, thumb mark text colour to black and thumb mark background colour to grey (gray). Either do not use this option with the thumbs package at all, or use draft=false, or final, or final=true to get the original appearance of the thumb marks.

final option: yes

Package: changes

• Option draft is the default.

Changes with final option:

The final-option disables markup of changes, only the correct text will be shown. The list of changes is disabled, too.

Package: mfpic
Changes:

• Treats any pdflatex run as the first run, pretending figure files have not been created.

Has final option too: yes

Package: flowfram

Changes:

• Shows the bounding boxes with identifying tags for each frame, the typeblock and the margins.

Example:

\documentclass{article}

\usepackage{lipsum}
\usepackage[draft]{flowfram}

\twocolumntop{static}{1in}

\setstaticcontents{1}{Top Area}

\begin{document}

\marginpar{Marginal Note}\lipsum*[1]

\lipsum*[2-3]\marginpar{Margin Note 2}

\end{document}


Has final option: