[latex3-commits] [git/latex3] master: Auto-detect internal functions in l3doc [ci skip] (4b803e5)

[Bruno Le Floch]

On 11/30/2017 11:13 AM, Joseph Wright wrote:
> On 30/11/2017 16:11, Bruno Le Floch wrote:
>>>
>>>      Auto-detect internal functions in l3doc [ci skip]
>>>           I have essentially merged "[aux]" and "[int]", retaining
>>> the latter in
>>>      the documentated part for cases where internal status might need
>>> to be
>>>      forced (non-standard names, e.g. l3keys, though we should
>>> perhaps try to
>>>      cut down these cases). At present, the variables, etc., are left in
>>>      place.
>>
>> I couldn't find such l3keys examples.  What do you have in mind?  (I
>> agree it is useful to be able to force the internal status.)
>>
>> Bruno
> 
> Well these are dynamic so don't show up in the docs :)
> 
> I decided to store keys (and messages) somewhere with 'friendly' names,
> so they are
> 
>     /key code > [name]
> 
> and so on (see \c_@@_code_root_tl, etc., in l3keys).
> 
> Joseph

Ah, ok, but they are not documented so that's ok.  The \::n and friends
are another example where having [int] is useful.

By the way, I changed l3doc a little bit to detect mixtures of internal
and noninternal names in a given macro environment.  That gives errors
for things like \begin{macro}[EXP]{\if_int_compare:w, \@@_to_roman:w}.
I'll try to fix them then commit.

Bruno