Deprecate Tcl_GetAlias()

Author: jan.nijtmans

doc/CrtAlias.3

@@ -168,16 +168,17 @@ restrictions on how they are related.
 that it takes a vector of values to pass as additional arguments instead
 of a vector of strings.
 .PP
-\fBTcl_GetAlias\fR returns information about an alias \fIaliasName\fR
+\fBTcl_GetAliasObj\fR returns information in the form of a pointer to
+a vector of Tcl_Obj structures about an alias \fIaliasName\fR
 in \fIinterp\fR. Any of the result fields can be \fBNULL\fR, in
 which case the corresponding datum is not returned. If a result field is
 non\-\fBNULL\fR, the address indicated is set to the corresponding datum.
 For example, if \fItargetNamePtr\fR is non\-\fBNULL\fR it is set to a
 pointer to the string containing the name of the target command.
 .PP
-\fBTcl_GetAliasObj\fR is similar to \fBTcl_GetAlias\fR except that it
-returns a pointer to a vector of Tcl_Obj structures instead of a vector of
-strings.
+\fBTcl_GetAlias\fR is similar to \fBTcl_GetAliasObj\fR except that it
+returns a pointer to a vector of string instead of a vector of
+Tcl_Obj structures. \fBTcl_GetAlias\fR is deprecated.
 .PP
 \fBTcl_ExposeCommand\fR moves the command named \fIhiddenCmdName\fR from
 the set of hidden commands to the set of exposed commands, putting

generic/tcl.decls

@@ -470,7 +470,7 @@ declare 145 {
 declare 146 {
     int Tcl_Flush(Tcl_Channel chan)
 }
-declare 148 {
+declare 148 {deprecated {Use Tcl_GetAliasObj}} {
     int Tcl_GetAlias(Tcl_Interp *interp, const char *childCmd,
 	    Tcl_Interp **targetInterpPtr, const char **targetCmdPtr,
 	    int *argcPtr, const char ***argvPtr)

generic/tclDecls.h

@@ -428,7 +428,8 @@ EXTERN Tcl_HashEntry *	Tcl_FirstHashEntry(Tcl_HashTable *tablePtr,
 EXTERN int		Tcl_Flush(Tcl_Channel chan);
 /* Slot 147 is reserved */
 /* 148 */
-EXTERN int		Tcl_GetAlias(Tcl_Interp *interp,
+TCL_DEPRECATED("Use Tcl_GetAliasObj")
+int			Tcl_GetAlias(Tcl_Interp *interp,
 				const char *childCmd,
 				Tcl_Interp **targetInterpPtr,
 				const char **targetCmdPtr, int *argcPtr,
@@ -2027,7 +2028,7 @@ typedef struct TclStubs {
     Tcl_HashEntry * (*tcl_FirstHashEntry) (Tcl_HashTable *tablePtr, Tcl_HashSearch *searchPtr); /* 145 */
     int (*tcl_Flush) (Tcl_Channel chan); /* 146 */
     void (*reserved147)(void);
-    int (*tcl_GetAlias) (Tcl_Interp *interp, const char *childCmd, Tcl_Interp **targetInterpPtr, const char **targetCmdPtr, int *argcPtr, const char ***argvPtr); /* 148 */
+    TCL_DEPRECATED_API("Use Tcl_GetAliasObj") int (*tcl_GetAlias) (Tcl_Interp *interp, const char *childCmd, Tcl_Interp **targetInterpPtr, const char **targetCmdPtr, int *argcPtr, const char ***argvPtr); /* 148 */
     int (*tcl_GetAliasObj) (Tcl_Interp *interp, const char *childCmd, Tcl_Interp **targetInterpPtr, const char **targetCmdPtr, int *objcPtr, Tcl_Obj ***objv); /* 149 */
     void * (*tcl_GetAssocData) (Tcl_Interp *interp, const char *name, Tcl_InterpDeleteProc **procPtr); /* 150 */
     Tcl_Channel (*tcl_GetChannel) (Tcl_Interp *interp, const char *chanName, int *modePtr); /* 151 */

generic/tclInterp.c

@@ -1288,7 +1288,7 @@ Tcl_CreateAliasObj(
  *
  *----------------------------------------------------------------------
  */
-
+#ifndef TCL_NO_DEPRECATED
 int
 Tcl_GetAlias(
     Tcl_Interp *interp,		/* Interp to start search from. */
@@ -1334,6 +1334,7 @@ Tcl_GetAlias(
     }
     return TCL_OK;
 }
+#endif /* TCL_NO_DEPRECATED */
 
 /*
  *----------------------------------------------------------------------

generic/tclStubInit.c

@@ -74,6 +74,7 @@
 # define TclGetStringFromObj 0
 # define TclGetBytesFromObj 0
 # define TclGetUnicodeFromObj 0
+# define Tcl_GetAlias 0
 #endif
 #undef Tcl_Close
 #define Tcl_Close 0