% For more useful float information, see the
% \href{http://en.wikibooks.org/wiki/LaTeX/Floats,_Figures_and_Captions}
% {\LaTeX\ wikibook page}.
-%
+%
+% \href{http://www.ctan.org/tex-archive/macros/latex/contrib/subfig/}{\pkg{subfig}}
+% cooperates with \cls{drexel-thesis}'s included \pkg{floatrow}. If
+% you wish to use the \pkg{subfig} macros, you should add something
+% like
+% \begin{example}
+% \usepackage{subfig}
+% \usepackage{fr-subfig}
+% \end{example}
+% See the \pkg{floatrow} documentation (Sec.~7.1, ``The \pkg{subfig}
+% package'') and \pkg{subfig} documentation (Sec.~4.3,
+% ``\pkg{FloatRow} Package'') for details.
+%
%
% \subsubsection{Citations}
%
%
% \subsubsection{References}
%
+% Easier cross referencing with
% \href{http://www.ctan.org/tex-archive/macros/latex/contrib/cleveref/}{\pkg{cleveref}}.
-% Is a wonderful tool for easy, consistent crosslinking. The manual is also very good.
+% Is a wonderful tool for easy, consistent crosslinking via |\cref|,
+% |\Cref|, etc.. The manual is also very good.
+% Note that if you use |\part|s in your document, you need to tell
+% \pkg{cleveref} how to deal with them:
+% \begin{example}
+% \usepackage{cleveref}
+% \crefname{part}{part}{parts}
+% \end{example}
%
%
% \subsubsection{Hyperlinks}
% set options overriding these defaults.
%
%
+% \subsubsection{Developing large \LaTeX\ documents}
+%
+% A thesis may take a while to compile, especially if it contains
+% lots of images, etc.. One way to save time, is to use |\includeonly|
+% when including chapter \file{*.tex} files (see
+% \href{http://en.wikibooks.org/wiki/TeX/includeonly}{the \TeX\ Wikibook}).
+% Usage would be something like
+% \begin{example}
+% \documentclass{drexel-thesis}
+% ...
+% \includeonly{chapter2.tex,chapter3.tex}
+% \begin{document}
+% ...
+% \begin{thesis}
+% \include{chapter1.tex}
+% \include{chapter2.tex}
+% \include{chapter3.tex}
+% \include{chapter4.tex}
+% \end{thesis}
+% ...
+% \end{document}
+% \end{example}
+% which would only compile chapters two and three. Don't confuse the
+% similar commands |\include| and |\input|. The more fundamental
+% |\input| just inserts the file contents at that point, while
+% |\include|
+% \begin{itemize}
+% \item may only be used after |\begin{document}|
+% \item acts like |\clearpage \input{} \clearpage|
+% \item will not crash on nonexistent files
+% \end{itemize}
+%
+%
% \StopEventually{\pagebreak\PrintChanges}
%
%
% We want two blank lines (triple spacing) between the title and the
% remaining material, so add three but don't end the paragraph.
% \begin{macrocode}
- \blanklines{3}%
+ \blanklines{\@tsp}%
\setstretch{\@dsp}%
A Thesis\\
Submitted to the Faculty\\
% Adding even a \vspace*{0\p@} here seems to increase the vertical
% space above the chapter heading by two lines. I'm not sure why.
% Workaround is to pass the ``value of blanklines you want minus two''
-% to |\blanklines*|.
+% to |\blanklines*|. HACK!
% \begin{macro}
\blanklines*{-1}%
{\parindent \z@ \raggedright \normalfont
% (\file{classes.dtx}, L2595).
% \begin{macrocode}
\def\@makeschapterhead#1{%
- \blanklines*{-1}%
+ \blanklines*{-1}% HACK!
{\parindent \z@ \raggedright \normalfont
\setstretch{\@ssp}%
\interlinepenalty\@M
% \begin{macro}{\afterloftitleskip}
% Don't add any extra space after the title (the chapter will take
% care of that). Actually we make a one-line correction so the first
-% line matches the first line in the TOC.
+% line matches the first line in the TOC. HACK!
% \begin{macrocode}
\setlength\cftafterloftitleskip{-12pt}
% \end{macrocode}
% \begin{macro}{\afterlottitleskip}
% Don't add any extra space after the title (the chapter will take
% care of that). Actually we make a one-line correction so the first
-% line matches the first line in the TOC.
+% line matches the first line in the TOC. HACK!
% \begin{macrocode}
\setlength\cftafterlottitleskip{-12pt}
% \end{macrocode}
\chapter{A Long Title Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla
Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla Bla}
\blabla{30}{20}
+\section{Section in long-titled chapter}
+\blabla{30}{20}
%</example-part>
% \end{macrocode}
%
% \end{macrocode}
%
%
+% \section{Known bugs and issues}
+%
+%
+% \subsection{Hacks}
+%
+% \begin{itemize}
+% \item |\vspace*{0\p@}| space between page top and chapter
+% headings (|\@makechapterhead| and |\@makeschapterhead|,
+% Sec.~\ref{sec:implement-chapters}).
+% \item Extra space under LOT and LOF titles compared to TOC.
+% (Secs.~\ref{sec:implement-lof} and \ref{sec:implement-lot}).
+% \end{itemize}
+%
+%
+% \subsection{Bugs}
+%
+% \begin{itemize}
+% \item Different space between chapter heading and section heading,
+% vs.\ chapter heading and text. Compare \emph{A Chapter Heading}
+% and \emph{Another Chapter} in \file{example.pdf}. This is a
+% problem (although with opposite order) in the \cls{book} class
+% itself. For example, compile
+% \begin{example}
+%\documentclass{book}
+%\begin{document}
+%\chapter{Chapter with text}
+%Bla bla bla.
+%\chapter{Chapter with section}
+%\section{Section}
+%Bla bla bla.
+%\end{document}
+% \end{example}
+% \item Footer overlap if chapter/section names are particularly long.
+% See \emph{Section in long-titled chapter} in \file{example.pdf}.
+% Workaround: turn off either chapters or sections in the footer.
+% \begin{example}
+% \fancyfoot[RE,LO]{\scshape\leftmark}
+% \fancyfoot[LE,RO]{}
+% \end{example}
+% \end{itemize}
+%
+%
% \Finale
\endinput