interface file parameter

interface file parameter

[Philipp Gesang]

[-- Attachment #1.1: Type: text/plain, Size: 1486 bytes --]

Hi all,

in an interface xml definition, what is the notation for an argument value
that is a filename? I'm just unsure whether to specify it as “cd:text”
or “cd:name”. Example:

···8<··········································································

<cd:parameter name="file">
  <cd:constant type="default-file.name" default="yes"/>
  <!--maybe the following:-->
  <cd:constant type="cd:text"/>
  <!--or this one:-->
  <cd:constant type="cd:name"/>
</cd:parameter>

···8<··········································································

Also, is there a way to specify conditioned arguments (apart from
separate setups)? E.g. parameter “p” has an effect iff parameter “q” is
given as well?

···8<··········································································

<cd:parameter name="p" depends="q">
  ...

···8<··········································································

Or are interface files obsolete by now due to texshow's migrating to the
wiki? Thanks,

Philipp

-- 
()  ascii ribbon campaign - against html e-mail
/\  www.asciiribbon.org   - against proprietary attachments

[-- Attachment #1.2: Type: application/pgp-signature, Size: 198 bytes --]

[-- Attachment #2: Type: text/plain, Size: 486 bytes --]

___________________________________________________________________________________
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://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: interface file parameter

[Wolfgang Schuster]

  Am 16.08.10 14:50, schrieb Philipp Gesang:
> Hi all,
>
> in an interface xml definition, what is the notation for an argument value
> that is a filename? I'm just unsure whether to specify it as “cd:text”
> or “cd:name”.

It’s “cd:name”.

> Also, is there a way to specify conditioned arguments (apart from
> separate setups)? E.g. parameter “p” has an effect iff parameter “q” is
> given as well?

No, the file lists only the available parameters, dependences have to be 
explained in your text.

The interface file shows only how many parameters a command has and 
which arguments it does accept.

Interface file aren't obsolete because you need them to show the command 
syntax in your documetation
for a module, see here: 
http://bitbucket.org/wolfs/fancybreak/src/tip/files/t-fancybreak.mkiv

Wolfgang

___________________________________________________________________________________
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://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: interface file parameter

[Taco Hoekwater]

On 08/16/2010 02:58 PM, Wolfgang Schuster wrote:
> Am 16.08.10 14:50, schrieb Philipp Gesang:
>> Hi all,
>>
>> in an interface xml definition, what is the notation for an argument
>> value
>> that is a filename? I'm just unsure whether to specify it as “cd:text”
>> or “cd:name”.
>
> It’s “cd:name”.
>
>> Also, is there a way to specify conditioned arguments (apart from
>> separate setups)? E.g. parameter “p” has an effect iff parameter “q” is
>> given as well?
>
> No, the file lists only the available parameters, dependences have to be
> explained in your text.
>
> The interface file shows only how many parameters a command has and
> which arguments it does accept.

If you want, you can create multiple xml entries for a single command,
this is what e.g. \definebodyfont does in cont-en.xml

Best wishes,
Taco
___________________________________________________________________________________
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://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: interface file parameter

[Wolfgang Schuster]

  Am 16.08.10 14:58, schrieb Wolfgang Schuster:
>  Am 16.08.10 14:50, schrieb Philipp Gesang:
>> Hi all,
>>
>> in an interface xml definition, what is the notation for an argument 
>> value
>> that is a filename? I'm just unsure whether to specify it as “cd:text”
>> or “cd:name”.
>
> It’s “cd:name”.

I forgot there is also “cd:file” but Hans use both in cont-en.xml and 
you can now choose with you want to use.

Wolfgang

___________________________________________________________________________________
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://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: interface file parameter

[Philipp Gesang]

[-- Attachment #1.1: Type: text/plain, Size: 180 bytes --]

Wolfgang, Taco: thanks very much for your answers!

Philipp

-- 
()  ascii ribbon campaign - against html e-mail
/\  www.asciiribbon.org   - against proprietary attachments

[-- Attachment #1.2: Type: application/pgp-signature, Size: 198 bytes --]

[-- Attachment #2: Type: text/plain, Size: 486 bytes --]

___________________________________________________________________________________
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://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________