1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
.TH DCLEXEC 1 "2026-01-23" "DCL 7.5.2" "GFD Dennou Club Library"
.SH NAME
dclexec \- execute a command with DCL options converted to environment variables
.SH SYNOPSIS
.B dclexec
.I command
[
.I options
]
.SH DESCRIPTION
.B dclexec
is a wrapper utility included in the GFD Dennou Club Library (DCL). It executes the specified \fIcommand\fP 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.
.SS "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:
.PP
.RS
.B -xx:yy=value
.RE
.PP
It performs the following transformation:
.IP 1. 4
Removes the leading hyphen (\-).
.IP 2. 4
Converts the parameter name part (before the equals sign) to uppercase.
.IP 3. 4
Prefixes it with the \fBenv\fP command.
.PP
For example, the argument \fB-sw:lwait=false\fP is converted to the environment variable export \fBSW:LWAIT=false\fP.
.SH OPTIONS
.B dclexec
parses arguments that follow the format \fB-xx:yy=value\fP (specifically, arguments starting with a hyphen, having a colon at the 4th character, and containing an equals sign).
.B Note:
Any arguments that do not match this specific DCL option format are ignored and are \fBnot\fP passed to the target command.
.SH EXAMPLES
To run a program named \fBmy_dcl_prog\fP with specific DCL parameters converted to environment variables:
.PP
.RS
$ dclexec my_dcl_prog -sw:width=500 -sw:iclrmap=10
.RE
.PP
This effectively executes:
.PP
.RS
$ env SW:WIDTH=500 SW:ICLRMAP=10 my_dcl_prog
.RE
.SH AUTHORS
Youhei SASAKI <uwabami@gfd-dennou.org>, GFD Dennou Club
.SH SEE ALSO
.BR env (1),
.BR dclconfig (1)
|
