# Acro package: starred versions are not working?

As far as I understood from the documentation, the starred version of \ac command and friends shall not mark acronym as used, thus it would not appear in the acronym list. But in the example below, \ac and \ac* behave the same.

\documentclass{article}

\usepackage{acro}

\newcommand*{\acro}[3]{\DeclareAcronym{#1}{short=#2,long=#3}}
\acro{CDMA}{CDMA}{code division multiple access}

\begin{document}

\ac*{RAT}

\ac{CDMA}

\printacronyms

\end{document}


• I think you're misunderstanding: with \ac*{RAT}, the acronym will appear expanded, but also expanded at the first subsequent \ac{RAT}. – egreg Oct 16 '14 at 21:58
• @egreg in documentation it says "If you use the starred variant an acronym will not be marked as used" and for only-used = true it says "This option is true as default. It means that only acronyms that are actually used in the document are printed in the list." – cacamailg Oct 16 '14 at 22:04
• I think the documentation is a bit confusing with this double usage of “used” in “marked as used” or “actually used”. But I might be wrong and this is a bug in the package. – egreg Oct 16 '14 at 22:09
• Let's wait to see if the author of the package can help us on that clarification. – cacamailg Oct 16 '14 at 22:16
• @egreg is right and my choice of words in the manual is misleading... – clemens Oct 17 '14 at 6:18

The manual is misleading or at least unclear. The starred versions do not prevent the acronyms from being written to the list of acronyms. Usage in this context means usage as far as the \ac macro is concerned (also, but this is probably not a good choice and maybe I should change it) as far as the single=true option is concerned.

If you want to ensure that an acronym is excluded from the list the easiest way seems to me to add a class to its properties and exclude the class from the list:

\documentclass{article}

\usepackage{acro}

\DeclareAcronym{RAT}{
short = RAT ,
long = radio access technology ,
class = invisible
}
\DeclareAcronym{CDMA}{
short = CDMA ,
long  =code division multiple access
}

\begin{document}

\ac{RAT}

\ac{CDMA}

\printacronyms[exclude-classes=invisible]

\end{document}