LATEX-L Archives

Mailing list for the LaTeX3 project

LATEX-L@LISTSERV.UNI-HEIDELBERG.DE

Options: Use Forum View

Use Monospaced Font
Show Text Part by Default
Show All Mail Headers

Message: [<< First] [< Prev] [Next >] [Last >>]
Topic: [<< First] [< Prev] [Next >] [Last >>]
Author: [<< First] [< Prev] [Next >] [Last >>]

Print Reply
Subject:
From:
Joseph Wright <[log in to unmask]>
Reply To:
Mailing list for the LaTeX3 project <[log in to unmask]>
Date:
Sat, 5 Sep 2015 08:23:20 +0100
Content-Type:
text/plain
Parts/Attachments:
text/plain (26 lines)
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

ATOM RSS1 RSS2