bangorcsthesis (6apr15)

git-svn-id: svn://tug.org/texlive/trunk@36727 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 95 insertions, 76 deletions

diff --git a/Master/texmf-dist/doc/latex/bangorcsthesis/README b/Master/texmf-dist/doc/latex/bangorcsthesis/README
index 6c52ac25bff..81910062682 100644
--- a/Master/texmf-dist/doc/latex/bangorcsthesis/README
+++ b/Master/texmf-dist/doc/latex/bangorcsthesis/README
@@ -1,59 +1,56 @@
 Bangor University Computer Science Department Thesis Document Class
 
-Cameron Gray <c.gray@bangor.ac.uk> 
-March 18, 2015
+Cameron Gray <c.gray@bangor.ac.uk>  April 06, 2015
 
 Abstract
 
 Starting with the 2014/15 academic year, the Computer Science department at
-Bangor University have standardised the appearance, layout and formatting of
-all thesis/dissertation documents for all levels (undergraduate and
-postgraduate). This package (containing a LATEX document class) is the
-embodiment of that standard. It includes all of the elements of a thesis, and
-supports a limited number of customisation options that individual students
-may choose (or their supervisors may insist upon). It also makes the process
-of creating a thesis very much simpler with the inclusion of several macros
-(LATEX commands) that streamline the process.
+Bangor University have standardised the appearance, layout and formatting of all
+thesis/dissertation documents for all levels (undergraduate and postgraduate).
+This package (containing a LATEX document class) is the embodiment of that
+standard. It includes all of the elements of a thesis, and supports a limited
+number of customisation options that individual students may choose (or their
+supervisors may insist upon). It also makes the process of creating a thesis
+very much simpler with the inclusion of several macros (LATEX commands) that
+streamline the process.
 
 1 Usage - Class Options
 
 The document class is activated (or loaded) using the usual LATEX command
-\documentclass{bangorcsthesis}. The class requires at least one of the
-following options to be specified, these dictate what type of thesis the
-document forms;
+\documentclass{bangorcsthesis}. The class requires at least one of the following
+options to be specified, these dictate what type of thesis the document forms;
 
