Add compiled versions of the examples along with our useful files

With:

  $ make all dist
  $ git add .
  $ git commit

The useful files are copied from the dependencies of my Gentoo package
[1].  Upstream source for each of them is on the Gentoo mirrors.  The
actual packages used for this particular commit are:

  dev-texlive/texlive-latexrecommended-2012-r1
  dev-texlive/texlive-latexextra-2012
  dev-tex/draftmark-9999 (also from my overlay [2,3])
  dev-tex/xcolor-2.11

[1]: http://git.tremily.us/?p=wtk-overlay.git;a=blob;f=drexel-thesis-9999.ebuild;h=9a240faefabc57e5c385865e997a85f264e7f9d7;hb=8b7591f2cd7a3917ff95c338c389dd983e3f2d55#l26
[2]: http://git.tremily.us/?p=wtk-overlay.git;a=blob;f=draftmark-9999.ebuild;h=3b6b29efec10843930dec952841fc5726d4d6897;hb=6eb4b9b2c9145dcaf26a3b8ca5641c966b2831cd
[3]: http://mirror.ctan.org/macros/latex/contrib/draftmark.zip

Makefile: Make *.sty and *.tex precious so Make won't delete them

See [1] for the .PRECIOUS docs.

[1]: https://www.gnu.org/software/make/manual/html_node/Special-Targets.html#index-preserving-with-_002ePRECIOUS

.gitignore: Don't ignore build targets

For folks who don't want to use DocStrip [1] to generate these locally
from drexel-thesis.ins and drexel-thesis.dtx.

[1]: http://www.tug.org/texlive/Contents/live/texmf-dist/doc/latex/base/docstrip.pdf

README.rst: Rename from README for GitHub's browser

Bump to version 0.15

Changes since 0.14:
* Rename mydraftwatermark -> xdraftwatermark
* Added nodraftwatermark option and ifdraftwatermark macro
* Added pagebreak and nopagebreak options
* Added missing \DUTif... versions of user-visibile \if... macros
* Refactored makeapprovalform
* Added LyX layout drexel-thesis.layout
* Bundled USEFUL_PACKAGES pulled from the local TeX installation
* Give \draftmarksetup example based on Travis Hoppe's thesis
* Assorted documentation cleanups

Change my email address from drexel.edu to tremily.us.

Add pagebreak and nopagebreak options.

This will make it easier to setup your thesis for a good-looking copy.
Pure `final` mode has too many silly requirements and pure `draft`
mode is much too cluttered.

Also add \changes note about the nodraftwatermark options.

Add nodraftwatermark option and ifdraftwatermark macro.

Also:
* Rename mydraftwatermark -> xdraftwatermark.
* Give \draftmarksetup example based on Travis Hoppe's thesis.
* Add missing \DUTif... versions of user-visibile \if... macros.

Convert README to reStructruedText.

Update copyright years.

Use `\cs{...}` instead of `$\backslash$...`.

Add section discussing \PassOptionsToPackage.

This documents Walt Mankowski's suggestion for using xcolor with table
support so that future users will not have to dig around for it.

`daring` is not a book option.

Pull USEFUL_PACKAGES from the tex system (via kpsewhich) not current directory.

Replace old contrib/drexel-thesis.layout with John's newer version.

I'd accidentally placed his new version in the repository root directory.

Merge branch 'master' of ssh://einstein/~/public_html/code/git/drexel-thesis

Document drexel-thesis.layout.

Added LyX layout drexel-thesis.layout.

Fix columness -> columns typo.

Adjused Evan Sultanik's makeapprovalform to be more LaTeX-y.

The original implementation was a more TeX-y.

Also make similar stylistic changes to other aspects of Evan's patch.

Added approvalform option and tikz Drexel logo.

Cleaned up TOC/LOF/LOT and bump to version 0.13

This fixes a line break bug with latex reported by Daniel Cross, wher
figure and table entries had looked like

  1.1
      A table float .  .  .  .  .  3

rather than the expected

  1.1 A table float .  .  .  .  .  3

The bug did not occur with pdflatex.

Added blackref option and notes on overriding hyperref colors.

Correct single-paragraph spacing bug in several environments.  Version 0.12.

Thanks to John Parejko and Daniel Cross for pointing out the bug.

Also moved some of the 0.8 change notes out to the beginning of their
macro definition to avoid introducing a blank line mid-macro in the
drexel-thesis.pdf output.

