Index: doc/Access.3 ================================================================== --- doc/Access.3 +++ doc/Access.3 @@ -65,7 +65,9 @@ .PP If \fIpath\fR exists, \fBTcl_Stat\fR returns 0 and the stat structure is filled with data. Otherwise, -1 is returned, and no stat info is given. .SH KEYWORDS stat, access +.SH CATEGORY +Operating System Interface .SH "SEE ALSO" Tcl_FSAccess(3), Tcl_FSStat(3) Index: doc/AddErrInfo.3 ================================================================== --- doc/AddErrInfo.3 +++ doc/AddErrInfo.3 @@ -308,5 +308,8 @@ .SH "SEE ALSO" Tcl_DecrRefCount(3), Tcl_IncrRefCount(3), Tcl_Interp(3), Tcl_ResetResult(3), Tcl_SetErrno(3), tclvars(n) .SH KEYWORDS error, value, value result, stack, trace, variable + +.SH CATEGORY +Commands Index: doc/Alloc.3 ================================================================== --- doc/Alloc.3 +++ doc/Alloc.3 @@ -88,5 +88,8 @@ of these procedures. To support Tcl's memory debugging within a module, use the macros rather than direct calls to \fBTcl_Alloc\fR, etc. .SH KEYWORDS alloc, allocation, free, malloc, memory, realloc, TCL_MEM_DEBUG + +.SH CATEGORY +Utilities Index: doc/AllowExc.3 ================================================================== --- doc/AllowExc.3 +++ doc/AllowExc.3 @@ -40,5 +40,8 @@ This is useful in cases where the caller can deal with exceptions such as \fBTCL_BREAK\fR or \fBTCL_CONTINUE\fR in a meaningful way. .SH KEYWORDS continue, break, exception, interpreter + +.SH CATEGORY +Invoking the Interpreter Index: doc/AppInit.3 ================================================================== --- doc/AppInit.3 +++ doc/AppInit.3 @@ -79,5 +79,8 @@ .SH "SEE ALSO" Tcl_Main(3) .SH KEYWORDS application, argument, command, initialization, interpreter + +.SH CATEGORY +Initialization Index: doc/AssocData.3 ================================================================== --- doc/AssocData.3 +++ doc/AssocData.3 @@ -83,5 +83,8 @@ .PP \fBTcl_DeleteAssocData\fR deletes an association with a specified key in the given interpreter. Then it calls the deletion procedure. .SH KEYWORDS association, data, deletion procedure, interpreter, key + +.SH CATEGORY +Utilities Index: doc/Async.3 ================================================================== --- doc/Async.3 +++ doc/Async.3 @@ -157,5 +157,8 @@ the interpreter's state by calling \fBTcl_RestoreInterpState\fR, and then returning the \fIcode\fR argument. .SH KEYWORDS asynchronous event, handler, signal, Tcl_SaveInterpState, thread + +.SH CATEGORY +The Event Loop Index: doc/BackgdErr.3 ================================================================== --- doc/BackgdErr.3 +++ doc/BackgdErr.3 @@ -74,5 +74,8 @@ Tcl_BackgroundException(interp, TCL_ERROR); .CE .SH KEYWORDS background, bgerror, error, interp + +.SH CATEGORY +Commands Index: doc/Backslash.3 ================================================================== --- doc/Backslash.3 +++ doc/Backslash.3 @@ -43,5 +43,8 @@ .SH "SEE ALSO" Tcl(n), Tcl_UtfBackslash(3) .SH KEYWORDS backslash, parse + +.SH CATEGORY +Invoking the Interpreter Index: doc/BoolObj.3 ================================================================== --- doc/BoolObj.3 +++ doc/BoolObj.3 @@ -91,5 +91,8 @@ .SH "SEE ALSO" Tcl_NewObj, Tcl_IsShared, Tcl_GetBoolean .SH KEYWORDS boolean, value + +.SH CATEGORY +Objects Index: doc/ByteArrObj.3 ================================================================== --- doc/ByteArrObj.3 +++ doc/ByteArrObj.3 @@ -87,5 +87,8 @@ .SH "SEE ALSO" Tcl_GetStringFromObj, Tcl_NewObj, Tcl_IncrRefCount, Tcl_DecrRefCount .SH KEYWORDS value, binary data, byte array, utf, unicode, internationalization + +.SH CATEGORY +Objects Index: doc/CallDel.3 ================================================================== --- doc/CallDel.3 +++ doc/CallDel.3 @@ -63,5 +63,8 @@ a callback is received even if the application terminates without deleting the interpreter. .SH "SEE ALSO" Tcl_CreateExitHandler(3), Tcl_CreateThreadExitHandler(3) .SH KEYWORDS callback, cleanup, delete, interpreter + +.SH CATEGORY +Initialization Index: doc/Cancel.3 ================================================================== --- doc/Cancel.3 +++ doc/Cancel.3 @@ -62,5 +62,8 @@ message is left and the interpreter's result will not be modified. .SH "SEE ALSO" TIP 285 .SH KEYWORDS cancel, unwind + +.SH CATEGORY +The Event Loop Index: doc/ChnlStack.3 ================================================================== --- doc/ChnlStack.3 +++ doc/ChnlStack.3 @@ -93,5 +93,8 @@ .SH "SEE ALSO" Notifier(3), Tcl_CreateChannel(3), Tcl_OpenFileChannel(3), vwait(n). .SH KEYWORDS channel, compression + +.SH CATEGORY +Input/Output Index: doc/Class.3 ================================================================== --- doc/Class.3 +++ doc/Class.3 @@ -228,9 +228,11 @@ invoked, as provided by the user; this object may be updated by the callback. .SH "SEE ALSO" Method(3), oo::class(n), oo::copy(n), oo::define(n), oo::object(n) .SH KEYWORDS class, constructor, object +.SH CATEGORY +Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/CmdCmplt.3 ================================================================== --- doc/CmdCmplt.3 +++ doc/CmdCmplt.3 @@ -30,5 +30,8 @@ brackets, or variable references). If the command string is complete then it returns 1; otherwise it returns 0. .SH KEYWORDS complete command, partial command + +.SH CATEGORY +Invoking the Interpreter Index: doc/Concat.3 ================================================================== --- doc/Concat.3 +++ doc/Concat.3 @@ -47,5 +47,8 @@ by calling \fBTcl_Free\fR. .SH "SEE ALSO" Tcl_ConcatObj .SH KEYWORDS concatenate, strings + +.SH CATEGORY +Utilities Index: doc/CrtChannel.3 ================================================================== --- doc/CrtChannel.3 +++ doc/CrtChannel.3 @@ -924,5 +924,8 @@ \fIversion\fR field should always be \fBTCL_CHANNEL_VERSION_2\fR. .SH "SEE ALSO" Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3), Tcl_QueueEvent(3), Tcl_StackChannel(3), Tcl_GetStdChannel(3) .SH KEYWORDS blocking, channel driver, channel registration, channel type, nonblocking + +.SH CATEGORY +Input/Output Index: doc/CrtChnlHdlr.3 ================================================================== --- doc/CrtChnlHdlr.3 +++ doc/CrtChnlHdlr.3 @@ -85,5 +85,8 @@ for which there are event handlers. .SH "SEE ALSO" Notifier(3), Tcl_CreateChannel(3), Tcl_OpenFileChannel(3), vwait(n). .SH KEYWORDS blocking, callback, channel, events, handler, nonblocking. + +.SH CATEGORY +Input/Output Index: doc/CrtCloseHdlr.3 ================================================================== --- doc/CrtCloseHdlr.3 +++ doc/CrtCloseHdlr.3 @@ -51,5 +51,8 @@ for a close handler for \fIchannel\fR. .SH "SEE ALSO" close(n), Tcl_Close(3), Tcl_UnregisterChannel(3) .SH KEYWORDS callback, channel closing + +.SH CATEGORY +Input/Output Index: doc/CrtCommand.3 ================================================================== --- doc/CrtCommand.3 +++ doc/CrtCommand.3 @@ -139,5 +139,8 @@ .SH "SEE ALSO" Tcl_CreateObjCommand, Tcl_DeleteCommand, Tcl_GetCommandInfo, Tcl_SetCommandInfo, Tcl_GetCommandName, Tcl_SetObjResult .SH KEYWORDS bind, command, create, delete, interpreter, namespace + +.SH CATEGORY +Commands Index: doc/CrtFileHdlr.3 ================================================================== --- doc/CrtFileHdlr.3 +++ doc/CrtFileHdlr.3 @@ -87,5 +87,8 @@ implementation of the Tcl notifier. .SH "SEE ALSO" fileevent(n), Tcl_CreateTimerHandler(3), Tcl_DoWhenIdle(3) .SH KEYWORDS callback, file, handler + +.SH CATEGORY +Input/Output Index: doc/CrtInterp.3 ================================================================== --- doc/CrtInterp.3 +++ doc/CrtInterp.3 @@ -145,5 +145,8 @@ .VE 8.6 .SH "SEE ALSO" Tcl_Preserve(3), Tcl_Release(3), tclvars(n) .SH KEYWORDS command, create, delete, interpreter + +.SH CATEGORY +Initialization Index: doc/CrtMathFnc.3 ================================================================== --- doc/CrtMathFnc.3 +++ doc/CrtMathFnc.3 @@ -158,5 +158,8 @@ \fIpattern\fR. The returned value has a reference count of zero. .SH "SEE ALSO" expr(n), info(n), Tcl_CreateObjCommand(3), Tcl_Free(3), Tcl_NewListObj(3) .SH KEYWORDS expression, mathematical function + +.SH CATEGORY +Commands Index: doc/CrtObjCmd.3 ================================================================== --- doc/CrtObjCmd.3 +++ doc/CrtObjCmd.3 @@ -298,5 +298,8 @@ Returns NULL if the command is not found. .SH "SEE ALSO" Tcl_CreateCommand(3), Tcl_ResetResult(3), Tcl_SetObjResult(3) .SH KEYWORDS bind, command, create, delete, namespace, value + +.SH CATEGORY +Commands Index: doc/CrtSlave.3 ================================================================== --- doc/CrtSlave.3 +++ doc/CrtSlave.3 @@ -232,5 +232,8 @@ interp .SH KEYWORDS alias, command, exposed commands, hidden commands, interpreter, invoke, master, slave + +.SH CATEGORY +Initialization Index: doc/CrtTimerHdlr.3 ================================================================== --- doc/CrtTimerHdlr.3 +++ doc/CrtTimerHdlr.3 @@ -72,5 +72,8 @@ then the procedure does nothing. .SH "SEE ALSO" after(n), Tcl_CreateFileHandler(3), Tcl_DoWhenIdle(3) .SH KEYWORDS callback, clock, handler, timer + +.SH CATEGORY +The Event Loop Index: doc/CrtTrace.3 ================================================================== --- doc/CrtTrace.3 +++ doc/CrtTrace.3 @@ -187,5 +187,8 @@ \fBTcl_CreateTrace\fR is deleted. There is no way for the \fIproc\fR associated with a call to \fBTcl_CreateTrace\fR to abort execution of \fIcommand\fR. .SH KEYWORDS command, create, delete, interpreter, trace + +.SH CATEGORY +Variables Index: doc/DString.3 ================================================================== --- doc/DString.3 +++ doc/DString.3 @@ -149,5 +149,8 @@ If possible it does this by moving a pointer rather than by copying the string. .SH KEYWORDS append, dynamic string, free, result + +.SH CATEGORY +Utilities Index: doc/DetachPids.3 ================================================================== --- doc/DetachPids.3 +++ doc/DetachPids.3 @@ -71,5 +71,8 @@ \fBTcl_ReapDetachedProcs\fR and the channel system to portably access the operating system. .SH KEYWORDS background, child, detach, process, wait + +.SH CATEGORY +Operating System Interface Index: doc/DictObj.3 ================================================================== --- doc/DictObj.3 +++ doc/DictObj.3 @@ -230,5 +230,8 @@ .CE .SH "SEE ALSO" Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_InitObjHashTable .SH KEYWORDS dict, dict value, dictionary, dictionary value, hash table, iteration, value + +.SH CATEGORY +Objects Index: doc/DoOneEvent.3 ================================================================== --- doc/DoOneEvent.3 +++ doc/DoOneEvent.3 @@ -102,5 +102,8 @@ wait for the user to click a button in the dialog before doing anything else. .SH KEYWORDS callback, event, handler, idle, timer + +.SH CATEGORY +The Event Loop Index: doc/DoWhenIdle.3 ================================================================== --- doc/DoWhenIdle.3 +++ doc/DoWhenIdle.3 @@ -83,5 +83,8 @@ better to use a timer handler with a zero timeout period. .SH "SEE ALSO" after(n), Tcl_CreateFileHandler(3), Tcl_CreateTimerHandler(3) .SH KEYWORDS callback, defer, idle callback + +.SH CATEGORY +The Event Loop Index: doc/DoubleObj.3 ================================================================== --- doc/DoubleObj.3 +++ doc/DoubleObj.3 @@ -60,5 +60,8 @@ '\" TODO: add discussion of treatment of NaN value .SH "SEE ALSO" Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_GetObjResult .SH KEYWORDS double, double value, double type, internal representation, value, value type, string representation + +.SH CATEGORY +Objects Index: doc/DumpActiveMemory.3 ================================================================== --- doc/DumpActiveMemory.3 +++ doc/DumpActiveMemory.3 @@ -64,5 +64,8 @@ .SH KEYWORDS memory, debug + +.SH CATEGORY +Utilities Index: doc/Encoding.3 ================================================================== --- doc/Encoding.3 +++ doc/Encoding.3 @@ -588,5 +588,8 @@ from the \fBencoding\fR subdirectory of each directory that Tcl searches for its script library. If the encoding file exists, but is malformed, an error message will be left in \fIinterp\fR. .SH KEYWORDS utf, encoding, convert + +.SH CATEGORY +Utilities Index: doc/Ensemble.3 ================================================================== --- doc/Ensemble.3 +++ doc/Ensemble.3 @@ -215,5 +215,8 @@ (\fBTCL_OK\fR, or \fBTCL_ERROR\fR if the token does not refer to an ensemble). .SH "SEE ALSO" namespace(n), Tcl_DeleteCommandFromToken(3) .SH KEYWORDS command, ensemble + +.SH CATEGORY +Commands Index: doc/Environment.3 ================================================================== --- doc/Environment.3 +++ doc/Environment.3 @@ -34,5 +34,8 @@ runtime. .SH "SEE ALSO" tclvars(n) .SH KEYWORDS environment, variable + +.SH CATEGORY +Operating System Interface Index: doc/Eval.3 ================================================================== --- doc/Eval.3 +++ doc/Eval.3 @@ -207,5 +207,8 @@ This means that top-level applications should never see a return code from \fBTcl_EvalObjEx\fR other then \fBTCL_OK\fR or \fBTCL_ERROR\fR. .SH KEYWORDS execute, file, global, result, script, value + +.SH CATEGORY +Invoking the Interpreter Index: doc/Exit.3 ================================================================== --- doc/Exit.3 +++ doc/Exit.3 @@ -136,5 +136,8 @@ cast to a ClientData value. .SH "SEE ALSO" exit(n) .SH KEYWORDS abort, callback, cleanup, dynamic loading, end application, exit, unloading, thread + +.SH CATEGORY +Initialization Index: doc/ExprLong.3 ================================================================== --- doc/ExprLong.3 +++ doc/ExprLong.3 @@ -102,5 +102,8 @@ .SH "SEE ALSO" Tcl_ExprLongObj, Tcl_ExprDoubleObj, Tcl_ExprBooleanObj, Tcl_ExprObj .SH KEYWORDS boolean, double, evaluate, expression, integer, value, string + +.SH CATEGORY +Invoking the Interpreter Index: doc/ExprLongObj.3 ================================================================== --- doc/ExprLongObj.3 +++ doc/ExprLongObj.3 @@ -102,5 +102,8 @@ .SH "SEE ALSO" Tcl_ExprLong, Tcl_ExprDouble, Tcl_ExprBoolean, Tcl_ExprString, Tcl_GetObjResult .SH KEYWORDS boolean, double, evaluate, expression, integer, value, string + +.SH CATEGORY +Invoking the Interpreter Index: doc/FileSystem.3 ================================================================== --- doc/FileSystem.3 +++ doc/FileSystem.3 @@ -1640,5 +1640,8 @@ -1 on error or 0 on success. .SH "SEE ALSO" cd(n), file(n), filename(n), load(n), open(n), pwd(n), source(n), unload(n) .SH KEYWORDS stat, access, filesystem, vfs, virtual filesystem + +.SH CATEGORY +Operating System Interface Index: doc/FindExec.3 ================================================================== --- doc/FindExec.3 +++ doc/FindExec.3 @@ -59,5 +59,8 @@ is returned if the internal full path name has not been computed or unknown. .SH KEYWORDS binary, executable file + +.SH CATEGORY +Initialization Index: doc/GetCwd.3 ================================================================== --- doc/GetCwd.3 +++ doc/GetCwd.3 @@ -48,5 +48,8 @@ the value specified in \fIpath\fR. The format of the passed in string must be UTF\-8. The function returns -1 on error or 0 on success. .SH KEYWORDS pwd + +.SH CATEGORY +Operating System Interface Index: doc/GetHostName.3 ================================================================== --- doc/GetHostName.3 +++ doc/GetHostName.3 @@ -23,5 +23,8 @@ determined. The string is statically allocated, and the caller must not modify of free it. .PP .SH KEYWORDS hostname + +.SH CATEGORY +Operating System Interface Index: doc/GetIndex.3 ================================================================== --- doc/GetIndex.3 +++ doc/GetIndex.3 @@ -100,5 +100,8 @@ each of several array elements. .SH "SEE ALSO" prefix(n), Tcl_WrongNumArgs(3) .SH KEYWORDS index, option, value, table lookup + +.SH CATEGORY +Utilities Index: doc/GetInt.3 ================================================================== --- doc/GetInt.3 +++ doc/GetInt.3 @@ -82,5 +82,8 @@ Any of these values may be abbreviated, and upper-case spellings are also acceptable. .SH KEYWORDS boolean, conversion, double, floating-point, integer + +.SH CATEGORY +Utilities Index: doc/GetOpnFl.3 ================================================================== --- doc/GetOpnFl.3 +++ doc/GetOpnFl.3 @@ -54,5 +54,8 @@ .PP Note that this interface is only supported on the Unix platform. .SH KEYWORDS channel, file handle, permissions, pipeline, read, write + +.SH CATEGORY +Input/Output Index: doc/GetStdChan.3 ================================================================== --- doc/GetStdChan.3 +++ doc/GetStdChan.3 @@ -82,5 +82,8 @@ .SH "SEE ALSO" Tcl_Close(3), Tcl_CreateChannel(3), Tcl_Main(3), tclsh(1) .SH KEYWORDS standard channel, standard input, standard output, standard error + +.SH CATEGORY +Input/Output Index: doc/GetTime.3 ================================================================== --- doc/GetTime.3 +++ doc/GetTime.3 @@ -105,5 +105,8 @@ with regard to this situation, i.e. the existing behavior is retained. .SH "SEE ALSO" clock(n) .SH KEYWORDS date, time + +.SH CATEGORY +Operating System Interface Index: doc/GetVersion.3 ================================================================== --- doc/GetVersion.3 +++ doc/GetVersion.3 @@ -44,5 +44,8 @@ a NULL for the \fIpatchLevel\fR argument. .SH KEYWORDS version, patchlevel, major, minor, alpha, beta, release + +.SH CATEGORY +Initialization Index: doc/Hash.3 ================================================================== --- doc/Hash.3 +++ doc/Hash.3 @@ -330,5 +330,8 @@ If this is NULL then \fBTcl_Free\fR is used to free the space for the entry. Tcl_Obj* keys use this function to decrement the reference count on the value. .SH KEYWORDS hash table, key, lookup, search, value + +.SH CATEGORY +Utilities Index: doc/Init.3 ================================================================== --- doc/Init.3 +++ doc/Init.3 @@ -30,5 +30,8 @@ .SH "SEE ALSO" Tcl_AppInit, Tcl_Main .SH KEYWORDS application, initialization, interpreter + +.SH CATEGORY +Initialization Index: doc/InitStubs.3 ================================================================== --- doc/InitStubs.3 +++ doc/InitStubs.3 @@ -85,5 +85,8 @@ acceptable, does not support stubs, or any other error condition occurred. .SH "SEE ALSO" Tk_InitStubs .SH KEYWORDS stubs + +.SH CATEGORY +Initialization Index: doc/IntObj.3 ================================================================== --- doc/IntObj.3 +++ doc/IntObj.3 @@ -148,5 +148,8 @@ .SH "SEE ALSO" Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_GetObjResult .SH KEYWORDS integer, integer value, integer type, internal representation, value, value type, string representation + +.SH CATEGORY +Objects Index: doc/Interp.3 ================================================================== --- doc/Interp.3 +++ doc/Interp.3 @@ -130,5 +130,8 @@ occurred. \fIErrorLine\fR should not normally be modified except by \fBTcl_Eval\fR. .SH KEYWORDS free, initialized, interpreter, malloc, result + +.SH CATEGORY +Initialization Index: doc/Limit.3 ================================================================== --- doc/Limit.3 +++ doc/Limit.3 @@ -188,5 +188,8 @@ \fIhandlerProc\fR and \fIclientData\fR arguments. This function always invokes the \fIdeleteProc\fR on the \fIclientData\fR (unless the \fIdeleteProc\fR was NULL or \fBTCL_STATIC\fR). .SH KEYWORDS interpreter, resource, limit, commands, time, callback + +.SH CATEGORY +Invoking the Interpreter Index: doc/LinkVar.3 ================================================================== --- doc/LinkVar.3 +++ doc/LinkVar.3 @@ -203,5 +203,8 @@ \fBTcl_UpdateLinkedVar\fR. .SH "SEE ALSO" Tcl_TraceVar(3) .SH KEYWORDS boolean, integer, link, read-only, real, string, trace, variable + +.SH CATEGORY +Variables Index: doc/ListObj.3 ================================================================== --- doc/ListObj.3 +++ doc/ListObj.3 @@ -247,5 +247,8 @@ .SH "SEE ALSO" Tcl_NewObj(3), Tcl_DecrRefCount(3), Tcl_IncrRefCount(3), Tcl_GetObjResult(3) .SH KEYWORDS append, index, insert, internal representation, length, list, list value, list type, value, value type, replace, string representation + +.SH CATEGORY +Objects Index: doc/Load.3 ================================================================== --- doc/Load.3 +++ doc/Load.3 @@ -62,9 +62,11 @@ operation on a handle that has been passed to \fBTcl_FSUnloadFile\fR. .SH "SEE ALSO" Tcl_FSLoadFile(3), Tcl_FSUnloadFile(3), load(n), unload(n) .SH KEYWORDS binary code, loading, shared library +.SH CATEGORY +Operating System Interface '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/Method.3 ================================================================== --- doc/Method.3 +++ doc/Method.3 @@ -240,9 +240,11 @@ .SH "SEE ALSO" Class(3), oo::class(n), oo::define(n), oo::object(n) .SH KEYWORDS constructor, method, object +.SH CATEGORY +Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/NRE.3 ================================================================== --- doc/NRE.3 +++ doc/NRE.3 @@ -322,7 +322,9 @@ .CE .SH "SEE ALSO" Tcl_CreateCommand(3), Tcl_CreateObjCommand(3), Tcl_EvalObjEx(3), Tcl_GetCommandFromObj(3), Tcl_ExprObj(3) .SH KEYWORDS stackless, nonrecursive, execute, command, global, value, result, script +.SH CATEGORY +Invoking the Interpreter .SH COPYRIGHT Copyright (c) 2008 by Kevin B. Kenny Index: doc/Namespace.3 ================================================================== --- doc/Namespace.3 +++ doc/Namespace.3 @@ -161,5 +161,8 @@ its default. .SH "SEE ALSO" Tcl_CreateCommand(3), Tcl_ListObjAppendList(3), Tcl_SetVar(3) .SH KEYWORDS namespace, command + +.SH CATEGORY +Variables Index: doc/Notifier.3 ================================================================== --- doc/Notifier.3 +++ doc/Notifier.3 @@ -631,5 +631,8 @@ .SH "SEE ALSO" Tcl_CreateFileHandler(3), Tcl_DeleteFileHandler(3), Tcl_Sleep(3), Tcl_DoOneEvent(3), Thread(3) .SH KEYWORDS event, notifier, event queue, event sources, file events, timer, idle, service mode, threads + +.SH CATEGORY +The Event Loop Index: doc/Object.3 ================================================================== --- doc/Object.3 +++ doc/Object.3 @@ -348,5 +348,8 @@ .SH "SEE ALSO" Tcl_ConvertToType(3), Tcl_GetIntFromObj(3), Tcl_ListObjAppendElement(3), Tcl_ListObjIndex(3), Tcl_ListObjReplace(3), Tcl_RegisterObjType(3) .SH KEYWORDS internal representation, value, value creation, value type, reference counting, string representation, type conversion + +.SH CATEGORY +Objects Index: doc/ObjectType.3 ================================================================== --- doc/ObjectType.3 +++ doc/ObjectType.3 @@ -252,5 +252,8 @@ member. .SH "SEE ALSO" Tcl_NewObj(3), Tcl_DecrRefCount(3), Tcl_IncrRefCount(3) .SH KEYWORDS internal representation, value, value type, string representation, type conversion + +.SH CATEGORY +Objects Index: doc/OpenFileChnl.3 ================================================================== --- doc/OpenFileChnl.3 +++ doc/OpenFileChnl.3 @@ -644,5 +644,8 @@ .SH "SEE ALSO" DString(3), fconfigure(n), filename(n), fopen(3), Tcl_CreateChannel(3) .SH KEYWORDS access point, blocking, buffered I/O, channel, channel driver, end of file, flush, input, nonblocking, output, read, seek, write + +.SH CATEGORY +Input/Output Index: doc/OpenTcp.3 ================================================================== --- doc/OpenTcp.3 +++ doc/OpenTcp.3 @@ -165,5 +165,8 @@ socket handle is a \fBSOCKET\fR as defined in the WinSock API. .SH "SEE ALSO" Tcl_OpenFileChannel(3), Tcl_RegisterChannel(3), vwait(n) .SH KEYWORDS channel, client, server, socket, TCP + +.SH CATEGORY +Input/Output Index: doc/Panic.3 ================================================================== --- doc/Panic.3 +++ doc/Panic.3 @@ -85,5 +85,8 @@ taking a variable number of arguments it takes an argument list. .SH "SEE ALSO" abort(3), printf(3), exec(n), format(n) .SH KEYWORDS abort, fatal, error + +.SH CATEGORY +Commands Index: doc/ParseArgs.3 ================================================================== --- doc/ParseArgs.3 +++ doc/ParseArgs.3 @@ -191,8 +191,10 @@ \fIsrcPtr\fR and \fIclientData\fR fields are ignored. .SH "SEE ALSO" Tcl_GetIndexFromObj(3), Tcl_Main(3), Tcl_CreateObjCommand(3) .SH KEYWORDS argument, parse +.SH CATEGORY +Utilities '\" Local Variables: '\" fill-column: 78 '\" End: Index: doc/ParseCmd.3 ================================================================== --- doc/ParseCmd.3 +++ doc/ParseCmd.3 @@ -463,5 +463,8 @@ \fBTcl_ParseCommand\fR, \fBTcl_ParseExpr\fR, \fBTcl_ParseBraces\fR, \fBTcl_ParseQuotedString\fR, and \fBTcl_ParseVarName\fR; they should not be referenced by code outside of these procedures. .SH KEYWORDS backslash substitution, braces, command, expression, parse, token, variable substitution + +.SH CATEGORY +Invoking the Interpreter Index: doc/PkgRequire.3 ================================================================== --- doc/PkgRequire.3 +++ doc/PkgRequire.3 @@ -91,7 +91,9 @@ \fBTcl_PkgRequireProc\fR is the form of \fBpackage require\fR handling multiple requirements. The other forms are present for backward compatibility and translate their invocations to this form. .SH KEYWORDS package, present, provide, require, version +.SH CATEGORY +Initialization .SH "SEE ALSO" package(n), Tcl_StaticPackage(3) Index: doc/Preserve.3 ================================================================== --- doc/Preserve.3 +++ doc/Preserve.3 @@ -106,5 +106,8 @@ counts in a separate structure. .SH "SEE ALSO" Tcl_Interp, Tcl_Alloc .SH KEYWORDS free, reference count, storage + +.SH CATEGORY +Utilities Index: doc/PrintDbl.3 ================================================================== --- doc/PrintDbl.3 +++ doc/PrintDbl.3 @@ -47,5 +47,8 @@ represent the number in such a way that \fBTcl_NewDoubleObj\fR will generate the same number when presented with the given string. IEEE semantics of rounding to even apply to the conversion. .SH KEYWORDS conversion, double-precision, floating-point, string + +.SH CATEGORY +Utilities Index: doc/RecEvalObj.3 ================================================================== --- doc/RecEvalObj.3 +++ doc/RecEvalObj.3 @@ -49,5 +49,8 @@ .SH "SEE ALSO" Tcl_EvalObjEx, Tcl_GetObjResult .SH KEYWORDS command, event, execute, history, interpreter, value, record + +.SH CATEGORY +Invoking the Interpreter Index: doc/RecordEval.3 ================================================================== --- doc/RecordEval.3 +++ doc/RecordEval.3 @@ -51,5 +51,8 @@ .SH "SEE ALSO" Tcl_RecordAndEvalObj .SH KEYWORDS command, event, execute, history, interpreter, record + +.SH CATEGORY +Invoking the Interpreter Index: doc/RegConfig.3 ================================================================== --- doc/RegConfig.3 +++ doc/RegConfig.3 @@ -107,5 +107,8 @@ .CE .\" No cross references yet. .\" .SH "SEE ALSO" .SH KEYWORDS embedding, configuration, binary library + +.SH CATEGORY +Initialization Index: doc/RegExp.3 ================================================================== --- doc/RegExp.3 +++ doc/RegExp.3 @@ -379,5 +379,8 @@ to \-1. .SH "SEE ALSO" re_syntax(n) .SH KEYWORDS match, pattern, regular expression, string, subexpression, Tcl_RegExpIndices, Tcl_RegExpInfo + +.SH CATEGORY +Utilities Index: doc/SaveResult.3 ================================================================== --- doc/SaveResult.3 +++ doc/SaveResult.3 @@ -116,5 +116,8 @@ result, either \fBTcl_RestoreResult\fR or \fBTcl_DiscardResult\fR must be called to properly clean up the memory associated with the saved state. .SH KEYWORDS result, state, interp + +.SH CATEGORY +Commands Index: doc/SetChanErr.3 ================================================================== --- doc/SetChanErr.3 +++ doc/SetChanErr.3 @@ -136,5 +136,8 @@ .DE .SH "SEE ALSO" Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3) .SH KEYWORDS channel driver, error messages, channel type + +.SH CATEGORY +Input/Output Index: doc/SetErrno.3 ================================================================== --- doc/SetErrno.3 +++ doc/SetErrno.3 @@ -62,5 +62,8 @@ The strings returned by these functions are statically allocated and the caller must not free or modify them. .SH KEYWORDS errno, error code, global variables + +.SH CATEGORY +Commands Index: doc/SetRecLmt.3 ================================================================== --- doc/SetRecLmt.3 +++ doc/SetRecLmt.3 @@ -49,5 +49,8 @@ If this happens, see if there is a mechanism in your system for increasing the maximum size of the C stack. .SH KEYWORDS nesting depth, recursion + +.SH CATEGORY +Invoking the Interpreter Index: doc/SetResult.3 ================================================================== --- doc/SetResult.3 +++ doc/SetResult.3 @@ -251,5 +251,8 @@ the value of \fIresult\fR passed to \fBTcl_SetResult\fR. .SH "SEE ALSO" Tcl_AddErrorInfo, Tcl_CreateObjCommand, Tcl_SetErrorCode, Tcl_Interp .SH KEYWORDS append, command, element, list, value, result, return value, interpreter + +.SH CATEGORY +Commands Index: doc/SetVar.3 ================================================================== --- doc/SetVar.3 +++ doc/SetVar.3 @@ -245,5 +245,8 @@ .SH "SEE ALSO" Tcl_GetObjResult, Tcl_GetStringResult, Tcl_TraceVar .SH KEYWORDS array, get variable, interpreter, scalar, set, unset, value, variable + +.SH CATEGORY +Variables Index: doc/Signal.3 ================================================================== --- doc/Signal.3 +++ doc/Signal.3 @@ -37,5 +37,8 @@ The strings returned by these functions are statically allocated and the caller must not free or modify them. .SH KEYWORDS signals, signal numbers + +.SH CATEGORY +Operating System Interface Index: doc/Sleep.3 ================================================================== --- doc/Sleep.3 +++ doc/Sleep.3 @@ -30,5 +30,8 @@ delays where the application needs to respond to other events during the delay, the procedure \fBTcl_CreateTimerHandler\fR should be used instead of \fBTcl_Sleep\fR. .SH KEYWORDS sleep, time, wait + +.SH CATEGORY +The Event Loop Index: doc/SourceRCFile.3 ================================================================== --- doc/SourceRCFile.3 +++ doc/SourceRCFile.3 @@ -28,5 +28,8 @@ defined, or if the file it indicates cannot be found, no action is taken. .SH KEYWORDS application-specific initialization, main program, rc file + +.SH CATEGORY +Initialization Index: doc/SplitList.3 ================================================================== --- doc/SplitList.3 +++ doc/SplitList.3 @@ -184,5 +184,8 @@ argument, and the string may contain embedded nulls. .SH "SEE ALSO" Tcl_ListObjGetElements(3) .SH KEYWORDS backslash, convert, element, list, merge, split, strings + +.SH CATEGORY +Utilities Index: doc/SplitPath.3 ================================================================== --- doc/SplitPath.3 +++ doc/SplitPath.3 @@ -93,5 +93,8 @@ \fBfilename\fR manual entry for a description of the path types for each platform. .SH KEYWORDS file, filename, join, path, split, type + +.SH CATEGORY +Utilities Index: doc/StaticPkg.3 ================================================================== --- doc/StaticPkg.3 +++ doc/StaticPkg.3 @@ -64,7 +64,9 @@ error message. The result or error from the initialization procedure will be returned as the result of the \fBload\fR command that caused the initialization procedure to be invoked. .SH KEYWORDS initialization procedure, package, static linking +.SH CATEGORY +Initialization .SH "SEE ALSO" load(n), package(n), Tcl_PkgRequire(3) Index: doc/StdChannels.3 ================================================================== --- doc/StdChannels.3 +++ doc/StdChannels.3 @@ -116,5 +116,8 @@ uses method 2 to initialize the standard channels. .SH "SEE ALSO" Tcl_CreateChannel(3), Tcl_RegisterChannel(3), Tcl_GetChannel(3), Tcl_GetStdChannel(3), Tcl_SetStdChannel(3), Tk_InitConsoleChannels(3), tclsh(1), wish(1), Tcl_Main(3), Tk_MainEx(3) .SH KEYWORDS standard channels + +.SH CATEGORY +Input/Output Index: doc/StrMatch.3 ================================================================== --- doc/StrMatch.3 +++ doc/StrMatch.3 @@ -45,5 +45,8 @@ If you choose this (by passing \fBTCL_MATCH_NOCASE\fR), then the string and pattern are essentially matched in the lower case. .SH KEYWORDS match, pattern, string + +.SH CATEGORY +Utilities Index: doc/StringObj.3 ================================================================== --- doc/StringObj.3 +++ doc/StringObj.3 @@ -380,5 +380,8 @@ .SH "SEE ALSO" Tcl_NewObj(3), Tcl_IncrRefCount(3), Tcl_DecrRefCount(3), format(n), sprintf(3) .SH KEYWORDS append, internal representation, value, value type, string value, string type, string representation, concat, concatenate, unicode + +.SH CATEGORY +Objects Index: doc/SubstObj.3 ================================================================== --- doc/SubstObj.3 +++ doc/SubstObj.3 @@ -64,5 +64,8 @@ performed after that point. .SH "SEE ALSO" subst(n) .SH KEYWORDS backslash substitution, command substitution, variable substitution + +.SH CATEGORY +Invoking the Interpreter Index: doc/TCL_MEM_DEBUG.3 ================================================================== --- doc/TCL_MEM_DEBUG.3 +++ doc/TCL_MEM_DEBUG.3 @@ -76,5 +76,8 @@ to remove the calls after you find the problem. .SH "SEE ALSO" ckalloc, memory, Tcl_ValidateAllMemory, Tcl_DumpActiveMemory .SH KEYWORDS memory, debug + +.SH CATEGORY +Utilities Index: doc/Tcl.n ================================================================== --- doc/Tcl.n +++ doc/Tcl.n @@ -262,9 +262,11 @@ For example, during variable substitution the entire value of the variable becomes part of a single word, even if the variable's value contains spaces. .SH KEYWORDS backslash, command, comment, script, substitution, variable +.SH CATEGORY +General '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/TclZlib.3 ================================================================== --- doc/TclZlib.3 +++ doc/TclZlib.3 @@ -268,9 +268,11 @@ .SH "SEE ALSO" Tcl_NewByteArrayObj(3), zlib(n) '\"Tcl_StackChannel(3) .SH "KEYWORDS" compress, decompress, deflate, gzip, inflate +.SH CATEGORY +Input/Output '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/Tcl_Main.3 ================================================================== --- doc/Tcl_Main.3 +++ doc/Tcl_Main.3 @@ -192,5 +192,8 @@ .SH "SEE ALSO" tclsh(1), Tcl_GetStdChannel(3), Tcl_StandardChannels(3), Tcl_AppInit(3), exit(n), encoding(n) .SH KEYWORDS application-specific initialization, command-line arguments, main program + +.SH CATEGORY +Initialization Index: doc/Thread.3 ================================================================== --- doc/Thread.3 +++ doc/Thread.3 @@ -237,5 +237,8 @@ Tcl_GetCurrentThread(3), Tcl_ThreadQueueEvent(3), Tcl_ThreadAlert(3), Tcl_ExitThread(3), Tcl_FinalizeThread(3), Tcl_CreateThreadExitHandler(3), Tcl_DeleteThreadExitHandler(3), Thread .SH KEYWORDS thread, mutex, condition variable, thread local storage + +.SH CATEGORY +The Event Loop Index: doc/ToUpper.3 ================================================================== --- doc/ToUpper.3 +++ doc/ToUpper.3 @@ -84,5 +84,8 @@ characters. Unicode characters above 0x00ff are not modified by these routines. .SH KEYWORDS utf, unicode, toupper, tolower, totitle, case + +.SH CATEGORY +Utilities Index: doc/TraceCmd.3 ================================================================== --- doc/TraceCmd.3 +++ doc/TraceCmd.3 @@ -159,5 +159,8 @@ Tcl does not do any error checking to prevent trace procedures from misusing the interpreter during traces with \fBTCL_INTERP_DESTROYED\fR set. .SH KEYWORDS clientData, trace, command + +.SH CATEGORY +Variables Index: doc/TraceVar.3 ================================================================== --- doc/TraceVar.3 +++ doc/TraceVar.3 @@ -376,5 +376,8 @@ nor is there Tcl-level access to array traces. .SH "SEE ALSO" trace(n) .SH KEYWORDS clientData, trace, variable + +.SH CATEGORY +Variables Index: doc/Translate.3 ================================================================== --- doc/Translate.3 +++ doc/Translate.3 @@ -67,5 +67,8 @@ has its default empty value when \fBTcl_TranslateFileName\fR is invoked. .SH "SEE ALSO" filename(n) .SH KEYWORDS file name, home directory, tilde, translate, user + +.SH CATEGORY +Operating System Interface Index: doc/UniCharIsAlpha.3 ================================================================== --- doc/UniCharIsAlpha.3 +++ doc/UniCharIsAlpha.3 @@ -87,5 +87,8 @@ \fBTcl_UniCharIsWordChar\fR tests if the character is alphanumeric or a connector punctuation mark. .SH KEYWORDS unicode, classification + +.SH CATEGORY +Utilities Index: doc/UpVar.3 ================================================================== --- doc/UpVar.3 +++ doc/UpVar.3 @@ -70,5 +70,8 @@ destination variable may exist at the time of the call, but if so it must exist as a linked variable. .SH KEYWORDS linked variable, upvar, variable + +.SH CATEGORY +Variables Index: doc/Utf.3 ================================================================== --- doc/Utf.3 +++ doc/Utf.3 @@ -255,5 +255,8 @@ sequences. All of the sequences described in the Tcl manual entry are supported by \fBTcl_UtfBackslash\fR. .SH KEYWORDS utf, unicode, backslash + +.SH CATEGORY +Utilities Index: doc/WrongNumArgs.3 ================================================================== --- doc/WrongNumArgs.3 +++ doc/WrongNumArgs.3 @@ -75,5 +75,8 @@ .CE .SH "SEE ALSO" Tcl_GetIndexFromObj(3) .SH KEYWORDS command, error message, wrong number of arguments + +.SH CATEGORY +Utilities Index: doc/after.n ================================================================== --- doc/after.n +++ doc/after.n @@ -144,8 +144,10 @@ .CE .SH "SEE ALSO" concat(n), interp(n), update(n), vwait(n) .SH KEYWORDS cancel, delay, idle callback, sleep, time +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/append.n ================================================================== --- doc/append.n +++ doc/append.n @@ -42,8 +42,11 @@ .CE .SH "SEE ALSO" concat(n), lappend(n) .SH KEYWORDS append, variable +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff +'\" End: '\" End: Index: doc/apply.n ================================================================== --- doc/apply.n +++ doc/apply.n @@ -95,8 +95,10 @@ .CE .SH "SEE ALSO" proc(n), uplevel(n) .SH KEYWORDS anonymous function, argument, lambda, procedure, +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/array.n ================================================================== --- doc/array.n +++ doc/array.n @@ -183,5 +183,8 @@ .CE .SH "SEE ALSO" list(n), string(n), variable(n), trace(n), foreach(n) .SH KEYWORDS array, element names, search + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/bgerror.n ================================================================== --- doc/bgerror.n +++ doc/bgerror.n @@ -86,5 +86,8 @@ .CE .SH "SEE ALSO" after(n), interp(n), tclvars(n) .SH KEYWORDS background error, reporting + +.SH CATEGORY +Tcl Interpreter Routines Index: doc/binary.n ================================================================== --- doc/binary.n +++ doc/binary.n @@ -885,8 +885,10 @@ .CE .SH "SEE ALSO" format(n), scan(n), tclvars(n) .SH KEYWORDS binary, format, scan +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/break.n ================================================================== --- doc/break.n +++ doc/break.n @@ -40,8 +40,10 @@ .CE .SH "SEE ALSO" catch(n), continue(n), for(n), foreach(n), return(n), while(n) .SH KEYWORDS abort, break, loop +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/case.n ================================================================== --- doc/case.n +++ doc/case.n @@ -56,5 +56,8 @@ .SH "SEE ALSO" switch(n) .SH KEYWORDS case, match, regular expression + +.SH CATEGORY +Tcl Control Constructs Index: doc/catch.n ================================================================== --- doc/catch.n +++ doc/catch.n @@ -116,9 +116,11 @@ documentation for the \fBreturn\fR command. .SH "SEE ALSO" break(n), continue(n), dict(n), error(n), info(n), return(n), tclvars(n) .SH KEYWORDS catch, error, exception +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/cd.n ================================================================== --- doc/cd.n +++ doc/cd.n @@ -39,5 +39,8 @@ .CE .SH "SEE ALSO" filename(n), glob(n), pwd(n) .SH KEYWORDS working directory + +.SH CATEGORY +Tcl System Related Index: doc/chan.n ================================================================== --- doc/chan.n +++ doc/chan.n @@ -829,8 +829,10 @@ close(n), eof(n), fblocked(n), fconfigure(n), fcopy(n), file(n), fileevent(n), flush(n), gets(n), open(n), puts(n), read(n), seek(n), socket(n), tell(n), refchan(n), transchan(n) .SH KEYWORDS channel, input, output, events, offset +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" End: Index: doc/class.n ================================================================== --- doc/class.n +++ doc/class.n @@ -128,9 +128,11 @@ .CE .SH "SEE ALSO" oo::define(n), oo::object(n) .SH KEYWORDS class, metaclass, object +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/clock.n ================================================================== --- doc/clock.n +++ doc/clock.n @@ -928,10 +928,12 @@ of a long month to a short month. .SH "SEE ALSO" msgcat(n) .SH KEYWORDS clock, date, time +.SH CATEGORY +Tcl System Related .SH "COPYRIGHT" Copyright (c) 2004 Kevin B. Kenny . All rights reserved. '\" Local Variables: '\" mode: nroff '\" End: Index: doc/close.n ================================================================== --- doc/close.n +++ doc/close.n @@ -100,9 +100,11 @@ .CE .SH "SEE ALSO" file(n), open(n), socket(n), eof(n), Tcl_StandardChannels(3) .SH KEYWORDS blocking, channel, close, nonblocking, half-close +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/concat.n ================================================================== --- doc/concat.n +++ doc/concat.n @@ -51,8 +51,10 @@ \fBc\fR). .SH "SEE ALSO" append(n), eval(n), join(n) .SH KEYWORDS concatenate, join, list +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/continue.n ================================================================== --- doc/continue.n +++ doc/continue.n @@ -40,8 +40,10 @@ .CE .SH "SEE ALSO" break(n), for(n), foreach(n), return(n), while(n) .SH KEYWORDS continue, iteration, loop +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/copy.n ================================================================== --- doc/copy.n +++ doc/copy.n @@ -58,9 +58,11 @@ .CE .SH "SEE ALSO" oo::class(n), oo::define(n), oo::object(n) .SH KEYWORDS clone, copy, duplication, object +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/coroutine.n ================================================================== --- doc/coroutine.n +++ doc/coroutine.n @@ -197,9 +197,11 @@ .CE .SH "SEE ALSO" apply(n), info(n), proc(n), return(n) .SH KEYWORDS coroutine, generator +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/dde.n ================================================================== --- doc/dde.n +++ doc/dde.n @@ -182,8 +182,10 @@ .CE .SH "SEE ALSO" tk(n), winfo(n), send(n) .SH KEYWORDS application, dde, name, remote execution +.SH CATEGORY +Tcl Platform-specific '\"Local Variables: '\"mode: nroff '\"End: Index: doc/define.n ================================================================== --- doc/define.n +++ doc/define.n @@ -396,9 +396,11 @@ .CE .SH "SEE ALSO" next(n), oo::class(n), oo::object(n) .SH KEYWORDS class, definition, method, object, slot +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/dict.n ================================================================== --- doc/dict.n +++ doc/dict.n @@ -434,8 +434,10 @@ .CE .SH "SEE ALSO" append(n), array(n), foreach(n), mapeach(n), incr(n), list(n), lappend(n), set(n) .SH KEYWORDS dictionary, create, update, lookup, iterate, filter, map +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/encoding.n ================================================================== --- doc/encoding.n +++ doc/encoding.n @@ -91,5 +91,8 @@ which is the Hiragana letter HA. .SH "SEE ALSO" Tcl_GetEncoding(3) .SH KEYWORDS encoding, unicode + +.SH CATEGORY +Tcl Library Procedures Index: doc/eof.n ================================================================== --- doc/eof.n +++ doc/eof.n @@ -57,5 +57,8 @@ .CE .SH "SEE ALSO" file(n), open(n), close(n), fblocked(n), Tcl_StandardChannels(3) .SH KEYWORDS channel, end of file + +.SH CATEGORY +Tcl Input/Output Index: doc/error.n ================================================================== --- doc/error.n +++ doc/error.n @@ -71,8 +71,10 @@ .CE .SH "SEE ALSO" catch(n), return(n) .SH KEYWORDS error, exception +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/eval.n ================================================================== --- doc/eval.n +++ doc/eval.n @@ -76,8 +76,10 @@ .CE .SH "SEE ALSO" catch(n), concat(n), error(n), interp(n), list(n), namespace(n), subst(n), tclvars(n), uplevel(n) .SH KEYWORDS concatenate, evaluate, script +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/exec.n ================================================================== --- doc/exec.n +++ doc/exec.n @@ -509,8 +509,10 @@ .CE .SH "SEE ALSO" error(n), file(n), open(n) .SH KEYWORDS execute, pipeline, redirection, subprocess +.SH CATEGORY +Tcl System Related '\" Local Variables: '\" mode: nroff '\" End: Index: doc/exit.n ================================================================== --- doc/exit.n +++ doc/exit.n @@ -47,5 +47,8 @@ .CE .SH "SEE ALSO" exec(n) .SH KEYWORDS abort, exit, process + +.SH CATEGORY +Tcl System Related Index: doc/expr.n ================================================================== --- doc/expr.n +++ doc/expr.n @@ -462,10 +462,12 @@ .SH "SEE ALSO" array(n), for(n), if(n), mathfunc(n), mathop(n), namespace(n), proc(n), string(n), Tcl(n), while(n) .SH KEYWORDS arithmetic, boolean, compare, expression, fuzzy comparison +.SH CATEGORY +General .SH COPYRIGHT .nf Copyright (c) 1993 The Regents of the University of California. Copyright (c) 1994-2000 Sun Microsystems Incorporated. Copyright (c) 2005 by Kevin B. Kenny . All rights reserved. Index: doc/fblocked.n ================================================================== --- doc/fblocked.n +++ doc/fblocked.n @@ -63,5 +63,8 @@ .CE .SH "SEE ALSO" gets(n), open(n), read(n), socket(n), Tcl_StandardChannels(3) .SH KEYWORDS blocking, nonblocking + +.SH CATEGORY +Tcl Input/Output Index: doc/fconfigure.n ================================================================== --- doc/fconfigure.n +++ doc/fconfigure.n @@ -282,8 +282,10 @@ Tcl_StandardChannels(3) .SH KEYWORDS blocking, buffering, carriage return, end of line, flushing, linemode, newline, nonblocking, platform, translation, encoding, filter, byte array, binary +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" End: Index: doc/fcopy.n ================================================================== --- doc/fcopy.n +++ doc/fcopy.n @@ -151,5 +151,8 @@ .CE .SH "SEE ALSO" eof(n), fblocked(n), fconfigure(n), file(n) .SH KEYWORDS blocking, channel, end of line, end of file, nonblocking, read, translation + +.SH CATEGORY +Tcl Input/Output Index: doc/file.n ================================================================== --- doc/file.n +++ doc/file.n @@ -535,9 +535,11 @@ filename(n), open(n), close(n), eof(n), gets(n), tell(n), seek(n), fblocked(n), flush(n) .SH KEYWORDS attributes, copy files, delete files, directory, file, move files, name, rename files, stat, user +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/fileevent.n ================================================================== --- doc/fileevent.n +++ doc/fileevent.n @@ -149,5 +149,8 @@ .SH "SEE ALSO" fconfigure(n), gets(n), interp(n), puts(n), read(n), Tcl_StandardChannels(3) .SH KEYWORDS asynchronous I/O, blocking, channel, event handler, nonblocking, readable, script, writable. + +.SH CATEGORY +Tcl Input/Output Index: doc/filename.n ================================================================== --- doc/filename.n +++ doc/filename.n @@ -174,5 +174,8 @@ .SH "SEE ALSO" file(n), glob(n) .SH KEYWORDS current directory, absolute file name, relative file name, volume-relative file name, portability + +.SH CATEGORY +General Index: doc/flush.n ================================================================== --- doc/flush.n +++ doc/flush.n @@ -41,5 +41,8 @@ .CE .SH "SEE ALSO" file(n), open(n), socket(n), Tcl_StandardChannels(3) .SH KEYWORDS blocking, buffer, channel, flush, nonblocking, output + +.SH CATEGORY +Tcl Input/Output Index: doc/for.n ================================================================== --- doc/for.n +++ doc/for.n @@ -80,8 +80,10 @@ .CE .SH "SEE ALSO" break(n), continue(n), foreach(n), while(n) .SH KEYWORDS boolean, for, iteration, loop +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/foreach.n ================================================================== --- doc/foreach.n +++ doc/foreach.n @@ -100,5 +100,8 @@ .SH "SEE ALSO" for(n), while(n), break(n), continue(n) .SH KEYWORDS foreach, iteration, list, loop + +.SH CATEGORY +Tcl Control Constructs Index: doc/format.n ================================================================== --- doc/format.n +++ doc/format.n @@ -278,8 +278,10 @@ .CE .SH "SEE ALSO" scan(n), sprintf(3), string(n) .SH KEYWORDS conversion specifier, format, sprintf, string, substitution +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/gets.n ================================================================== --- doc/gets.n +++ doc/gets.n @@ -63,9 +63,11 @@ .SH "SEE ALSO" file(n), eof(n), fblocked(n), Tcl_StandardChannels(3) .SH KEYWORDS blocking, channel, end of file, end of line, line, non-blocking, read +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/glob.n ================================================================== --- doc/glob.n +++ doc/glob.n @@ -266,8 +266,10 @@ .CE .SH "SEE ALSO" file(n) .SH KEYWORDS exist, file, glob, pattern +.SH CATEGORY +Tcl System Related '\" Local Variables: '\" mode: nroff '\" End: Index: doc/global.n ================================================================== --- doc/global.n +++ doc/global.n @@ -54,5 +54,8 @@ .CE .SH "SEE ALSO" namespace(n), upvar(n), variable(n) .SH KEYWORDS global, namespace, procedure, variable + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/history.n ================================================================== --- doc/history.n +++ doc/history.n @@ -98,5 +98,8 @@ If you want to redo an event without modifying history, then use the \fBevent\fR operation to retrieve some event, and the \fBadd\fR operation to add it to history and execute it. .SH KEYWORDS event, history, record + +.SH CATEGORY +Tcl Interpreter Routines Index: doc/http.n ================================================================== --- doc/http.n +++ doc/http.n @@ -639,8 +639,10 @@ .CE .SH "SEE ALSO" safe(n), socket(n), safesock(n) .SH KEYWORDS internet, security policy, socket, www +.SH CATEGORY +Tcl Library Procedures '\" Local Variables: '\" mode: nroff '\" End: Index: doc/if.n ================================================================== --- doc/if.n +++ doc/if.n @@ -81,8 +81,10 @@ .CE .SH "SEE ALSO" expr(n), for(n), foreach(n) .SH KEYWORDS boolean, conditional, else, false, if, true +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/incr.n ================================================================== --- doc/incr.n +++ doc/incr.n @@ -57,5 +57,8 @@ .CE .SH "SEE ALSO" expr(n), set(n) .SH KEYWORDS add, increment, variable, value + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/info.n ================================================================== --- doc/info.n +++ doc/info.n @@ -769,9 +769,11 @@ command, information, interpreter, introspection, level, namespace, .VS 8.6 object, .VE 8.6 procedure, variable +.SH CATEGORY +Tcl Interpreter Routines '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/interp.n ================================================================== --- doc/interp.n +++ doc/interp.n @@ -903,8 +903,10 @@ .CE .SH "SEE ALSO" bgerror(n), load(n), safe(n), Tcl_CreateSlave(3), Tcl_Eval(3), Tcl_BackgroundException(3) .SH KEYWORDS alias, master interpreter, safe interpreter, slave interpreter +.SH CATEGORY +Tcl Interpreter Routines '\"Local Variables: '\"mode: nroff '\"End: Index: doc/join.n ================================================================== --- doc/join.n +++ doc/join.n @@ -40,5 +40,8 @@ .CE .SH "SEE ALSO" list(n), lappend(n), split(n) .SH KEYWORDS element, join, list, separator + +.SH CATEGORY +Tcl List Handling Index: doc/lappend.n ================================================================== --- doc/lappend.n +++ doc/lappend.n @@ -45,5 +45,8 @@ .SH "SEE ALSO" list(n), lindex(n), linsert(n), llength(n), lset(n), lsort(n), lrange(n) .SH KEYWORDS append, element, list, variable + +.SH CATEGORY +Tcl List Handling Procedures Index: doc/lassign.n ================================================================== --- doc/lassign.n +++ doc/lassign.n @@ -53,8 +53,12 @@ .CE .SH "SEE ALSO" lindex(n), list(n), lrange(n), lset(n), set(n) .SH KEYWORDS assign, element, list, multiple, set, variable +.SH CATEGORY +Tcl List Handling '\"Local Variables: '\"mode: nroff +'\"End: +ff '\"End: Index: doc/library.n ================================================================== --- doc/library.n +++ doc/library.n @@ -307,8 +307,10 @@ Unix, words are comprised of numbers, letters or underscores. .SH "SEE ALSO" info(n), re_syntax(n), tclvars(n) .SH KEYWORDS auto-exec, auto-load, library, unknown, word, whitespace +.SH CATEGORY +Tcl Packages and Source files '\"Local Variables: '\"mode: nroff '\"End: Index: doc/lindex.n ================================================================== --- doc/lindex.n +++ doc/lindex.n @@ -118,8 +118,10 @@ list(n), lappend(n), linsert(n), llength(n), lsearch(n), lset(n), lsort(n), lrange(n), lreplace(n), string(n) .SH KEYWORDS element, index, list +.SH CATEGORY +Tcl List Handling '\"Local Variables: '\"mode: nroff '\"End: Index: doc/linsert.n ================================================================== --- doc/linsert.n +++ doc/linsert.n @@ -48,8 +48,10 @@ list(n), lappend(n), lindex(n), llength(n), lsearch(n), lset(n), lsort(n), lrange(n), lreplace(n), string(n) .SH KEYWORDS element, insert, list +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/list.n ================================================================== --- doc/list.n +++ doc/list.n @@ -49,8 +49,10 @@ lappend(n), lindex(n), linsert(n), llength(n), lrange(n), lrepeat(n), lreplace(n), lsearch(n), lset(n), lsort(n) .SH KEYWORDS element, list, quoting +.SH CATEGORY +Tcl List Handling '\"Local Variables: '\"mode: nroff '\"End: Index: doc/llength.n ================================================================== --- doc/llength.n +++ doc/llength.n @@ -51,5 +51,8 @@ .SH "SEE ALSO" list(n), lappend(n), lindex(n), linsert(n), lsearch(n), lset(n), lsort(n), lrange(n), lreplace(n) .SH KEYWORDS element, list, length + +.SH CATEGORY +Tcl List Handling Index: doc/lmap.n ================================================================== --- doc/lmap.n +++ doc/lmap.n @@ -78,8 +78,10 @@ .CE .SH "SEE ALSO" break(n), continue(n), for(n), foreach(n), while(n) .SH KEYWORDS foreach, iteration, list, loop, map +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/load.n ================================================================== --- doc/load.n +++ doc/load.n @@ -189,8 +189,10 @@ .CE .SH "SEE ALSO" info sharedlibextension, package(n), Tcl_StaticPackage(3), safe(n) .SH KEYWORDS binary code, dynamic library, load, safe interpreter, shared library +.SH CATEGORY +Tcl Packages and Source files '\"Local Variables: '\"mode: nroff '\"End: Index: doc/lrange.n ================================================================== --- doc/lrange.n +++ doc/lrange.n @@ -74,5 +74,8 @@ list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n), lset(n), lreplace(n), lsort(n), string(n) .SH KEYWORDS element, list, range, sublist + +.SH CATEGORY +Tcl List Handling Index: doc/lrepeat.n ================================================================== --- doc/lrepeat.n +++ doc/lrepeat.n @@ -34,5 +34,8 @@ .SH "SEE ALSO" list(n), lappend(n), linsert(n), llength(n), lset(n) .SH KEYWORDS element, index, list + +.SH CATEGORY +Tcl List Handling Index: doc/lreplace.n ================================================================== --- doc/lreplace.n +++ doc/lreplace.n @@ -82,5 +82,8 @@ list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n), lset(n), lrange(n), lsort(n), string(n) .SH KEYWORDS element, list, replace + +.SH CATEGORY +Tcl List Handling Index: doc/lreverse.n ================================================================== --- doc/lreverse.n +++ doc/lreverse.n @@ -27,8 +27,10 @@ .SH "SEE ALSO" list(n), lsearch(n), lsort(n) .SH KEYWORDS element, list, reverse +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/lsearch.n ================================================================== --- doc/lsearch.n +++ doc/lsearch.n @@ -213,8 +213,10 @@ lset(n), lsort(n), lrange(n), lreplace(n), string(n) .SH KEYWORDS binary search, linear search, list, match, pattern, regular expression, search, string +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/lset.n ================================================================== --- doc/lset.n +++ doc/lset.n @@ -139,8 +139,12 @@ list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n), lsort(n), lrange(n), lreplace(n), string(n) .SH KEYWORDS element, index, list, replace, set +.SH CATEGORY +Tcl List Handling '\"Local Variables: '\"mode: nroff +'\"End: +ff '\"End: Index: doc/lsort.n ================================================================== --- doc/lsort.n +++ doc/lsort.n @@ -267,8 +267,10 @@ .SH "SEE ALSO" list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n), lset(n), lrange(n), lreplace(n) .SH KEYWORDS element, list, order, sort +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/mathfunc.n ================================================================== --- doc/mathfunc.n +++ doc/mathfunc.n @@ -291,10 +291,12 @@ The argument may be any numeric value. The integer part of \fIarg\fR is determined, and then the low order 64 bits of that integer value are returned as an integer value. .SH "SEE ALSO" expr(n), mathop(n), namespace(n) +.SH "CATEGORY" +General .SH "COPYRIGHT" .nf Copyright (c) 1993 The Regents of the University of California. Copyright (c) 1994-2000 Sun Microsystems Incorporated. Copyright (c) 2005, 2006 by Kevin B. Kenny . Index: doc/mathop.n ================================================================== --- doc/mathop.n +++ doc/mathop.n @@ -303,8 +303,10 @@ .CE .SH "SEE ALSO" expr(n), mathfunc(n), namespace(n) .SH KEYWORDS command, expression, operator +.SH CATEGORY +General '\" Local Variables: '\" mode: nroff '\" End: Index: doc/memory.n ================================================================== --- doc/memory.n +++ doc/memory.n @@ -108,8 +108,10 @@ occur long after the overwrite occurred. .SH "SEE ALSO" ckalloc, ckfree, Tcl_ValidateAllMemory, Tcl_DumpActiveMemory, TCL_MEM_DEBUG .SH KEYWORDS memory, debug +.SH CATEGORY +Tcl Interpreter Routines '\"Local Variables: '\"mode: nroff '\"End: Index: doc/msgcat.n ================================================================== --- doc/msgcat.n +++ doc/msgcat.n @@ -377,8 +377,10 @@ The message catalog code was developed by Mark Harrison. .SH "SEE ALSO" format(n), scan(n), namespace(n), package(n) .SH KEYWORDS internationalization, i18n, localization, l10n, message, text, translation +.SH CATEGORY +Tcl Library Procedures .\" Local Variables: .\" mode: nroff .\" End: Index: doc/my.n ================================================================== --- doc/my.n +++ doc/my.n @@ -48,9 +48,11 @@ .SH "SEE ALSO" next(n), oo::object(n), self(n) .SH KEYWORDS method, method visibility, object, private method, public method +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/namespace.n ================================================================== --- doc/namespace.n +++ doc/namespace.n @@ -962,8 +962,10 @@ .VE 8.6 .SH "SEE ALSO" interp(n), upvar(n), variable(n) .SH KEYWORDS command, ensemble, exported, internal, variable +.SH CATEGORY +Tcl Variables and Procedures '\" Local Variables: '\" mode: nroff '\" End: Index: doc/next.n ================================================================== --- doc/next.n +++ doc/next.n @@ -195,9 +195,11 @@ .CE .SH "SEE ALSO" oo::class(n), oo::define(n), oo::object(n), self(n) .SH KEYWORDS call, method, method chain +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/object.n ================================================================== --- doc/object.n +++ doc/object.n @@ -120,9 +120,11 @@ .CE .SH "SEE ALSO" my(n), oo::class(n) .SH KEYWORDS base class, class, object, root class +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/open.n ================================================================== --- doc/open.n +++ doc/open.n @@ -458,8 +458,10 @@ file(n), close(n), filename(n), fconfigure(n), gets(n), read(n), puts(n), exec(n), pid(n), fopen(3) .SH KEYWORDS access mode, append, create, file, non-blocking, open, permissions, pipeline, process, serial +.SH CATEGORY +Tcl Input/Output '\"Local Variables: '\"mode: nroff '\"End: Index: doc/package.n ================================================================== --- doc/package.n +++ doc/package.n @@ -363,8 +363,10 @@ .CE .SH "SEE ALSO" msgcat(n), packagens(n), pkgMkIndex(n) .SH KEYWORDS package, version +.SH CATEGORY +Tcl Packages and Source files '\" Local Variables: '\" mode: nroff '\" End: Index: doc/packagens.n ================================================================== --- doc/packagens.n +++ doc/packagens.n @@ -46,5 +46,8 @@ At least one \fB\-load\fR or \fB\-source\fR parameter must be given. .SH "SEE ALSO" package(n) .SH KEYWORDS auto-load, index, package, version + +.SH CATEGORY +Tcl Packages and Source files Index: doc/pid.n ================================================================== --- doc/pid.n +++ doc/pid.n @@ -44,5 +44,8 @@ .SH "SEE ALSO" exec(n), open(n) .SH KEYWORDS file, pipeline, process identifier + +.SH CATEGORY +Tcl System Related Index: doc/pkgMkIndex.n ================================================================== --- doc/pkgMkIndex.n +++ doc/pkgMkIndex.n @@ -226,8 +226,10 @@ the binary file may mask the package defined by the scripts. .SH "SEE ALSO" package(n) .SH KEYWORDS auto-load, index, package, version +.SH CATEGORY +Tcl Packages and Source files '\"Local Variables: '\"mode: nroff '\"End: Index: doc/platform.n ================================================================== --- doc/platform.n +++ doc/platform.n @@ -79,8 +79,10 @@ set platLibDir [file join $libDir [\fBplatform::identify\fR]] load [file join $platLibDir support[info sharedlibextension]] .CE .SH KEYWORDS operating system, cpu architecture, platform, architecture +.SH CATEGORY +Tcl System Related '\" Local Variables: '\" mode: nroff '\" End: Index: doc/platform_shell.n ================================================================== --- doc/platform_shell.n +++ doc/platform_shell.n @@ -53,5 +53,8 @@ \fBplatform::shell::platform \fIshell\fR This command returns the contents of \fBtcl_platform(platform)\fR for the specified Tcl shell. .SH KEYWORDS operating system, cpu architecture, platform, architecture + +.SH CATEGORY +Tcl System Related Index: doc/prefix.n ================================================================== --- doc/prefix.n +++ doc/prefix.n @@ -109,8 +109,10 @@ .CE .SH "SEE ALSO" lsearch(n), namespace(n), string(n), Tcl_GetIndexFromObj(3) .SH "KEYWORDS" prefix, table lookup +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/proc.n ================================================================== --- doc/proc.n +++ doc/proc.n @@ -103,8 +103,10 @@ .CE .SH "SEE ALSO" info(n), unknown(n) .SH KEYWORDS argument, procedure +.SH CATEGORY +Tcl Variables and Procedures '\" Local Variables: '\" mode: nroff '\" End: Index: doc/puts.n ================================================================== --- doc/puts.n +++ doc/puts.n @@ -94,5 +94,8 @@ .CE .SH "SEE ALSO" file(n), fileevent(n), Tcl_StandardChannels(3) .SH KEYWORDS channel, newline, output, write + +.SH CATEGORY +Tcl Input/Output Index: doc/pwd.n ================================================================== --- doc/pwd.n +++ doc/pwd.n @@ -35,5 +35,8 @@ .CE .SH "SEE ALSO" file(n), cd(n), glob(n), filename(n) .SH KEYWORDS working directory + +.SH CATEGORY +Tcl System Related Index: doc/re_syntax.n ================================================================== --- doc/re_syntax.n +++ doc/re_syntax.n @@ -827,8 +827,10 @@ respectively; no other escapes are available. .SH "SEE ALSO" RegExp(3), regexp(n), regsub(n), lsearch(n), switch(n), text(n) .SH KEYWORDS match, regular expression, string +.SH CATEGORY +Tcl String Handling .\" Local Variables: .\" mode: nroff .\" End: Index: doc/read.n ================================================================== --- doc/read.n +++ doc/read.n @@ -82,8 +82,10 @@ .CE .SH "SEE ALSO" file(n), eof(n), fblocked(n), fconfigure(n), Tcl_StandardChannels(3) .SH KEYWORDS blocking, channel, end of line, end of file, nonblocking, read, translation, encoding +.SH CATEGORY +Tcl Input/Output '\"Local Variables: '\"mode: nroff '\"End: Index: doc/refchan.n ================================================================== --- doc/refchan.n +++ doc/refchan.n @@ -404,8 +404,10 @@ .CE .SH "SEE ALSO" chan(n), transchan(n) .SH KEYWORDS API, channel, ensemble, prefix, reflection +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" End: Index: doc/regexp.n ================================================================== --- doc/regexp.n +++ doc/regexp.n @@ -201,8 +201,10 @@ .CE .SH "SEE ALSO" re_syntax(n), regsub(n), string(n) .SH KEYWORDS match, parsing, pattern, regular expression, splitting, string +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/registry.n ================================================================== --- doc/registry.n +++ doc/registry.n @@ -211,8 +211,10 @@ puts "$ext opens with $command" .CE .SH KEYWORDS registry +.SH CATEGORY +Tcl Platform-specific '\" Local Variables: '\" mode: nroff '\" End: Index: doc/regsub.n ================================================================== --- doc/regsub.n +++ doc/regsub.n @@ -185,8 +185,10 @@ .CE .SH "SEE ALSO" regexp(n), re_syntax(n), subst(n), string(n) .SH KEYWORDS match, pattern, quoting, regular expression, substitution +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/rename.n ================================================================== --- doc/rename.n +++ doc/rename.n @@ -41,5 +41,8 @@ .CE .SH "SEE ALSO" namespace(n), proc(n) .SH KEYWORDS command, delete, namespace, rename + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/return.n ================================================================== --- doc/return.n +++ doc/return.n @@ -319,8 +319,10 @@ .SH "SEE ALSO" break(n), catch(n), continue(n), dict(n), error(n), proc(n), source(n), tclvars(n), throw(n), try(n) .SH KEYWORDS break, catch, continue, error, exception, procedure, result, return +.SH CATEGORY +Tcl Control Constructs .\" Local Variables: .\" mode: nroff .\" End: Index: doc/safe.n ================================================================== --- doc/safe.n +++ doc/safe.n @@ -352,8 +352,10 @@ .SH "SEE ALSO" interp(n), library(n), load(n), package(n), source(n), unknown(n) .SH KEYWORDS alias, auto\-loading, auto_mkindex, load, master interpreter, safe interpreter, slave interpreter, source +.SH CATEGORY +General '\" Local Variables: '\" mode: nroff '\" End: Index: doc/scan.n ================================================================== --- doc/scan.n +++ doc/scan.n @@ -286,8 +286,10 @@ .CE .SH "SEE ALSO" format(n), sscanf(3) .SH KEYWORDS conversion specifier, parse, scan +.SH CATEGORY +Tcl String Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/seek.n ================================================================== --- doc/seek.n +++ doc/seek.n @@ -84,9 +84,11 @@ .CE .SH "SEE ALSO" file(n), open(n), close(n), gets(n), tell(n), Tcl_StandardChannels(3) .SH KEYWORDS access position, file, seek +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/self.n ================================================================== --- doc/self.n +++ doc/self.n @@ -144,9 +144,11 @@ .CE .SH "SEE ALSO" info(n), next(n) .SH KEYWORDS call, introspection, object +.SH CATEGORY +Tcl Object Orientation .\" Local variables: .\" mode: nroff .\" fill-column: 78 .\" End: Index: doc/set.n ================================================================== --- doc/set.n +++ doc/set.n @@ -71,5 +71,8 @@ .CE .SH "SEE ALSO" expr(n), global(n), namespace(n), proc(n), trace(n), unset(n), upvar(n), variable(n) .SH KEYWORDS read, write, variable + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/socket.n ================================================================== --- doc/socket.n +++ doc/socket.n @@ -220,8 +220,10 @@ Support for IPv6 was added in Tcl 8.6. .SH "SEE ALSO" chan(n), flush(n), open(n), read(n) .SH KEYWORDS asynchronous I/O, bind, channel, connection, domain name, host, network address, socket, tcp +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" End: Index: doc/source.n ================================================================== --- doc/source.n +++ doc/source.n @@ -65,5 +65,8 @@ .CE .SH "SEE ALSO" file(n), cd(n), encoding(n), info(n) .SH KEYWORDS file, script + +.SH CATEGORY +Tcl Packages and Source files Index: doc/split.n ================================================================== --- doc/split.n +++ doc/split.n @@ -86,8 +86,10 @@ .CE .SH "SEE ALSO" join(n), list(n), string(n) .SH KEYWORDS list, split, string +.SH CATEGORY +Tcl List Handling '\" Local Variables: '\" mode: nroff '\" End: Index: doc/string.n ================================================================== --- doc/string.n +++ doc/string.n @@ -442,8 +442,10 @@ .SH "SEE ALSO" expr(n), list(n) .SH KEYWORDS case conversion, compare, index, match, pattern, string, word, equal, ctype, character, reverse +.SH CATEGORY +Tcl String Handling .\" Local Variables: .\" mode: nroff .\" End: Index: doc/subst.n ================================================================== --- doc/subst.n +++ doc/subst.n @@ -157,8 +157,10 @@ .QW \fBabc,3,def\fR . .SH "SEE ALSO" Tcl(n), eval(n), break(n), continue(n) .SH KEYWORDS backslash substitution, command substitution, quoting, substitution, variable substitution +.SH CATEGORY +Tcl String Handling .\" Local Variables: .\" mode: nroff .\" End: Index: doc/switch.n ================================================================== --- doc/switch.n +++ doc/switch.n @@ -179,8 +179,10 @@ .CE .SH "SEE ALSO" for(n), if(n), regexp(n) .SH KEYWORDS switch, match, regular expression +.SH CATEGORY +Tcl Control Constructs .\" Local Variables: .\" mode: nroff .\" End: Index: doc/tailcall.n ================================================================== --- doc/tailcall.n +++ doc/tailcall.n @@ -61,9 +61,11 @@ .CE .SH "SEE ALSO" apply(n), proc(n), uplevel(n) .SH KEYWORDS call, recursion, tail recursion +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/tclsh.1 ================================================================== --- doc/tclsh.1 +++ doc/tclsh.1 @@ -143,5 +143,8 @@ See \fBTcl_StandardChannels\fR for more explanations. .SH "SEE ALSO" encoding(n), fconfigure(n), tclvars(n) .SH KEYWORDS application, argument, interpreter, prompt, script file, shell + +.SH CATEGORY +General Index: doc/tcltest.n ================================================================== --- doc/tcltest.n +++ doc/tcltest.n @@ -1250,8 +1250,10 @@ Therefore, usage of the \fB\-output\fR and \fB\-errorOutput\fR options to \fBtest\fR is useful only for pure Tcl applications that use \fBputs\fR to produce output. .SH KEYWORDS test, test harness, test suite +.SH CATEGORY +General .\" Local Variables: .\" mode: nroff .\" End: Index: doc/tclvars.n ================================================================== --- doc/tclvars.n +++ doc/tclvars.n @@ -559,8 +559,10 @@ .SH "SEE ALSO" eval(n), library(n), tclsh(1), tkvars(n), wish(1) .SH KEYWORDS arithmetic, bytecode, compiler, error, environment, POSIX, precision, subprocess, user, variables +.SH CATEGORY +Predefined variables '\" Local Variables: '\" mode: nroff '\" End: Index: doc/tell.n ================================================================== --- doc/tell.n +++ doc/tell.n @@ -44,5 +44,8 @@ .CE .SH "SEE ALSO" file(n), open(n), close(n), gets(n), seek(n), Tcl_StandardChannels(3) .SH KEYWORDS access position, channel, seeking + +.SH CATEGORY +Tcl Input/Output Index: doc/throw.n ================================================================== --- doc/throw.n +++ doc/throw.n @@ -41,8 +41,10 @@ .CE .SH "SEE ALSO" catch(n), error(n), return(n), tclvars(n), try(n) .SH "KEYWORDS" error, exception +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/time.n ================================================================== --- doc/time.n +++ doc/time.n @@ -40,8 +40,10 @@ .CE .SH "SEE ALSO" clock(n) .SH KEYWORDS script, time +.SH CATEGORY +Tcl System Related .\" Local Variables: .\" mode: nroff .\" End: Index: doc/tm.n ================================================================== --- doc/tm.n +++ doc/tm.n @@ -301,8 +301,10 @@ (online at http://tip.tcl.tk/189.html), Tcl Improvement Proposal #190 .QW "\fIImplementation Choices for Tcl Modules\fR" (online at http://tip.tcl.tk/190.html) .SH "KEYWORDS" modules, package +.SH CATEGORY +Tcl Packages and Source files .\" Local Variables: .\" mode: nroff .\" End: Index: doc/trace.n ================================================================== --- doc/trace.n +++ doc/trace.n @@ -419,8 +419,10 @@ .CE .SH "SEE ALSO" set(n), unset(n) .SH KEYWORDS read, command, rename, variable, write, trace, unset +.SH CATEGORY +Tcl Variables and Procedures .\" Local Variables: .\" mode: nroff .\" End: Index: doc/transchan.n ================================================================== --- doc/transchan.n +++ doc/transchan.n @@ -153,8 +153,10 @@ .RE .SH "SEE ALSO" chan(n), refchan(n) .SH KEYWORDS API, channel, ensemble, prefix, transformation +.SH CATEGORY +Tcl Input/Output '\" Local Variables: '\" mode: nroff '\" End: Index: doc/try.n ================================================================== --- doc/try.n +++ doc/try.n @@ -96,8 +96,10 @@ .CE .SH "SEE ALSO" catch(n), error(n), return(n), throw(n) .SH "KEYWORDS" cleanup, error, exception, final, resource management +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" End: Index: doc/unknown.n ================================================================== --- doc/unknown.n +++ doc/unknown.n @@ -87,5 +87,8 @@ .CE .SH "SEE ALSO" info(n), proc(n), interp(n), library(n), namespace(n) .SH KEYWORDS error, non-existent command, unknown + +.SH CATEGORY +Tcl Interpreter Routines Index: doc/unload.n ================================================================== --- doc/unload.n +++ doc/unload.n @@ -165,8 +165,10 @@ without having to shut down the overall Tcl process. .SH "SEE ALSO" info sharedlibextension, load(n), safe(n) .SH KEYWORDS binary code, unloading, safe interpreter, shared library +.SH CATEGORY +Tcl Packages and Source files .\" Local Variables: .\" mode: nroff .\" End: Index: doc/unset.n ================================================================== --- doc/unset.n +++ doc/unset.n @@ -60,9 +60,11 @@ .CE .SH "SEE ALSO" set(n), trace(n), upvar(n) .SH KEYWORDS remove, variable +.SH CATEGORY +Tcl Variables and Procedures '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/update.n ================================================================== --- doc/update.n +++ doc/update.n @@ -61,5 +61,8 @@ .CE .SH "SEE ALSO" after(n), interp(n) .SH KEYWORDS asynchronous I/O, event, flush, handler, idle, update + +.SH CATEGORY +Tcl Control Constructs Index: doc/uplevel.n ================================================================== --- doc/uplevel.n +++ doc/uplevel.n @@ -96,8 +96,10 @@ .CE .SH "SEE ALSO" apply(n), namespace(n), upvar(n) .SH KEYWORDS context, level, namespace, stack frame, variable +.SH CATEGORY +Tcl Control Constructs .\" Local Variables: .\" mode: nroff .\" End: Index: doc/upvar.n ================================================================== --- doc/upvar.n +++ doc/upvar.n @@ -115,8 +115,10 @@ .CE .SH "SEE ALSO" global(n), namespace(n), uplevel(n), variable(n) .SH KEYWORDS context, frame, global, level, namespace, procedure, upvar, variable +.SH CATEGORY +Tcl Variables and Procedures .\" Local Variables: .\" mode: nroff .\" End: Index: doc/variable.n ================================================================== --- doc/variable.n +++ doc/variable.n @@ -96,5 +96,8 @@ .CE .SH "SEE ALSO" global(n), namespace(n), upvar(n) .SH KEYWORDS global, namespace, procedure, variable + +.SH CATEGORY +Tcl Variables and Procedures Index: doc/vwait.n ================================================================== --- doc/vwait.n +++ doc/vwait.n @@ -238,9 +238,11 @@ .CE .SH "SEE ALSO" global(n), update(n) .SH KEYWORDS asynchronous I/O, event, variable, wait +.SH CATEGORY +Tcl Control Constructs '\" Local Variables: '\" mode: nroff '\" fill-column: 78 '\" End: Index: doc/while.n ================================================================== --- doc/while.n +++ doc/while.n @@ -61,5 +61,8 @@ .CE .SH "SEE ALSO" break(n), continue(n), for(n), foreach(n) .SH KEYWORDS boolean, loop, test, while + +.SH CATEGORY +Tcl Control Constructs Index: doc/zlib.n ================================================================== --- doc/zlib.n +++ doc/zlib.n @@ -453,8 +453,10 @@ .CE .SH "SEE ALSO" binary(n), chan(n), encoding(n), Tcl_ZlibDeflate(3), RFC1950 \- RFC1952 .SH "KEYWORDS" compress, decompress, deflate, gzip, inflate, zlib +.SH CATEGORY +Tcl Library Procedures '\" Local Variables: '\" mode: nroff '\" End: Index: tools/tcltk-man2html-utils.tcl ================================================================== --- tools/tcltk-man2html-utils.tcl +++ tools/tcltk-man2html-utils.tcl @@ -633,10 +633,12 @@ if {[llength $name] > 1} { manerror "name has a space: {$name}\nfrom: $line" } lappend manual(wing-toc) $name lappend manual(name-$name) $manual(wing-file)/$manual(name) + set manual(descrip-$name) $tail + set manual(cat-master-$name) $manual(name) } set manual(tooltip-$manual(wing-file)/$manual(name).htm) $line } ## @@ -1044,10 +1046,27 @@ lappend keys "$key" } man-puts [join $keys {, }] } return + } + H:CATEGORY { + while {[more-text]} { + if {[next-op-is .SH rest] || [next-op-is .SS rest]} { + backup-text 1 + return + } + set more [next-text] + if {[is-a-directive $more]} { + manerror "$more" + backup-text 1 + return + } + set manual(category-$manual(name)) $more + man-puts $more + } + return } } if {[next-op-is .IP rest]} { output-IP-list $code .IP $rest return @@ -1562,35 +1581,47 @@ } } set perline [expr {118 / $width}] set nrows [expr {([llength $manual(wing-toc)]+$perline)/$perline}] set n 0 - catch {unset rows} - foreach name [lsort -dictionary $manual(wing-toc)] { + catch { unset toc } + foreach name [lsort $manual(wing-toc)] { set tail $manual(name-$name) if {[llength $tail] > 1} { manerror "$name is defined in more than one file: $tail" set tail [lindex $tail [expr {[llength $tail]-1}]] } + set category "" + set catMaster $name + if {[info exists manual(cat-master-$name)]} { + set catMaster $manual(cat-master-$name) + } + if {[info exists manual(category-$catMaster)]} { +#FIXME-TD we want to have the option to group contents by category, if enabled + set category $manual(category-$catMaster) + } set tail [file tail $tail] if {[info exists manual(tooltip-$manual(wing-file)/$tail.htm)]} { set tooltip $manual(tooltip-$manual(wing-file)/$tail.htm) set tooltip [string map {[ {\[} ] {\]} $ {\$} \\ \\\\} $tooltip] regsub {^[^-]+-\s*(.)} $tooltip {[string totitle \1]} tooltip - append rows([expr {$n%$nrows}]) \ - " $name " + lappend toc($category) \ + "
  • $name $manual(descrip-$name)
    • " } else { - append rows([expr {$n%$nrows}]) \ - " $name " + lappend toc($category) \ + "
  • $name $manual(descrip-$name)
    • " } incr n } - puts $manual(wing-toc-fp) - foreach row [lsort -integer [array names rows]] { - puts $manual(wing-toc-fp) $rows($row) + foreach category [lsort [array names toc]] { + if { $category ne "" } { + puts $manual(wing-toc-fp) "

    $category

    " + } + puts $manual(wing-toc-fp) {
      } + puts $manual(wing-toc-fp) [join $toc($category) \n] + puts $manual(wing-toc-fp)
    } - puts $manual(wing-toc-fp)
    # # insert wing copyrights # puts $manual(wing-toc-fp) [copyout $manual(wing-copyrights) "../"] Index: tools/tcltk-man2html.tcl ================================================================== --- tools/tcltk-man2html.tcl +++ tools/tcltk-man2html.tcl @@ -34,17 +34,18 @@ proc parse_command_line {} { global argv Version # These variables determine where the man pages come from and where # the converted pages go to. - global tcltkdir tkdir tcldir webdir build_tcl build_tk verbose + global tcltkdir tkdir tcldir webdir pkgsDir build_tcl build_tk verbose # Set defaults based on original code. set tcltkdir ../.. set tkdir {} set tcldir {} set webdir ../html + set pkgsDir {} set build_tcl 0 set build_tk 0 set verbose 0 # Default search version is a glob pattern set useversion {{,[8-9].[0-9]{,[.ab][0-9]{,[0-9]}}}} @@ -67,10 +68,11 @@ puts "usage: tcltk-man-html \[OPTION\] ...\n" puts " --help print this help, then exit" puts " --version print version number, then exit" puts " --srcdir=DIR find tcl and tk source below DIR" puts " --htmldir=DIR put generated HTML in DIR" + puts " --pkgdir=DIR find package sources below DIR" puts " --tcl build tcl help" puts " --tk build tk help" puts " --useversion version of tcl/tk to search for" puts " --verbose whether to print longer messages" exit 0 @@ -83,10 +85,15 @@ --htmldir=* { # length of "--htmldir=" is 10 set webdir [string range $option 10 end] } + + --pkgdir=* { + # length of "--pkgdir=" is 9 + set pkgsDir [string range $option 9 end] + } --useversion=* { # length of "--useversion=" is 13 set useversion [string range $option 13 end] } @@ -134,10 +141,17 @@ puts stderr "tcltk-man-html: couldn't find Tk below $tcltkdir" exit 1 } puts "using Tk source directory $tkdir" } + + if { $pkgsDir eq {} } { + # Use default packages dir. + set pkgsDir [file join $tcltkdir $tcldir pkgs] + } + set pkgsDir [file normalize $pkgsDir] + puts "using Packages source directory $pkgsDir" puts "verbose messages are [expr {$verbose ? {on} : {off}}]" # the title for the man pages overall global overall_title @@ -217,10 +231,19 @@ css-style h3 { font-size: 12px; } css-style h4 { font-size: 11px; + } + css-style ul.multicolumn { + column-fill: balance; + column-count: 3; + -moz-column-count: 3; + -webkit-column-count: 3; + column-gap: 20px; + -moz-column-gap: 20px; + -webkit-column-gap: 20px; } css-style ".keylist dt" ".arguments dt" { width: 20em; float: left; padding: 2px; @@ -452,22 +475,21 @@ ## ## Helper for assembling the descriptions of contributed packages. ## proc plus-pkgs {type args} { - global build_tcl tcltkdir tcldir + global build_tcl tcltkdir tcldir pkgsDir if {$type ni {n 3}} { error "unknown type \"$type\": must be 3 or n" } if {!$build_tcl} return set result {} - set pkgsdir $tcltkdir/$tcldir/pkgs foreach {dir name version} $args { - set globpat $pkgsdir/$dir/doc/*.$type + set globpat [file join $pkgsDir $dir doc *.$type] if {![llength [glob -type f -nocomplain $globpat]]} { # Fallback for manpages generated using doctools - set globpat $pkgsdir/$dir/doc/man/*.$type + set globpat [file join $pkgsDir $dir doc man *.$type] if {![llength [glob -type f -nocomplain $globpat]]} { continue } } switch $type { @@ -649,11 +671,10 @@ # When building docs for Tcl, try to build docs for bundled packages too set packageBuildList {} if {$build_tcl} { - set pkgsDir [file join $tcltkdir $tcldir pkgs] set subdirs [glob -nocomplain -types d -tails -directory $pkgsDir *] foreach dir [lsort $subdirs] { # Parse the subdir name into (name, version) as fallback... set description [split $dir -] @@ -670,11 +691,13 @@ { AC_INIT ( [%[^]]] , [%[^]]] ) } n v]} { set description [list $n $v] break } } - } finally { + } trap {POSIX ENOENT} {e} { + puts stderr "warning: no 'configure.in' in '[file nativename [file join $pkgsDir $dir]]'" + } finally { catch {close $f; unset f} } if {[file exists [file join $pkgsDir $dir configure]]} { # Looks like a package, record our best extraction attempt