The tkaenc command is used to provide a GUI interface to aenc(1). Its use should be self-evident to anyone familiar with Aegis.
The top line of the screen contains button for selecting the project. It will be defaulted using the usual Aegis defaulting rules. Click on the buttons to obtain a pick list if you want to change it; then double-click an item to select it. (I would have used tk_optionMenu, but it doesn't have a scroll bar, even when all the items don't fit on the screen.)
The middle section contains text entry areas, for editing the
brief_description and description fields of the change
attributes. The text wraps in a natural way, both here and in (say)
tkaenc -list change_details” listing, so only use newlines
to indicate end-of-paragraph.
The lower section contains three boxes. The first is the testing required for the change - select as many or as few as is appropriate. The second a set of radio buttons to select the change cause - pick one.
The third box is whether to begin development immediately (it will also run the aedb(1) command), or whether to leave the change in awaiting development.
The “OK” and “Cancel” buttons do what you expect. The cancel button simply quits. The OK button runs the aenc(1) command - if anything goes wrong (e.g. asking for testing exemptions you can't have) then the error message will be displayed in the message area at the bottom of the window.
The number of the change will be printed on a message on the standard output, just as for a normal aenc(1) command.
The tkaenc command will exit with a status of 1 on any error. The tkaenc command will only exit with a status of 0 if there are no errors.
See aegis(1) for a list of environment variables which may affect
aepconf(5) for the project configuration file's
project_specific field for how to set environment variables for
all commands executed by Aegis.
tkaenc version 4.22 Copyright (C) 1991-2006 Peter Miller; All rights reserved.
The tkaenc program comes with ABSOLUTELY NO WARRANTY; for details use the 'tkaenc -VERSion License' command. This is free software and you are welcome to redistribute it under certain conditions; for details use the 'tkaenc -VERSion License' command.