
8/2/2001
app_notes.txt, part of the IEEEtran.cls collection
http://www.ctan.org/tex-archive/macros/latex/contrib/supported/IEEEtran/
by
Michael Shell
mshell@ece.gatech.edu


Here some miscellaneous application notes and topics on the use of 
IEEEtran.cls:


     1. *** NAME CLASHES WHEN USED WITH PACKAGES SUCH AS AMSTEX, AMSTHM ***

  Some of you have been using IEEEtran.cls with other packages and 
encountered name clashes. A name clash error occurs when a package attempts
to define a new command with the same name as one already defined by
IEEEtran.cls. For instance, amsthm will error out with:

! LaTeX Error: Command \proof already defined.

because it was not expecting \proof to already be defined. Fortunately, 
the workaround is easy and will allow you to choose which versions of the
commands you want to use.

A good approach is to save and then undefine any offending IEEEtran commands
prior to the loading of the error generating packages:

\documentclass[...]{IEEEtran}

% save and then undefine the offending command
% we need \makeatletter because \@undefined uses the special @ character.
\makeatletter
\let\IEEEproof\proof
\let\IEEEendproof\endproof
\let\proof\@undefined
\let\endproof\@undefined
\makeatother

% now load the package, it will be unaware that \proof ever existed
\usepackage{amsmath,amsthm,amscd,amssymb} 

% if you want to use the IEEEtran.cls \proof, just redefine from
% what you saved earlier:
\let\proof\IEEEproof
\let\endproof\IEEEendproof

% now proceed as usual


Thanks to Dr. Ming Jiang for reporting this issue.

                                     ******




MDS 8/2/2001    
    
**********************************************************************
 Legal Notice:
 This code and advice is offered as-is without any warranty either
 expressed or implied; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE!
 User assumes all risk.
 In no event shall IEEE or any contributor to this code
 be liable for any damages or losses, including, but not limited to,
 incidental, consequential, or any other damages, resulting from the
 use or misuse of any information contained here.
 
 All statements made here are the opinions of their respective
 authors and are not necessarily endorsed by the IEEE.

 This code/text is distributed under the Perl Artistic License 
 ( http://language.perl.com/misc/Artistic.html ) 
 and may be freely used, distributed and modified.
 Please retain the contribution notices and credits.
**********************************************************************

