Fossil SCM
Improve some comments.
Commit
dda5d11d98bfdc1febe618f5039ae58c53578d7f
Parent
ea7813da5680daf…
1 file changed
+11
-3
M
src/th.c
+11
-3
| --- src/th.c | ||
| +++ src/th.c | ||
| @@ -2906,11 +2906,15 @@ | ||
| 2906 | 2906 | /* |
| 2907 | 2907 | ** Appends all currently registered command names to the specified list |
| 2908 | 2908 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2909 | 2909 | ** error. |
| 2910 | 2910 | */ |
| 2911 | -int Th_ListAppendCommands(Th_Interp *interp, char **pzList, int *pnList){ | |
| 2911 | +int Th_ListAppendCommands( | |
| 2912 | + Th_Interp *interp, /* Interpreter context */ | |
| 2913 | + char **pzList, /* OUT: List of command names */ | |
| 2914 | + int *pnList /* OUT: Number of command names */ | |
| 2915 | +){ | |
| 2912 | 2916 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2913 | 2917 | interp, sizeof(Th_InterpAndList) |
| 2914 | 2918 | ); |
| 2915 | 2919 | p->interp = interp; |
| 2916 | 2920 | p->pzList = pzList; |
| @@ -2923,11 +2927,15 @@ | ||
| 2923 | 2927 | /* |
| 2924 | 2928 | ** Appends all variable names for the current frame to the specified list |
| 2925 | 2929 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2926 | 2930 | ** error. If the current frame cannot be obtained, TH_ERROR is returned. |
| 2927 | 2931 | */ |
| 2928 | -int Th_ListAppendVariables(Th_Interp *interp, char **pzList, int *pnList){ | |
| 2932 | +int Th_ListAppendVariables( | |
| 2933 | + Th_Interp *interp, /* Interpreter context */ | |
| 2934 | + char **pzList, /* OUT: List of variable names */ | |
| 2935 | + int *pnList /* OUT: Number of variable names */ | |
| 2936 | +){ | |
| 2929 | 2937 | Th_Frame *pFrame = getFrame(interp, 0); |
| 2930 | 2938 | if( pFrame ){ |
| 2931 | 2939 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2932 | 2940 | interp, sizeof(Th_InterpAndList) |
| 2933 | 2941 | ); |
| @@ -2946,11 +2954,11 @@ | ||
| 2946 | 2954 | ** Appends all array element names for the specified array variable to the |
| 2947 | 2955 | ** specified list and returns TH_OK upon success. Any other return value |
| 2948 | 2956 | ** indicates an error. |
| 2949 | 2957 | */ |
| 2950 | 2958 | int Th_ListAppendArray( |
| 2951 | - Th_Interp *interp, | |
| 2959 | + Th_Interp *interp, /* Interpreter context */ | |
| 2952 | 2960 | const char *zVar, /* Pointer to variable name */ |
| 2953 | 2961 | int nVar, /* Number of bytes at nVar */ |
| 2954 | 2962 | char **pzList, /* OUT: List of array element names */ |
| 2955 | 2963 | int *pnList /* OUT: Number of array element names */ |
| 2956 | 2964 | ){ |
| 2957 | 2965 |
| --- src/th.c | |
| +++ src/th.c | |
| @@ -2906,11 +2906,15 @@ | |
| 2906 | /* |
| 2907 | ** Appends all currently registered command names to the specified list |
| 2908 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2909 | ** error. |
| 2910 | */ |
| 2911 | int Th_ListAppendCommands(Th_Interp *interp, char **pzList, int *pnList){ |
| 2912 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2913 | interp, sizeof(Th_InterpAndList) |
| 2914 | ); |
| 2915 | p->interp = interp; |
| 2916 | p->pzList = pzList; |
| @@ -2923,11 +2927,15 @@ | |
| 2923 | /* |
| 2924 | ** Appends all variable names for the current frame to the specified list |
| 2925 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2926 | ** error. If the current frame cannot be obtained, TH_ERROR is returned. |
| 2927 | */ |
| 2928 | int Th_ListAppendVariables(Th_Interp *interp, char **pzList, int *pnList){ |
| 2929 | Th_Frame *pFrame = getFrame(interp, 0); |
| 2930 | if( pFrame ){ |
| 2931 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2932 | interp, sizeof(Th_InterpAndList) |
| 2933 | ); |
| @@ -2946,11 +2954,11 @@ | |
| 2946 | ** Appends all array element names for the specified array variable to the |
| 2947 | ** specified list and returns TH_OK upon success. Any other return value |
| 2948 | ** indicates an error. |
| 2949 | */ |
| 2950 | int Th_ListAppendArray( |
| 2951 | Th_Interp *interp, |
| 2952 | const char *zVar, /* Pointer to variable name */ |
| 2953 | int nVar, /* Number of bytes at nVar */ |
| 2954 | char **pzList, /* OUT: List of array element names */ |
| 2955 | int *pnList /* OUT: Number of array element names */ |
| 2956 | ){ |
| 2957 |
| --- src/th.c | |
| +++ src/th.c | |
| @@ -2906,11 +2906,15 @@ | |
| 2906 | /* |
| 2907 | ** Appends all currently registered command names to the specified list |
| 2908 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2909 | ** error. |
| 2910 | */ |
| 2911 | int Th_ListAppendCommands( |
| 2912 | Th_Interp *interp, /* Interpreter context */ |
| 2913 | char **pzList, /* OUT: List of command names */ |
| 2914 | int *pnList /* OUT: Number of command names */ |
| 2915 | ){ |
| 2916 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2917 | interp, sizeof(Th_InterpAndList) |
| 2918 | ); |
| 2919 | p->interp = interp; |
| 2920 | p->pzList = pzList; |
| @@ -2923,11 +2927,15 @@ | |
| 2927 | /* |
| 2928 | ** Appends all variable names for the current frame to the specified list |
| 2929 | ** and returns TH_OK upon success. Any other return value indicates an |
| 2930 | ** error. If the current frame cannot be obtained, TH_ERROR is returned. |
| 2931 | */ |
| 2932 | int Th_ListAppendVariables( |
| 2933 | Th_Interp *interp, /* Interpreter context */ |
| 2934 | char **pzList, /* OUT: List of variable names */ |
| 2935 | int *pnList /* OUT: Number of variable names */ |
| 2936 | ){ |
| 2937 | Th_Frame *pFrame = getFrame(interp, 0); |
| 2938 | if( pFrame ){ |
| 2939 | Th_InterpAndList *p = (Th_InterpAndList *)Th_Malloc( |
| 2940 | interp, sizeof(Th_InterpAndList) |
| 2941 | ); |
| @@ -2946,11 +2954,11 @@ | |
| 2954 | ** Appends all array element names for the specified array variable to the |
| 2955 | ** specified list and returns TH_OK upon success. Any other return value |
| 2956 | ** indicates an error. |
| 2957 | */ |
| 2958 | int Th_ListAppendArray( |
| 2959 | Th_Interp *interp, /* Interpreter context */ |
| 2960 | const char *zVar, /* Pointer to variable name */ |
| 2961 | int nVar, /* Number of bytes at nVar */ |
| 2962 | char **pzList, /* OUT: List of array element names */ |
| 2963 | int *pnList /* OUT: Number of array element names */ |
| 2964 | ){ |
| 2965 |