Purpose/use of loadsetup interface *.xml files

[Stephen Gaito <stephen@perceptisys.co.uk>]

Hello,

Problem:
--------

I am having trouble getting a simple module's documentation to
load setup information.

Question:
---------

Where can I find up-to-date documentation on the load setup
interface file use and required format?

Background:
----------

I have a current standalone ConTeXt installation with only luatex(mkiv)
and all modules (updated yesterday).

I intend to write a number of ConTeXt modules to assist in my work.

My first module is ConTests a simple wrapper around lua's lunatest
framework. ( GitHub: stephengaito/ConTests )

As I work I like to write unit-tests and documentation
concurrently with the code itself (as much as possible).

I am basing my documentation effort on t-fancybreak.mkvi. As such I
have written a setup interface file t-contests.xml.

My directory structure is:

  t-contests/tex/context/interface/third/t-contests.xml
  t-contests/tex/context/third/ConTests/t-contests.mkiv
  t-contests/tex/context/third/ConTests/t-contests.lua

I am building my module documentation using:

  mtxrun --script modules --process t-contexts.mkiv

(inside the t-contests/tex/context/third/ConTests directory).

The resluting t-contests-mkiv.pdf file has 'MISSING SETUP' where I
would expect the \showsetup{loadSuite} output to be placed.

The mtxrun log output has the line:

  xml > core > load error in [id: setups:, file: .xml]:  empty xml file

I interpret this to mean that my interface file was not found (or
possibly not correctly specified).

The relevant contents of t-contests.mkiv are:
------------
%M \usemodule[contests]
%M \loadsetups[t-contests.xml]

\writestatus{loading}{ConTeXt User Module / ConTests}

%D \subject{Implementation}

\unprotect

\ctxloadluafile{t-contests}

%D \macros{loadSuite}
%D
%D \showsetup{loadSuite}

\def\loadSuite#1{\directlua{thirddata.contests.lunatest.loadSuite('#1.lua')}}

\protect \endinput
-----------------

The contents of t-contests.xml is:
--------------
<?xml version="1.0" encoding="UTF-8"?>

<!-- This is the ConTeXt interface for the t-contests module -->
<!-- We have based the structure of this interface on the t-fancybreak module -->

<cd:interface xmlns:cd="http://www.pragma-ade.com/commands" name="context" language="en" version="2010.06.21">

<cd:command name="loadSuite" generated="yes" file="t-contests.mkiv">
  <cd:sequence>
    <cd:string value="loadSuite"?> 
  </cd:sequence>
  <cd:arguments>
    <cd:content n="1" optional="no"/>
  </cd:arguments>
</cd:command>
  
</cd:interface>
-----------------

Any and all assistance would be greatly appreciated.

Regards,
Stephen Gaito
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : http://contextgarden.net
___________________________________________________________________________________