# LaTeX style-sheet FAQ

1. Why am I having difficulty compiling my mcgilletdsample.tex file in a Windows environment?

The first version of the McGill LaTeX style-sheet did not include the sectsty.sty package. The latest version contains the package which you can download here.

2. How do I create an index?

3. How do insert a second paragraph in the acknowledgements section?

Simply place two backslashes ( // )after each paragraph; there will not be any empty lines between them.

4. Why can't I use all commands? Will they be validated?

The ETD manual specifies which LaTeX commands are acceptable for the E-Thesis project. The rationale for specifying some commands and forbidding others is that we must be able to undertake a semantic conversion of the contents of the submitted thesis. Unsuitable commands have not been disabled and will most certainly work in your local environment. The validation tool produces warnings and errors when commands which we will not be able to convert properly have been used.

5. Is the MathFormula environment mandatory?

Yes. In order for us to undetake a semantic conversion of the contents of the submitted thesis, you must use this environment.

6. Is the circ package incompatible with the McGill ETD Class? If not, what do I do?

Yes it is. You should save your circuit drawings as separate image files and submit them along with the other files which constitute your thesis.

7. My page format is set to A4. How can I change it to letter (8.5x11)?

This was a bug in the previous style-sheet packages which has been fixed in the 16.02.2005 (Version 5) package which you can download here.

8. When I compile my documents to pdf, I get a LaTeX warning which states: Unused global option(s):[letterpaper]. What should I do?

Compiling directly to pdf will yield incorrect paper size. You should compile to ps, and then convert to pdf using ghostview.

9. Since I changed \caption for \FigureCaption, I have been having problems that didn't arise when I was using \caption[]{}. Does \FigureCaption not support the optional argument []?

This was a bug in the previous style-sheet packages which has been fixed in the 16.02.2005 (Version 5) package which you can download here.

10. How do I create bold text in an index?

You should use the \textbf command.

11. My title is multi-lined and displays incorrectly. What should I do?

This was a bug in the previous style-sheet packages which has been fixed in the 22.02.2005 (Version 6) package which you can download here.

12. There's a blank page inserted in front of my index. What should I do?

This was a bug in the previous style-sheet packages which has been fixed in the 22.02.2005 (Version 6) package which you can download here.

13. Can I use TexShade with the McGill ETD LaTeX style-sheet?

No. The problem with TexShade is a result of an incompatibility between the TexShade package (which is still in beta incidentally) and the right justification package. You must disable the latter if they wish to use TexShade.

14. How can I create a subdirectory?

You can add a subdirectory by editing the mcgilletdclass.cls. Note: Do not change any of the commands in this file! Only perform the task listed below:

1. Make sure directory names have no spaces (may use underscore, instead).
2. Extract all files from mcgilletdlatexss.zip to current directory, which will contain .TEX file (may delete install.html and mcgilletdsample.pdf).
3. Place setspace.sty and ulem.sty in a subfolder. Extract all files from everysel.zip, ragged2e.zip, and sectsty.zip to the same subfolder.
4. Use LaTeX / PCTex to edit mcgilletdclass.cls in current directory and add the following first line, just after the comments section: \def\input@path{{SUBDIRECTORY/}} .

Because our LaTeX stylesheet supports multiple indexes, you can add a list of abbreviation or other things which you want to include. Therefore, the \printindex command is a little different from the default one. Our \printindex is defined as following:

• \printindex[0]{1}{2}{3}
• 0: refers to the name of the index; for this case, it should be ListOfAbbr.
• 2: The heading of the index starting page.
3: Some textual information about the index, if necessary.

You can also consult our sample LaTeX file and documentation in which the command is clearly defined and documented.

15. I followed the instructions given: I placed \makeindex[ListOfAbbr] in the preamble. Right before the \printindex command, I inserted the list of my abbreviations, e.g. \index[ListOfAbbr]{K@Kelvin}, etc. When I typeset my document, the title (List of Abbreviations) appeared on a new page where I inserted the \printindex command (in bold, however, while the other headings are plain). The list of abbreviations appeared on the next page, under the heading "Index" and the list contained only the full name (i.e. the word after the @ sign in the \index command), comma, and then a page number. Am I missing something?

Make sure that there are no empty lines between the arguments, e.g.

$P$ - set of procedural shaders in the library

$p_i$ - and individual shader from the set $P$

$\vec{x}$ - a parameter vector

should be written as:

$P$ - set of procedural shaders in the library
$p_i$ - and individual shader from the set $P$
$\vec{x}$ - a parameter vector

16. I get a runaway argument error in my appendix file. What's wrong?

Fill all empty lines in the apprendix source file with a % at the beginning.

17. I have inserted a figure and labeled it using '\label' inside the 'figure' environment so that I can reference it from somewhere in the text. But, when I use '\ref' it gives me the section number instead of the figure number. Is the '\label' option not supported in the ETD class?

You should be using '\label' inside the FigureCaption, otherwise, the section number will display. For example

\FigureCaption{\label{fig:1}A Resized Figure}

should display the correct Figure number. You can refer to the figure normally as \ref{fig:1}.

Click Cheryl [dot] Bethelmy [at] mcgill [dot] ca (here) to submit a question.