Experimental: categories added to man pages; enhance tcltk-man2html to use categories to render ToC

Join paths with 'file join' not as strings to avoid platform-specific separator problems
FRQ-3599786: add command line option --pkgdir to tcltk-man2html.tcl to specify the directory under which package sources can be found (default tcldir/pkgs).
2013-01-09 16:43:33 +00:00 · 2013-01-09 08:17:12 +00:00 · 2013-01-07 13:16:12 +00:00
233 changed files with 672 additions and 17 deletions
@@ -67,5 +67,7 @@ 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)
@@ -310,3 +310,6 @@ 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
@@ -90,3 +90,6 @@ 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
@@ -42,3 +42,6 @@ such as \fBTCL_BREAK\fR or \fBTCL_CONTINUE\fR in a meaningful way.

 .SH KEYWORDS
 continue, break, exception, interpreter
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -81,3 +81,6 @@ Tcl_Main(3)

 .SH KEYWORDS
 application, argument, command, initialization, interpreter
+
+.SH CATEGORY
+Initialization
@@ -85,3 +85,6 @@ returns \fBNULL\fR.
 the given interpreter.  Then it calls the deletion procedure.
 .SH KEYWORDS
 association, data, deletion procedure, interpreter, key
+
+.SH CATEGORY
+Utilities
@@ -159,3 +159,6 @@ and then returning the \fIcode\fR argument.

 .SH KEYWORDS
 asynchronous event, handler, signal, Tcl_SaveInterpState, thread
+
+.SH CATEGORY
+The Event Loop
@@ -76,3 +76,6 @@ Tcl_BackgroundException(interp, TCL_ERROR);

 .SH KEYWORDS
 background, bgerror, error, interp
+
+.SH CATEGORY
+Commands
@@ -45,3 +45,6 @@ Tcl(n), Tcl_UtfBackslash(3)

 .SH KEYWORDS
 backslash, parse
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -93,3 +93,6 @@ Tcl_NewObj, Tcl_IsShared, Tcl_GetBoolean

 .SH KEYWORDS
 boolean, value
+
+.SH CATEGORY
+Objects
@@ -89,3 +89,6 @@ Tcl_GetStringFromObj, Tcl_NewObj, Tcl_IncrRefCount, Tcl_DecrRefCount

 .SH KEYWORDS
 value, binary data, byte array, utf, unicode, internationalization
+
+.SH CATEGORY
+Objects
@@ -65,3 +65,6 @@ a callback is received even if the application terminates without deleting the i
 Tcl_CreateExitHandler(3), Tcl_CreateThreadExitHandler(3)
 .SH KEYWORDS
 callback, cleanup, delete, interpreter
+
+.SH CATEGORY
+Initialization
@@ -64,3 +64,6 @@ message is left and the interpreter's result will not be modified.
 TIP 285
 .SH KEYWORDS
 cancel, unwind
+
+.SH CATEGORY
+The Event Loop
@@ -95,3 +95,6 @@ Notifier(3), Tcl_CreateChannel(3), Tcl_OpenFileChannel(3), vwait(n).

 .SH KEYWORDS
 channel, compression
+
+.SH CATEGORY
+Input/Output
@@ -230,6 +230,8 @@ invoked, as provided by the user; this object may be updated by the callback.
 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
@@ -32,3 +32,6 @@ 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
@@ -49,3 +49,6 @@ by calling \fBTcl_Free\fR.
 Tcl_ConcatObj
 .SH KEYWORDS
 concatenate, strings
+
+.SH CATEGORY
+Utilities
@@ -926,3 +926,6 @@ When the above structure is registered as a channel type, the
 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
@@ -87,3 +87,6 @@ for which there are event handlers.
 Notifier(3), Tcl_CreateChannel(3), Tcl_OpenFileChannel(3), vwait(n).
 .SH KEYWORDS
 blocking, callback, channel, events, handler, nonblocking.
+
+.SH CATEGORY
+Input/Output
@@ -53,3 +53,6 @@ for a  close handler for \fIchannel\fR.
 close(n), Tcl_Close(3), Tcl_UnregisterChannel(3)
 .SH KEYWORDS
 callback, channel closing
+
+.SH CATEGORY
+Input/Output
@@ -141,3 +141,6 @@ Tcl_CreateObjCommand, Tcl_DeleteCommand, Tcl_GetCommandInfo,
 Tcl_SetCommandInfo, Tcl_GetCommandName, Tcl_SetObjResult
 .SH KEYWORDS
 bind, command, create, delete, interpreter, namespace
+
+.SH CATEGORY
+Commands
@@ -89,3 +89,6 @@ implementation of the Tcl notifier.
 fileevent(n), Tcl_CreateTimerHandler(3), Tcl_DoWhenIdle(3)
 .SH KEYWORDS
 callback, file, handler