Added contrib to Makefile and cleaned up indentation in drexel-thesis.layout

Added John's LyX layout.

Date: Fri, 11 Jun 2010 22:49:57 -0400
From: John K. Parejko
Subject: LyX class

...
Might be handy for you to include.  It probably needs improvements,
but it'll be helpful for anyone else who wants to use LyX for their
thesis.
...

Added daring, ifdaring, "Advisor(s):" and bumped to v0.11.

I'm all for optionally breaking rules, so here's a new switch to
control this sort of thing.  I imagine there will be more daring
hacks in the future...

From: Evan Sultanik
Subject: Advisors in the Thesis Abstract
Date: Fri, 04 Jun 2010 14:49:12 -0400

how the advisors are listed in the abstract.  "Shouldn't there be the
word 'Advisor:' or something before the names to differentiate the
advisor(s) from the student?"

I assured him that this was done to conform to the official Drexel
thesis manual.

However...

I took a look at how I typeset my MS thesis (back in 2006) and I did
put the word "Advisor: " before listing my advisor.  Perhaps I broke
the rules then, and I am probably going to break them again for my
Ph.D.

Here's what I did: On line 195 of drexel-thesis.cls, right before
"\newcounter{advisor@loop}", I added the following:

    Advisor\ifnum\c@advisors>1s\fi: %

That seemed to do the trick.  I am not sure how you feel about
breaking such rules, but I would highly recommend merging it into the
master :-)

    - Evan

Transitioned to DUT-centric namespace with aliases and bumped to v0.10.

John Parejko was having some trouble getting his thesis to work with
the previous implementation.  Apparently the standard approach to
theses for the astro folks at Drexel is to have most body chapters be
full-fledged papers from previous publications.  This lead to a bunch
of name collisions.  For example, the per-chapter abstracts were using
the drexel-thesis abstract environment, which was not appropriate.

I think the cut-and-paste-paper-chapter idea isn't all that great ;),
so I didn't want to just rename the drexel-thesis stuff to more
obscure names to avoid collisions.

The solution implemented here compromises, by adding DUT* aliases to
public macros and environments.  That way, most users can continue as
they were with no problems, but users who wish a macro or environment
name was different can clobber away and then use the DUT* form to
access the clobbered functionality.

I also moved some of the internal commands to drexel-thesis-specific
names, when I felt the internal commands were also a clobber risk.
The problem with this is that it becomes more awkward to override
the drexel-thesis behaviour, since then you *want* to successfully
clobber something.  If that ends up being a problem for someone,
let me know :).

Add author/title metadata to compiled PDF

Bumped to verison 0.9

Don't use \@ to print the at symbol, it doesn't work.

Note that it's not listed in the
  LaTeX2e Escapable "Special" Characters
section of the Comprehensive LaTeX Symbol List
  http://www.ctan.org/tex-archive/info/symbols/comprehensive/

We add \textat to work around this in the body text, and $@$ in the
changes text.

Rework \@advisor to use scratch \count@ instead of advisor@loop.

I thought the end of the group would deallocating my advisor@loop
counter.  I was wrong :p.  Turns out deallocating counters in (La)TeX
is hard (see the localloc package for details).  The easier solution
is to use scratch counters, which led to a few of LaTeX -> TeX
adjustments.  Anyhow, now I don't waste a counter running \@advisor.

Also corrected a typo in the documentation: \@advisor is used by the
abstract environment, not \maketitle.

Use nifty section symbol \S instead of saying "section" for references.

Add URL for babel package

Fix indentation for some macrocode environments

Work around potential \chapter{Bla bla\label{x}} usage.

Also corrected some
  % \begin{macrocode}
lines to
  %    \begin{macrocode}
along with their associated end tags.

Add "Main Matter" PDF bookmark note to the template and bump to v0.8.

Promted by Evan Sultanik's comments on 2010-04-30.  I remember making
similar changes back then, but I don't seem to have pushed them back to my
central git repository :(.  Anhow, better late than never ;).

Version bump because of added spaces in PDF bookmarks (further LaTeX
consistency):
  * "Frontmatter" -> "Front Matter"
  * "Backmatter" -> "Back Matter"

Added \iffinal and bumped to v0.7

Removed v1.4f change note from cut-and-pasted theindex definition.