-[⟨phd⟩] - Doctor of Philosophy / Doctorate 
-[⟨pgcert⟩] - Postgraduate Certificate
+[⟨phd⟩] - Doctor of Philosophy / Doctorate
+[(pgcert⟩] - Postgraduate Certificate
 [⟨mphil⟩] - Master of Philosophy
-[⟨mscres⟩] - Master of Science by Research 
+[(mscres⟩] - Master of Science by Research
 [⟨mres⟩] - Master of Research
-[⟨msc⟩] - Master of Science (Taught courses)
-[⟨ba⟩] - Bachelor of Arts (Undergraduate courses) 
-[⟨bsc⟩] - Bachelor of Science (Undergraduate courses)
+[(msc⟩] - Master of Science (Taught courses)
+[(ba⟩] - [⟨Bachelor of Arts (Undergraduate courses)
+[(bsc⟩] - Bachelor of Science (Undergraduate courses)
 
 For example; an undergraduate dissertation for a Computer Science degree (a
 B.Sc. course) would start with a document class definition as follows:-
-\documentclass[bsc]{bangorcsthesis}. There are also the following entirely
-optional modifiers that student’s can elect to use;
+\documentclass[bsc]{bangorcsthesis}.
 
-[⟨noindent⟩] - Suppress indentation of first lines of paragraphs.
+There are also the following entirely optional modifiers that student’s can
+elect to use;
 
+[⟨noindent⟩] - Suppress indentation of first lines of paragraphs.
 [⟨nohyphen⟩] - Attempt (as far as possible) to prevent LATEX hyphenating words
 at the ends of lines in the output.
-
-[⟨draft⟩] - Mark the document as draft, this includes adding a watermark to
-all pages. This is highly recommended until the document is final.
-
+[⟨draft⟩] - Mark the document as draft, this includes adding a watermark to all
+pages. This is highly recommended until the document is final.
 [⟨serif⟩] - Convert the thesis to use serif fonts for the main body text.
-
 [⟨twoside⟩] - Make the output ‘two-sided’, much like a book. This may only be
 required for the final copy to be deposited in certain libraries.
+[(serifheadings)] - 
 
 2 Usage - Preamble Macros
 
-The class includes several macros that must be used in the preamble, the
-portion of the document before \begin{document}. These set several important
-parameters such as the degree scheme, supervisors and author details.
+The class includes several macros that must be used in the preamble, the portion
+of the document before \begin{document}. These set several important parameters
+such as the degree scheme, supervisors and author details.
 
 \title{⟨title⟩}
 
@@ -68,15 +65,15 @@ Last.
 
 \date{⟨date⟩}
 
-The date of the document. It is recommended that the date argument is set to
-the month and year of submission of the thesis in full, e.g. May, 2014. This
-macro is not provided by this class but is required in the preamble.
+The date of the document. It is recommended that the date argument is set to the
+month and year of submission of the thesis in full, e.g. May, 2014. This macro
+is not provided by this class but is required in the preamble.
 
 \degreeScheme{⟨scheme name⟩}
 
-This macro must be used to set the title of the student’s overall degree
-scheme. It has a single parameter, the name will be reproduced (verbatim) on
-the title/cover page of the thesis. Use of this macro is required.
+This macro must be used to set the title of the student’s overall degree scheme.
+It has a single parameter, the name will be reproduced (verbatim) on the
+title/cover page of the thesis. Use of this macro is required.
 
 \supervisor{⟨name⟩}
 
@@ -86,7 +83,7 @@ internal memory limits. When there is more than one supervisor defined, the
 title/cover page changes to accommodate them appropriately. At least one
 supervisor must be included.
 
-\bibliographySetup[compressed]
+\bibliographySetup [compressed]
 
 This macro configures BibLaTeX, the successor to BibTeX, to departmental
 standards. The Computer Science department have standardised on IEEE
@@ -109,11 +106,11 @@ should be processed for the document.
 The \acknowledgements macro creates the standard acknowledgments page for the
 front of the thesis. Use of this macro is optional although highly recommended
 as there is usually someone to thank for contributing to your work (including
-your supervisor). You can optionally include an inspirational and/or funny
-quote for the top of the page. If you do not wish to include the quote, simply
-omit the optional arguments.
+your supervisor). You can optionally include an inspirational and/or funny quote
+for the top of the page. If you do not wish to include the quote, simply omit
+the optional arguments.
 
-\statements[(signature image filename)]
+\statements [(signature image filename)]
 
 This macro creates the required statements page for the front matter of a
 thesis. This must be included, failure to do so can result in the thesis being
@@ -123,8 +120,8 @@ is included instead of a white space for you to sign manually.
 
 \tables
 
-The \tables macro creates the appropriate tables (of contents, of figures and
-of tables) for the front matter of the thesis. Tables of figures and tables of
+The \tables macro creates the appropriate tables (of contents, of figures and of
+tables) for the front matter of the thesis. Tables of figures and tables of
 tables are only included when figures and tables are included in the document
 text respectively. If the thesis includes other items (for example code
 listings), you are responsible for including tables of these items yourself
@@ -132,22 +129,26 @@ after the use of this macro.
 
 \thesisContent
 
-This macro marks the start of the actual ‘content’ of the thesis, separate
-from the ‘front matter’ (contents, etc.) and the appendices. Use of this macro
-is required to maintain correct formatting.
+This macro marks the start of the actual ‘content’ of the thesis, separate from
+the ‘front matter’ (contents, etc.) and the appendices. Use of this macro is
+required to maintain correct formatting.
+
+\references [small]
+
+This macro starts the appendices for the thesis and generates an appropriately
+formatted `References' list.  This differs from a Bibliography as it only
+contains items specifically cited in the thesis text whereas a Bibliography
+should contain everything that has been read/used during the preparation of the
+thesis.  If the small parameter is included, the font and spacing are altered
+for the references section to present a more compact form.
+
+4 Document Section Order
 
-4 Document Section Order The Computer Science Thesis has a very specific
-section order; this does not prescribe the format of your thesis, just the
-front and back matter.
+The Computer Science Thesis has a very specific section order; this does not
+prescribe the format of your thesis, just the front and back matter.
 
-1. Title/Cover Page
-2. Acknowledgments Page
-3. Statements Page
-4. Contents
-5. Tables
-6. Thesis Content
-7. References
-8. Other Appendices
+1. Title/Cover Page 2. Acknowledgments Page 3. Statements Page 4. Contents 5.
+Tables 6. Thesis Content 7. References 8. Other Appendices
 
 5 Skeleton Thesis
 
@@ -167,11 +168,11 @@ this document class.
 \acknowledgements[Quote][Person Quoted]{Acknowledgements}
 \statements
 \begin{abstract}
-    ... thesis abstract...
+     ... thesis abstract...
 \end{abstract}
 \tables
 \thesisContent
-    ... document ...
+     ... document ...
 \references
-    ... other appendices ...
-\end{document}
\ No newline at end of file
+     ... other appendices ...
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/bangorcsthesis/bangorcsthesis.pdf b/Master/texmf-dist/doc/latex/bangorcsthesis/bangorcsthesis.pdf
new file mode 100644
index 00000000000..b523654327c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bangorcsthesis/bangorcsthesis.pdf
diff --git a/Master/texmf-dist/source/latex/bangorcsthesis/bangorcsthesis.dtx b/Master/texmf-dist/source/latex/bangorcsthesis/bangorcsthesis.dtx
index 68245cc536e..e869f890ff4 100644
--- a/Master/texmf-dist/source/latex/bangorcsthesis/bangorcsthesis.dtx
+++ b/Master/texmf-dist/source/latex/bangorcsthesis/bangorcsthesis.dtx
@@ -40,15 +40,16 @@
 \end{document}
 %</driver>
 %\fi
-%\CheckSum{566}
+%\CheckSum{577}
 %\RecordChanges
 %\changes{v1.0}{2014/07/01}{Initial version.}
 %\changes{v1.0.1}{2014/09/01}{Repackaged to remove external logo file.}
-%\changes{v1.2.0}{2015/03/18}{Added serif headings and compressed cite style}
+%\changes{v1.2.0}{2015/03/18}{Added serif headings and compressed cite style.}
+%\changes{v1.3.0}{2015/04/06}{Added small references style.}
 %\pagestyle{fancy}
 %\title{Bangor University Computer Science Department\\ Thesis Document Class}
 %\author{Cameron Gray \texttt{<c.gray@bangor.ac.uk>}}
-%\date{March 18, 2015}
+%\date{April 6, 2015}
 %\maketitle
 %
 %\begin{abstract}
@@ -185,11 +186,12 @@
 %
 %\ \\
 %
-%\DescribeMacro{\references} This macro starts the appendices for the thesis and
+%\DescribeMacro{\references\\\oarg{small}} This macro starts the appendices for the thesis and
 %generates an appropriately formatted `References' list.  This differs from a
 %Bibliography as it only contains items specifically cited in the thesis text whereas
 %a Bibliography should contain everything that has been read/used during the
-%preparation of the thesis.
+%preparation of the thesis.  If the small parameter is included, the font and spacing are
+%altered for the references section to present a more compact form.
 %
 %\ \\
 %
@@ -254,11 +256,11 @@
 %    \end{macrocode}
 %\fi
 %    \begin{macrocode}
-\def\version{1.2.0}
+\def\version{1.3.0}
 
 \NeedsTeXFormat{LaTeX2e}
 
-\ProvidesClass{bangorcsthesis}[2015/03/18 \version C. Gray]
+\ProvidesClass{bangorcsthesis}[2015/04/06 \version C. Gray]
 
 % Originally inspired by Clean Thesis 
 % - http://cleanthesis.der-ric.de/
@@ -452,10 +454,18 @@
     }
 }
 
-\newcommand{\references}{
+\DeclareDocumentCommand{\references}{ O{} }{%
     \appendix
-    \pagestyle{maincontentstyle}
-    \printbibliography[heading=bibnumbered]
+    {
+        \ifthenelse{\equal{#1}{small}}{%
+        	\renewcommand*{\bibfont}{\footnotesize}
+    		\linespread{1.0}
+    		\setlength\itemsep{1ex}
+    		\setlength\bibitemsep{0.7\itemsep}
+    	}{}
+        \pagestyle{maincontentstyle}
+        \printbibliography[heading=bibnumbered]
+    }
 }
 
 % **************************************************
diff --git a/Master/texmf-dist/tex/latex/bangorcsthesis/bangorcsthesis.cls b/Master/texmf-dist/tex/latex/bangorcsthesis/bangorcsthesis.cls
index 9949f3ad89f..d9585025175 100644
--- a/Master/texmf-dist/tex/latex/bangorcsthesis/bangorcsthesis.cls
+++ b/Master/texmf-dist/tex/latex/bangorcsthesis/bangorcsthesis.cls
@@ -45,11 +45,11 @@
 %%   Right bracket \]     Circumflex    \^     Underscore    \_
 %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
 %%   Right brace   \}     Tilde         \~}
-\def\version{1.2.0}
+\def\version{1.3.0}
 
 \NeedsTeXFormat{LaTeX2e}
 
-\ProvidesClass{bangorcsthesis}[2015/03/18 \version C. Gray]
+\ProvidesClass{bangorcsthesis}[2015/04/06 \version C. Gray]
 
 
 \def\degreeScheme#1{\def\@scheme{#1}}
@@ -224,10 +224,18 @@ footskip=1cm %  - footer skip size
     }
 }
 
-\newcommand{\references}{
+\DeclareDocumentCommand{\references}{ O{} }{%
     \appendix
-    \pagestyle{maincontentstyle}
-    \printbibliography[heading=bibnumbered]
+    {
+        \ifthenelse{\equal{#1}{small}}{%
+         \renewcommand*{\bibfont}{\footnotesize}
+     \linespread{1.0}
+     \setlength\itemsep{1ex}
+     \setlength\bibitemsep{0.7\itemsep}
+     }{}
+        \pagestyle{maincontentstyle}
+        \printbibliography[heading=bibnumbered]
+    }
 }
 
 \setstretch{1.5} % value for line spacing, use \setstretch{} or