+
+.SH CATEGORY
+Input/Output
@@ -147,3 +147,6 @@ due to inactivity.
 Tcl_Preserve(3), Tcl_Release(3), tclvars(n)
 .SH KEYWORDS
 command, create, delete, interpreter
+
+.SH CATEGORY
+Initialization
@@ -160,3 +160,6 @@ the math functions defined in the interpreter whose name matches
 expr(n), info(n), Tcl_CreateObjCommand(3), Tcl_Free(3), Tcl_NewListObj(3)
 .SH KEYWORDS
 expression, mathematical function
+
+.SH CATEGORY
+Commands
@@ -300,3 +300,6 @@ Returns NULL if the command is not found.
 Tcl_CreateCommand(3), Tcl_ResetResult(3), Tcl_SetObjResult(3)
 .SH KEYWORDS
 bind, command, create, delete, namespace, value
+
+.SH CATEGORY
+Commands
@@ -234,3 +234,6 @@ interp
 .SH KEYWORDS
 alias, command, exposed commands, hidden commands, interpreter, invoke,
 master, slave
+
+.SH CATEGORY
+Initialization
@@ -74,3 +74,6 @@ then the procedure does nothing.
 after(n), Tcl_CreateFileHandler(3), Tcl_DoWhenIdle(3)
 .SH KEYWORDS
 callback, clock, handler, timer
+
+.SH CATEGORY
+The Event Loop
@@ -189,3 +189,6 @@ associated with a call to \fBTcl_CreateTrace\fR to abort execution of
 \fIcommand\fR.
 .SH KEYWORDS
 command, create, delete, interpreter, trace
+
+.SH CATEGORY
+Variables
@@ -151,3 +151,6 @@ the string.

 .SH KEYWORDS
 append, dynamic string, free, result
+
+.SH CATEGORY
+Utilities
@@ -73,3 +73,6 @@ the operating system.

 .SH KEYWORDS
 background, child, detach, process, wait
+
+.SH CATEGORY
+Operating System Interface
@@ -232,3 +232,6 @@ return TCL_OK;
 Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_InitObjHashTable
 .SH KEYWORDS
 dict, dict value, dictionary, dictionary value, hash table, iteration, value
+
+.SH CATEGORY
+Objects
@@ -104,3 +104,6 @@ doing anything else.

 .SH KEYWORDS
 callback, event, handler, idle, timer
+
+.SH CATEGORY
+The Event Loop
@@ -85,3 +85,6 @@ better to use a timer handler with a zero timeout period.
 after(n), Tcl_CreateFileHandler(3), Tcl_CreateTimerHandler(3)
 .SH KEYWORDS
 callback, defer, idle callback
+
+.SH CATEGORY
+The Event Loop
@@ -62,3 +62,6 @@ calls to \fBTcl_GetDoubleFromObj\fR more efficient.
 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
@@ -66,3 +66,6 @@ TCL_MEM_DEBUG, memory
 memory, debug


+
+.SH CATEGORY
+Utilities
@@ -590,3 +590,6 @@ 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
@@ -217,3 +217,6 @@ using \fBTcl_GetEnsembleNamespace\fR which returns a Tcl result code
 namespace(n), Tcl_DeleteCommandFromToken(3)
 .SH KEYWORDS
 command, ensemble
+
+.SH CATEGORY
+Commands
@@ -36,3 +36,6 @@ runtime.
 tclvars(n)
 .SH KEYWORDS
 environment, variable
+
+.SH CATEGORY
+Operating System Interface
@@ -209,3 +209,6 @@ 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
@@ -138,3 +138,6 @@ cast to a ClientData value.
 exit(n)
 .SH KEYWORDS
 abort, callback, cleanup, dynamic loading, end application, exit, unloading, thread
+
+.SH CATEGORY
+Initialization
@@ -104,3 +104,6 @@ Tcl_ExprLongObj, Tcl_ExprDoubleObj, Tcl_ExprBooleanObj, Tcl_ExprObj

 .SH KEYWORDS
 boolean, double, evaluate, expression, integer, value, string
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -104,3 +104,6 @@ Tcl_ExprLong, Tcl_ExprDouble, Tcl_ExprBoolean, Tcl_ExprString, Tcl_GetObjResult

 .SH KEYWORDS
 boolean, double, evaluate, expression, integer, value, string
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -1642,3 +1642,6 @@ directory to the value specified in \fIpathPtr\fR. The function returns
 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
@@ -61,3 +61,6 @@ computed or unknown.

 .SH KEYWORDS
 binary, executable file
+
+.SH CATEGORY
+Initialization
@@ -50,3 +50,6 @@ must be UTF\-8.  The function returns -1 on error or 0 on success.

 .SH KEYWORDS
 pwd
+
+.SH CATEGORY
+Operating System Interface
@@ -25,3 +25,6 @@ not modify of free it.
 .PP
 .SH KEYWORDS
 hostname
