The memoir class - The UK TeX Archive

15. BOXES, VERBATIMS AND FILESThis is the second paragraph in the quotation environment and in turnit is within the qframe environment.This is the third paragraph in the quotation environment and in turnit is within the framed environment.This is the fourth and final paragraph within the quotation environmentand is not within either a qfame or framed environment.If you want to put a frame inside an adjustwidth environment then you may well findthat qframe or qshade meet your expections better than framed of shaded. Of course, itdoes depend on what your expectations are.15.2 LONG COMMENTSThe % comment character can be used to comment out (part of) a line of TeX code, but thisgets tedious if you need to comment out long chunks of code.\begin{comment} text to be skipped over \end{comment}As an extreme form of font changing, although it doesn’t actually work that way, anythingin a comment environment will not appear in the document; effectively, LaTeX throws it allaway. This can be useful to temporarily discard chunks of stuff instead of having to markeach line with the % comment character.\newcomment{〈name〉}\commentsoff{〈name〉}\commentson{〈name〉}The class lets you define your own comment environment via the \newcomment commandwhich defines a comment environment called 〈name〉. In fact the class itself uses\newcomment{comment} to define the comment environment. A comment environment〈name〉 may be switched off so that its contents are not ignored by using the \commentsoffdeclaration. It may be switched on later by the \commentson declaration. In either case〈name〉 must have been previously declared as a comment environment via \newcomment.Suppose, for example, that you are preparing a draft document for review by some othersand you want to include some notes for the reviewers. Also, you want to include someprivate comments in the source for yourself. You could use the comment environmentfor your private comments and create another environment for the notes to the reviewers.These notes should not appear in the final document. Your source might then look like:\newcomment{review}\ifdraftdoc\else\commentsoff{review}\fi...\begin{comment}Remember to finagle the wingle!278