Shortened the one-page \Blindtext entries to 3 paragraphs, so they
will actually fit on one page.  I was calling the blindtext macros
incorrectly before.  The options should go in brackets [], not braces
{}.

Use \listed@schapter in theindex

Fixed \if@final handling and bumped to v0.6

Merged v0.5 into trunk

Use hypcap (and bump to v0.5)

Repositioned hyperref inclusion and fixed \change backslash escaping

Removed blabla.sty from drexel-thesis.ins

Make CC specific to CC-by-sa v3.0

Make CC specific to CC-by-sa v3.0

Fix 'multi-partfigures' typo in subfig section

Fix 'begin{macrocode}' typo before fancyhdr section

Added fancyfoot removal note

Fix babel name overwrites in examples.

Added indenttoc option

Added subfig option

Replaced blabla package with blindtext following Evan Sultanik's suggestion

Added \crefname{part} example

Add note about chapter-text/section spacing in base book.cls

Added includeonly hint

Added subfig usage suggestions

Added possible fancy footer overlap issue.

Use \@tsp insead of hard coded 3 in \maketitle

Mention bugs/hacks in the documentation

Official bump to v0.3

Use Evan's watermark implementation by default

Work around 'head--table space longer for LOT/LOF than TOC.'

Worked around 'page top--chapter head space longer than one line.'

Replace \begin{spacing} with \setstretch{} calls.

setspace's spacing environment adds some extra skips to get
clean transitions.  We handle those transitions on our own.
\setstretch lets us change the spacing without bothering
with the extra skipping.

I've been struggling with \blanklines.  Current problems:
  * page top--chapter head space longer than one line.
  * chapter head--text space longer than chapter head--section head.
  * head--table space longer for LOT/LOF than TOC.

Use small-caps rather than slanted-uppercase for chapter/section marks.

For consistency with TOC.

Updated CC license to version 3.0

Punted the TOC/LOF/LOT layout to the tocloft package.

Following the CS department's drexelthesis.cls.

Use of small caps in the TOC, etc. avoids the hyperref-uppercase
issue while still looking close to the specifications ;).
This allows us to drop the AddContentsLine junk.

Assorted other changes:
  * Added \listed@schapter for easy unnumbered, TOC-listed
    chapter definition.
  * Appendicies now added to TOC as "chapter", not "appendix"
  * Replaced \sc, \bf, etc. with \scshape, \bfseries, etc.
    See http://www.ctan.org/tex-archive/info/l2tabu/
  * Spell out TOC in user section, since they might not be
    familiar with this abreviation.
  * Corrected List of Tables reference Manual 3.7->3.6
  * Removed superseded \if@appendix code
  * Corrected calc dependers \blanklines->\set@lines@length
  * Added an explanatory sentence to the indentfirst import
  * Always use the same text for \pdfbookmark required args.
  * Added a long chapter heading to check TOC wrap spacing.

Punted the caption/figure layout to the caption and floatrow packages.

Oops, _now_ I've fixed the page numbering.

Previous "solution" only changed "fancy" style.

The new solution looks like my original format, with head<->foot.

Also add \schaptermark so multipage chapter*s will have proper
marking.

Added indentfirst option

Moved page numbers to the upper right, as Evan pointed out is required.

Added LaTeX temp files to .gitignore, + minor cleanups

  * removed textcase.sty from Makefile USEFUL_PACKAGES
    I'd tried it out on the hyperref/uppercase problem,
    but it didn't help, so we don't use it anymore.
  * add \foorloop usage information to blabla.
  * alphebetized draftmark's dependency listing.

Merged Evan Sultanik's December 2009 multiple-advisor drexelthesis.cls.

Changes vs. Evan's implementation
  * use \expandafter to avoid involving \@mainaux
  * use already-defined \alph{} rather roll-your-own \@alphabet
  * many advisors case printed "A, B, and C" rather than "A, B and C".

Unrelated changes
  * \@advisor -> \@degree typo fix.
  * \@sect and \@ssect pseudocode now in |example| environment.
  * natbib's unsrt analog is unsrtnat, not plainnat.

Finally, I packaged the whole thing into \@advisor, so the compositing
logic can be used in multiple places

Evan's original patch was:

