[Tex/LaTex] What do \makeatletter and \makeatother do

catcodesmacros

Many LaTeX “hacks” begin with \makeatletter and end with \makeatother. What do these commands do?

Best Answer

All characters in TeX are assigned a Category Code or "catcode". There are 16 catcodes in all, some containing just a single character, e.g. \ is (normally) catcode 0, {, catcode 1 etc. Normal characters are catcode 11; this category normally comprises all of the letter characters. The @ symbol is given the catcode of 12, which means it is not treated as a normal letter. The effects of this are that @ cannot normally be used in user document files as part of a multicharacter macro name. (All other non-letter characters are also forbidden in macro names: for example, \foo123, and \foo?! are not valid macro names.)

In LaTeX class and package files, however, @ is treated as a normal letter (catcode 11) and this allows package writers to make macro-names with @. The advantage of this is that such macro names are automatically protected from regular users: since they cannot use @ as a normal letter, there is no accidental way for a user to override or change a macro that is part of the internal workings of a package.

However, it is sometimes necessary in user documents to have access to such package-internal macros, and so the commands \makeatletter and \makeatother change the catcode of @ from 12 to 11 and 11 to 12, respectively.

In practical terms, if you need to modify a package internal macro that contains the @ symbol in its name, you will need to surround your modifications by these commands:

\makeatletter % changes the catcode of @ to 11
<your changes here>
\makeatother % changes the catcode of @ back to 12

The commands should not be used within .sty and .cls files themselves as they may conflict with the catcode changes that occurs when package and class files are loaded. For more information on this see Is it really bad to use \makeatletter and \makeatother in a package or class file?.

Related Solutions

[Tex/LaTex] How to make a command to display a custom title page

You need to move the \makeatletter and \makeatother outside of the \newcommand.

\makeatletter
\newcommand{\makecustomtitle}{%
  \begin{titlepage}
    \@title by \@author
  \end{titlepage}
}
\makeatother

The difference is that in the above set-up the category codes are changed at the time of definition; in your set-up they were attempting to change at the time of use.

Note that I've also added % to the end of the first line. Have a look at these links:

[Tex/LaTex] No \makeatletter required

Your definition defines a macro \my that is required to be followed by @macro followed by one argument (which is either a single token or a brace group). Thus this gives you the result.

Reason that this works this way is that normally @ is not a letter (but a symbol which is \catcode 12) so it would end the "macro name" but it then becomes part of the parameter text which is everything that is follows after the name up to the { which starts the replacement text. You can test this as follows:

\show\my
\my @macro {hi}  % should work too
\my {hi}         % error

LaTeX 's \newcommand complains as it builds up the macro definition differently and doesn't allow for delimited arguments.

Best Answer

Related Solutions

[Tex/LaTex] How to make a command to display a custom title page

[Tex/LaTex] No \makeatletter required

Related Question