DCLEXEC(1)

NAME
dclexec - execute a command with DCL options converted to environment variables

SYNOPSIS
dclexec command [ options ]

DESCRIPTION
dclexec is a wrapper utility included in the GFD Dennou Club Library (DCL). It executes the specified command while setting environment variables derived from DCL-style command-line arguments. This is useful for programs that expect DCL runtime parameters (like window size or colormap settings) to be provided via environment variables rather than direct command-line arguments.

  Transformation Rule
The program scans arguments starting from the second parameter (the first parameter is the target command). If an argument matches the DCL option format:

    -xx_yy=value

It performs the following transformation:

1.  Removes the leading hyphen (-).

2.  Converts the parameter name part (before the equals sign) to uppercase.

3.  Prefixes it with the env command.

For example, the argument -sw:lwait=false is converted to the environment variable export SW:LWAIT=false.

OPTIONS
dclexec parses arguments that follow the format -xx:yy=value (specifically, arguments starting with a hyphen, having a colon at the 4th character, and containing an equals sign).

EXAMPLES
To run a program named my_dcl_prog with specific DCL parameters converted to environment variables:

    $ dclexec my_dcl_prog -sw:width=500 -sw:iclrmap=10

This effectively executes:

    $ env SW:WIDTH=500 SW:ICLRMAP=10 my_dcl_prog

AUTHORS
Youhei SASAKI <uwabami@gfd-dennou.org>, GFD Dennou Club

SEE ALSO
env(1), dclconfig(1)