MIGRATION commands


PROGRAM NAME

kclrgetargs - Clear the main_get_args_call field in the main of a kroutine or xvroutine

DESCRIPTION

This program can be used to clear the -main_get_args_call field in the main routine of kroutines and xvroutines. The optional flag -rgw tells kclrgetargs to run the code generators after clearing this field, thereby putting the latest version of the call to the clui and pane parsing API. It was developed primarily to help migrate kroutines that were developed before the Khoros code generators supported the generation of continuous run processes. All new kroutines and xvroutines use the new API clui initialize API that supports continuous run, and with this program it is easy to update existing kroutines and xvroutines.

REQUIRED ARGUMENTS

-tb
type: string
desc: Toolbox to search
-oname
type: string
desc: Software object name

OPTIONAL ARGUMENTS

-rgw
type: flag
desc: Run ghostwriter after stripping the get args section

EXAMPLES

% kclrgetargs -tb testtoolbox -oname myobject -rgw
The -main_get_args_call section of myobject has been cleared
ghostwriter: done generating myobject man page
ghostwriter: done generating myobject.h
ghostwriter: done generating myobject.c
ghostwriter: done generating usage.c
ghostwriter: done generating myobject help page
ghostwriter: updating object database [TESTTOOLBOX::myobject]

SEE ALSO

ghostwriter(1), kcodegen(3)

RESTRICTIONS

Since the -main_get_args_call section of a kroutine or xvroutine is one of the fields that users are allowed to edit, running this program can potentially remove special code the user put in that section so that their program would do some special handling of the command line parameters.

REFERENCES

None

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.