XDDTS(1)
NAME
xddts - an X-11 interface to ClearDDTS
SYNOPSIS
xddts [X resource options -name name -title title] [-z]
xddts [X resource options -name name -title title] [-z] -c
xddts [X resource options -name name -title title] -[qQ]
table_file
xddts [X resource options -name name -title title] [-z] -i bugid
DESCRIPTION
xddts is an interactive X-Windows graphical user interface
for ClearDDTS. The program can create, modify, and view
defect items as well as generate reports and metrics.
Options
When xddts is invoked the workspace initially contains those
defects which match the characteristics set up in the user's
.ddtsrc file. The program may use the following options to
alter its initial behavior:
-z This option changes the SQL code generated with the
hasno and notequal operators. The resulting SQL
query does not match fields that have null values,
conforming to SQL standards.
-c Immediately enter submit mode to create a New Defect
record. The program will start with an empty workspace
and start the Submit Procedure.
-i Initially load the index with the the defect item
whose bugid is listed on the command line.
-[qQ] table_file
Immediately enter submit mode to create a New Defect
record. The program will start with an empty workspace
and start the Submit Procedure. It will then try to
load the fields in the table_ file passed on the
command line as default fields for the bug submission.
xddts will exit immediately if the submission is
aborted or immediately after the submission is
committed. If the option is specified as a -Q, the
table_ file will be removed when xddts goes to EOJ.
A table_file is a file in the dfile format. See
dfile(5).
X Resource Options
The program accepts most standard X command line options as
well as the specially defined options -name and -title.
Some of the more useful ones are:
-display display name
Use the display mentioned on the command line as the
server to attach the X process to.
-geometry geometry spec
Use the specified geometry spec to place the xddts
windows on the display. Use only the placement
portions of the display spec and let the program
figure out the display size. That is use the command
xddts -geometry +3+3 to place the xddts main window
near the upper left portion of the display screen.
-name name
The -name option specifies the name under which
resources for the application should be found. This
option is useful in shell aliases to distinguish
between invocations of an application, without
resorting to creating links to alter the executable
file name.
-title title
The -title option changes the Title of the main
(xddts) window to "title".
Note that -rv and -bw are not honored by xddts.
Environment Variables
The following environment variables are used by xddts:
DISPLAY The default display name is contained in this
variable. If it is not set, the xddts program
will fail to connect to the X Server, display an
error message and abort. The default value of
DISPLAY is usually :0.0 (if you are running the
client on the same machine the server is running
on).
EDITOR The name of the editor to use when creating or
modifying enclosures. This editor is only used if
one of the external editor shells is used to
invoke the editor process. Otherwise xddts
program uses a built-in editor and this
environment variable has no significance.
OPENWINHOME
This variable (if set) indicates that the
/usr/openwin directory may really be at some other
location and will use this to find it.
PRINTER The name of the Printing device which the print
spooler lp will use for printing reports. This
may be overridden in the users .ddtsrc file. If
this variable is set then the printer destination
will effectively be set to lp -d<printer name>.
XAPPLRESDIR
This variable (if set) tells xddts what directory
to look in to find a user specific XDdts
application resource definition file. Use of this
environment variable and a corresponding XDdts
file allows the user to customize the behavior of
xddts. Note that the value of this variable must
end with a '/'.
FILES
$HOME/.ddtsrc
The users .ddtsrc file - Program defaults are
saved there.
~ddts/etc/XDdts
The X Resource file used by xddts. The user may
override portions of this file by either creating
an individual XDdts file or by initializing
resource variables in the user's .Xdefaults file.
~ddts/etc/XkeysymDB
The XKeysymDB file used by xddts
SEE ALSO
bugs(1), findbug(1), dumpbug(1),
sortbug(1), dfile(5), ClearDDTS User's Guide