LATEX-L Archives

Mailing list for the LaTeX3 project


Options: Use Classic View

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

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

Print Reply
Frank Mittelbach <[log in to unmask]>
Sun, 16 Mar 2014 10:14:30 +0100
text/plain (28 lines)
Am 15.03.2014 23:18, schrieb Michiel Helvensteijn:
> On Sat, Mar 15, 2014 at 6:08 PM, Joseph Wright
> <[log in to unmask]> wrote:
>> Working systematically, I notice that I use a few variants of core expl3
>> commands that have to be created. Based on the 'document everything
>> public' principle, these should be mentioned (they have 'public'
>> function names). On the other hand, they are 'nothing to do with me' as
>> all I'm doing is something like
>>    \cs_generate_variant:Nn \some_team_function:n { V }
> Would you have generated this variant for the public interface even if
> you didn't need it internally? That is, does it make sense on its own?
> If so, document it. If not, don't document it.

that's perfectly right if \some_team_function:n is really an interface 
of the package being defined. I maintain it is not alright if it is an 
interface of a different package or the kernel.

In that case any package that needs the variant should declare it (which
is an idempotent operation, so that's fine) but it avoids creating 
dependencies between packages that are unnecessary.