--- drexelthesis.cls-old
+++ drexelthesis.cls
@@ -1,5 +1,6 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Drexel University Thesis LaTeX2e Class definition.
+% Modified by Evan Sultanik  December 2009
 % Modified by Jeff Abrahamson    May 2007
 % Modified by Evan Sultanik      April 2006
 % Modified by Jeff Abrahamson    May 2005
@@ -462,14 +463,16 @@
 \newcommand{\department}[1]{\ifx\empty#1\else\gdef\@department{#1}\fi}
 \newcommand{\degree}[1]{\ifx\empty#1\else\gdef\@degree{#1}\fi}
 \renewcommand{\author}[1]{\ifx\empty#1\else\gdef\@author{#1}\fi}
-\newcommand{\advisor}[1]{\ifx\empty#1\else\gdef\@advisor{#1}\fi}
+\newcommand{\advisor}[1]{\ifx\empty#1\else\refstepcounter{numadvisors}\immediate\write\@mainaux
+      {\string\gdef\string\@advisor\alph{numadvisors}{#1}}\fi}
 \renewcommand{\title}[1]{\ifx\empty#1\else\gdef\@title{#1}\fi}
 \newcommand{\gyear}[1]{\ifx\empty#1\else\gdef\@gyear{#1}\fi}

 \global\def\@department{\mbox{}}
 \global\def\@degree{\mbox{}}
 \global\def\@author{\mbox{}}
-\global\def\@advisor{\mbox{}}
+\newcounter{numadvisors}
+\setcounter{numadvisors}{0}
 \global\def\@title{\mbox{}}
 \global\def\@gyear{\number\year} % Default year is current year

@@ -655,6 +658,7 @@
   {\@latex@warning{Empty `thebibliography' environment}}%
   \endlist \clearpage}

+\def\@alphabet#1{\ifcase#1a\or a\or b\or c\or d\or e\or f\or g\else h\fi}
 \renewenvironment{abstract}{
   \clearemptydoublepage
   \phantomsection
@@ -665,7 +669,17 @@
       \vspace*{-1em}
       {\@title}\\[3mm]
       {\@author}\\
-      {\smallskip Advisor: \@advisor}\\
+      {\smallskip Advisor\ifnum\thenumadvisors>1 s\fi:
+        \begingroup
+          \newcount\adv
+          \adv=0
+          \loop
+            \ifnum\adv<\thenumadvisors
+              \advance\adv by 1
+              \ifnum\thenumadvisors>1\ifnum\adv=\thenumadvisors{\ and\ }\else\ifnum\adv>1{,\ }\fi\fi\fi
+              \csname @advisor\@alphabet{\the\adv}\endcsname\relax
+          \repeat
+        \endgroup}\\
       \vspace*{4em}
     }
   \end{singlespace}

Added blabla.sty to Makefile clean

Added example PDFs to the Makefile too

Oops, add drexel-logo.pdf to EXAMPLE_FILES in Makefile

Major reorganization.  Vast improvements.

 * incorperated documentation from the base .dtx files.
 * improved hyperref and natbib integration.
 * cleaned examples.

Better handling of figure/table/caption spacing.

Added \@dsp for flexible control of display (equations, etc.) spacing.

Removed \DescribeMacros call, since its not defined :p.

Defined \blabla for creating a dummy text in bulk, and added calls to
the examples.

Broke \set@lines@length out of \blanklines

Added draftwatermark handling, graphicx explanation.

Actually, the CS class seems to have tried to use _both_
  a draftcopy implementation (in \DeclareOption{draft})
_and_
  a handrolled \AddToShipoutPicture implementation
  (in \DeclareOption{draftwatermark},
   called by \DeclareOption{draft}).
I imagine this was due to inter-developer miscommunication...

Anyhow, I like draftmark ;).

annotate isn't what I'd thought it was.  Remove it for now

Fix \makecopyrightCC implementation

"\vfil" -> "\vspace*{\fill}" (better LaTeX idiom)

Add \m@kecopyright + swap \listof* definitions

Began importing option descriptions from drexelthesis.cls
  http://www.cs.drexel.edu/~jeffa/talks/drexelthesis.cls

\newpage -> \clearpage

According to
  http://help-csli.stanford.edu/tex/latex-pagebreaks.shtml
\clearpage is similar to \newpage but figures are also printed.

So there is no situation in our class for which we would prefer
\newpage over \clearpage.

Fix "*" -> "def*" in \defmonth/\defyear example

Began versioning