1/* 2 * tclAppInit.c -- 3 * 4 * Provides a default version of the main program and Tcl_AppInit 5 * function for Tcl applications (without Tk). 6 * 7 * Copyright (c) 1993 The Regents of the University of California. 8 * Copyright (c) 1994-1997 Sun Microsystems, Inc. 9 * Copyright (c) 1998-1999 by Scriptics Corporation. 10 * 11 * See the file "license.terms" for information on usage and redistribution of 12 * this file, and for a DISCLAIMER OF ALL WARRANTIES. 13 * 14 * RCS: @(#) $Id: tclAppInit.c,v 1.17 2007/04/16 13:36:35 dkf Exp $ 15 */ 16 17#include "tcl.h" 18 19#ifdef TCL_TEST 20 21#include "tclInt.h" 22 23extern Tcl_PackageInitProc Procbodytest_Init; 24extern Tcl_PackageInitProc Procbodytest_SafeInit; 25extern Tcl_PackageInitProc TclObjTest_Init; 26extern Tcl_PackageInitProc Tcltest_Init; 27 28#endif /* TCL_TEST */ 29 30#ifdef TCL_XT_TEST 31extern void XtToolkitInitialize _ANSI_ARGS_((void)); 32extern int Tclxttest_Init _ANSI_ARGS_((Tcl_Interp *interp)); 33#endif 34 35/* 36 *---------------------------------------------------------------------- 37 * 38 * main -- 39 * 40 * This is the main program for the application. 41 * 42 * Results: 43 * None: Tcl_Main never returns here, so this function never returns 44 * either. 45 * 46 * Side effects: 47 * Whatever the application does. 48 * 49 *---------------------------------------------------------------------- 50 */ 51 52int 53main( 54 int argc, /* Number of command-line arguments. */ 55 char **argv) /* Values of command-line arguments. */ 56{ 57 /* 58 * The following #if block allows you to change the AppInit function by 59 * using a #define of TCL_LOCAL_APPINIT instead of rewriting this entire 60 * file. The #if checks for that #define and uses Tcl_AppInit if it does 61 * not exist. 62 */ 63 64#ifndef TCL_LOCAL_APPINIT 65#define TCL_LOCAL_APPINIT Tcl_AppInit 66#endif 67 extern int TCL_LOCAL_APPINIT _ANSI_ARGS_((Tcl_Interp *interp)); 68 69 /* 70 * The following #if block allows you to change how Tcl finds the startup 71 * script, prime the library or encoding paths, fiddle with the argv, 72 * etc., without needing to rewrite Tcl_Main() 73 */ 74 75#ifdef TCL_LOCAL_MAIN_HOOK 76 extern int TCL_LOCAL_MAIN_HOOK _ANSI_ARGS_((int *argc, char ***argv)); 77#endif 78 79#ifdef TCL_XT_TEST 80 XtToolkitInitialize(); 81#endif 82 83#ifdef TCL_LOCAL_MAIN_HOOK 84 TCL_LOCAL_MAIN_HOOK(&argc, &argv); 85#endif 86 87 Tcl_Main(argc, argv, TCL_LOCAL_APPINIT); 88 89 return 0; /* Needed only to prevent compiler warning. */ 90} 91 92/* 93 *---------------------------------------------------------------------- 94 * 95 * Tcl_AppInit -- 96 * 97 * This function performs application-specific initialization. Most 98 * applications, especially those that incorporate additional packages, 99 * will have their own version of this function. 100 * 101 * Results: 102 * Returns a standard Tcl completion code, and leaves an error message in 103 * the interp's result if an error occurs. 104 * 105 * Side effects: 106 * Depends on the startup script. 107 * 108 *---------------------------------------------------------------------- 109 */ 110 111int 112Tcl_AppInit( 113 Tcl_Interp *interp) /* Interpreter for application. */ 114{ 115 if (Tcl_Init(interp) == TCL_ERROR) { 116 return TCL_ERROR; 117 } 118 119#ifdef TCL_TEST 120#ifdef TCL_XT_TEST 121 if (Tclxttest_Init(interp) == TCL_ERROR) { 122 return TCL_ERROR; 123 } 124#endif 125 if (Tcltest_Init(interp) == TCL_ERROR) { 126 return TCL_ERROR; 127 } 128 Tcl_StaticPackage(interp, "Tcltest", Tcltest_Init, 129 (Tcl_PackageInitProc *) NULL); 130 if (TclObjTest_Init(interp) == TCL_ERROR) { 131 return TCL_ERROR; 132 } 133 if (Procbodytest_Init(interp) == TCL_ERROR) { 134 return TCL_ERROR; 135 } 136 Tcl_StaticPackage(interp, "procbodytest", Procbodytest_Init, 137 Procbodytest_SafeInit); 138#endif /* TCL_TEST */ 139 140 /* 141 * Call the init functions for included packages. Each call should look 142 * like this: 143 * 144 * if (Mod_Init(interp) == TCL_ERROR) { 145 * return TCL_ERROR; 146 * } 147 * 148 * where "Mod" is the name of the module. (Dynamically-loadable packages 149 * should have the same entry-point name.) 150 */ 151 152 /* 153 * Call Tcl_CreateCommand for application-specific commands, if they 154 * weren't already created by the init functions called above. 155 */ 156 157 /* 158 * Specify a user-specific startup file to invoke if the application is 159 * run interactively. Typically the startup file is "~/.apprc" where "app" 160 * is the name of the application. If this line is deleted then no user- 161 * specific startup file will be run under any conditions. 162 */ 163 164#ifdef DJGPP 165 Tcl_SetVar(interp, "tcl_rcFileName", "~/tclsh.rc", TCL_GLOBAL_ONLY); 166#else 167 Tcl_SetVar(interp, "tcl_rcFileName", "~/.tclshrc", TCL_GLOBAL_ONLY); 168#endif 169 170 return TCL_OK; 171} 172 173/* 174 * Local Variables: 175 * mode: c 176 * c-basic-offset: 4 177 * fill-column: 78 178 * End: 179 */ 180