+
+.SH CATEGORY
+Operating System Interface
@@ -102,3 +102,6 @@ each of several array elements.
 prefix(n), Tcl_WrongNumArgs(3)
 .SH KEYWORDS
 index, option, value, table lookup
+
+.SH CATEGORY
+Utilities
@@ -84,3 +84,6 @@ are also acceptable.

 .SH KEYWORDS
 boolean, conversion, double, floating-point, integer
+
+.SH CATEGORY
+Utilities
@@ -56,3 +56,6 @@ Note that this interface is only supported on the Unix platform.

 .SH KEYWORDS
 channel, file handle, permissions, pipeline, read, write
+
+.SH CATEGORY
+Input/Output
@@ -84,3 +84,6 @@ 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
@@ -107,3 +107,6 @@ with regard to this situation, i.e. the existing behavior is retained.
 clock(n)
 .SH KEYWORDS
 date, time
+
+.SH CATEGORY
+Operating System Interface
@@ -46,3 +46,6 @@ a NULL for the \fIpatchLevel\fR argument.
 .SH KEYWORDS
 version, patchlevel, major, minor, alpha, beta, release

+
+.SH CATEGORY
+Initialization
@@ -332,3 +332,6 @@ 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
@@ -32,3 +32,6 @@ Tcl_AppInit, Tcl_Main

 .SH KEYWORDS
 application, initialization, interpreter
+
+.SH CATEGORY
+Initialization
@@ -87,3 +87,6 @@ acceptable, does not support stubs, or any other error condition occurred.
 Tk_InitStubs
 .SH KEYWORDS
 stubs
+
+.SH CATEGORY
+Initialization
@@ -150,3 +150,6 @@ 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
@@ -132,3 +132,6 @@ occurred.

 .SH KEYWORDS
 free, initialized, interpreter, malloc, result
+
+.SH CATEGORY
+Initialization
@@ -190,3 +190,6 @@ 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
@@ -205,3 +205,6 @@ to indicate to the thread hosting the interpreter that it is ready to run
 Tcl_TraceVar(3)
 .SH KEYWORDS
 boolean, integer, link, read-only, real, string, trace, variable
+
+.SH CATEGORY
+Variables
@@ -249,3 +249,6 @@ 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
@@ -64,6 +64,8 @@ operation on a handle that has been passed to \fBTcl_FSUnloadFile\fR.
 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
@@ -242,6 +242,8 @@ 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
@@ -324,5 +324,7 @@ and the second is for use when there is already a trampoline in place.
 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
@@ -163,3 +163,6 @@ its default.
 Tcl_CreateCommand(3), Tcl_ListObjAppendList(3), Tcl_SetVar(3)
 .SH KEYWORDS
 namespace, command
+
+.SH CATEGORY
+Variables
@@ -633,3 +633,6 @@ 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
@@ -350,3 +350,6 @@ Tcl_ConvertToType(3), Tcl_GetIntFromObj(3), Tcl_ListObjAppendElement(3), Tcl_Lis
 .SH KEYWORDS
 internal representation, value, value creation, value type,
 reference counting, string representation, type conversion
+
+.SH CATEGORY
+Objects
@@ -254,3 +254,6 @@ member.
 Tcl_NewObj(3), Tcl_DecrRefCount(3), Tcl_IncrRefCount(3)
 .SH KEYWORDS
 internal representation, value, value type, string representation, type conversion
+
+.SH CATEGORY
+Objects
@@ -646,3 +646,6 @@ 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
@@ -167,3 +167,6 @@ socket handle is a \fBSOCKET\fR as defined in the WinSock API.
 Tcl_OpenFileChannel(3), Tcl_RegisterChannel(3), vwait(n)
 .SH KEYWORDS
 channel, client, server, socket, TCP
+
+.SH CATEGORY
+Input/Output
@@ -87,3 +87,6 @@ taking a variable number of arguments it takes an argument list.
 abort(3), printf(3), exec(n), format(n)
 .SH KEYWORDS
 abort, fatal, error
+
+.SH CATEGORY
+Commands
@@ -193,6 +193,8 @@ came from, and so should be copied if it needs to be retained. The
 Tcl_GetIndexFromObj(3), Tcl_Main(3), Tcl_CreateObjCommand(3)
 .SH KEYWORDS
 argument, parse
+.SH CATEGORY
+Utilities
 '\" Local Variables:
 '\" fill-column: 78
 '\" End:
@@ -465,3 +465,6 @@ There are additional fields in the Tcl_Parse structure after the
 referenced by code outside of these procedures.
 .SH KEYWORDS
 backslash substitution, braces, command, expression, parse, token, variable substitution
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -93,5 +93,7 @@ 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)
@@ -108,3 +108,6 @@ counts in a separate structure.
 Tcl_Interp, Tcl_Alloc
 .SH KEYWORDS
 free, reference count, storage
