References: <55EA17A7.6060109@clear.net.nz>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:38.0)
            Gecko/20100101 Thunderbird/38.2.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Message-ID:  <55EA9868.9000308@morningstar2.co.uk>
Date:         Sat, 5 Sep 2015 08:23:20 +0100
Reply-To: Mailing list for the LaTeX3 project
              <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
Sender: Mailing list for the LaTeX3 project <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
From: Joseph Wright <joseph.wright@MORNINGSTAR2.CO.UK>
Subject: Re: expl3.pdf and naming auxiliary functions.
To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <55EA17A7.6060109@clear.net.nz>
Precedence: list
Envelope-To: <rainer.schoepf@GMX.NET>
Status: R

On 04/09/2015 23:13, Andrew Parsloe wrote:
> There are a couple of things in expl3.pdf that need updating. Section 5,
> the list of packages loaded with expl3 is no longer current,

I'll see what we can do about that part.

> Section 6, the penultimate bullet point,
> 
> "Use long, descriptive names for functions and variables, and for
> auxiliary functions
> use the parent function name plus aux, aux_i, aux_ii and so on"
> 
> contradicts the very last sentence in l3styleguide.pdf,
> 
> "The use of aux_i, aux_ii, etc. is discouraged as this conflicts with
> the convention used
> by \use_i:nn and related functions."
> 
> What is the advice now? (I'm trying to bring my less-than-consistent
> naming habits into conformity with recommended practice.)

I've adjusted this. The current advice is to use "auxi" and so on:
"aux_i" is too similar to for example \use_i:nn.

Joseph