+
+.SH CATEGORY
+Utilities
@@ -49,3 +49,6 @@ 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
@@ -51,3 +51,6 @@ Tcl_EvalObjEx, Tcl_GetObjResult

 .SH KEYWORDS
 command, event, execute, history, interpreter, value, record
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -53,3 +53,6 @@ Tcl_RecordAndEvalObj

 .SH KEYWORDS
 command, event, execute, history, interpreter, record
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -109,3 +109,6 @@ typedef struct Tcl_Config {
 .\" .SH "SEE ALSO"
 .SH KEYWORDS
 embedding, configuration, binary library
+
+.SH CATEGORY
+Initialization
@@ -381,3 +381,6 @@ to \-1.
 re_syntax(n)
 .SH KEYWORDS
 match, pattern, regular expression, string, subexpression, Tcl_RegExpIndices, Tcl_RegExpInfo
+
+.SH CATEGORY
+Utilities
@@ -118,3 +118,6 @@ result, either \fBTcl_RestoreResult\fR or
 memory associated with the saved state.  
 .SH KEYWORDS
 result, state, interp
+
+.SH CATEGORY
+Commands
@@ -138,3 +138,6 @@ leave all their error information in the interpreter result.
 Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3)
 .SH KEYWORDS
 channel driver, error messages, channel type
+
+.SH CATEGORY
+Input/Output
@@ -64,3 +64,6 @@ statically allocated and the caller must not free or modify them.

 .SH KEYWORDS
 errno, error code, global variables
+
+.SH CATEGORY
+Commands
@@ -51,3 +51,6 @@ increasing the maximum size of the C stack.

 .SH KEYWORDS
 nesting depth, recursion
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -253,3 +253,6 @@ the value of \fIresult\fR passed to \fBTcl_SetResult\fR.
 Tcl_AddErrorInfo, Tcl_CreateObjCommand, Tcl_SetErrorCode, Tcl_Interp
 .SH KEYWORDS
 append, command, element, list, value, result, return value, interpreter
+
+.SH CATEGORY
+Commands
@@ -247,3 +247,6 @@ Tcl_GetObjResult, Tcl_GetStringResult, Tcl_TraceVar

 .SH KEYWORDS
 array, get variable, interpreter, scalar, set, unset, value, variable
+
+.SH CATEGORY
+Variables
@@ -39,3 +39,6 @@ statically allocated and the caller must not free or modify them.

 .SH KEYWORDS
 signals, signal numbers
+
+.SH CATEGORY
+Operating System Interface
@@ -32,3 +32,6 @@ 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
@@ -30,3 +30,6 @@ taken.

 .SH KEYWORDS
 application-specific initialization, main program, rc file
+
+.SH CATEGORY
+Initialization
@@ -186,3 +186,6 @@ argument, and the string may contain embedded nulls.
 Tcl_ListObjGetElements(3)
 .SH KEYWORDS
 backslash, convert, element, list, merge, split, strings
+
+.SH CATEGORY
+Utilities
@@ -95,3 +95,6 @@ each platform.

 .SH KEYWORDS
 file, filename, join, path, split, type
+
+.SH CATEGORY
+Utilities
@@ -66,5 +66,7 @@ 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)
@@ -118,3 +118,6 @@ uses method 2 to initialize the standard channels.
 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
@@ -47,3 +47,6 @@ pattern are essentially matched in the lower case.

 .SH KEYWORDS
 match, pattern, string
+
+.SH CATEGORY
+Utilities
@@ -382,3 +382,6 @@ 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
@@ -66,3 +66,6 @@ performed after that point.
 subst(n)
 .SH KEYWORDS
 backslash substitution, command substitution, variable substitution
+
+.SH CATEGORY
+Invoking the Interpreter
@@ -78,3 +78,6 @@ to remove the calls after you find the problem.
 ckalloc, memory, Tcl_ValidateAllMemory, Tcl_DumpActiveMemory
 .SH KEYWORDS
 memory, debug
+
+.SH CATEGORY
+Utilities
@@ -264,6 +264,8 @@ 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
@@ -270,6 +270,8 @@ 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
@@ -194,3 +194,6 @@ 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
@@ -239,3 +239,6 @@ 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
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
twylite	542ee813e6	Experimental: categories added to man pages; enhance tcltk-man2html to use categories to render ToC	2013-01-09 16:43:33 +00:00
twylite	49e5643c25	Join paths with 'file join' not as strings to avoid platform-specific separator problems	2013-01-09 08:17:12 +00:00
twylite	b875d40fc1	FRQ-3599786: add command line option --pkgdir to tcltk-man2html.tcl to specify the directory under which package sources can be found (default tcldir/pkgs).	2013-01-07 13:16:12 +00:00