From 0ebe85a334a6cb6e5cdd056c18a5988b779c2ed4 Mon Sep 17 00:00:00 2001 From: dkf Date: Tue, 29 Jan 2008 15:32:30 +0000 Subject: Improve Tcl macros to make Ttk documentation work better. [Tk Bug 1876493] --- ChangeLog | 57 ++++++++++++++++++++++++++++++++------------------------- doc/man.macros | 26 ++++++++++++-------------- 2 files changed, 44 insertions(+), 39 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7742837..519cd86 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2008-01-29 Donal K. Fellows + + * doc/man.macros (SO, SE): Adjusted macros so that it is possible for + Ttk to have its "standard options" on a manual page that is not called + "options". [Tk Bug 1876493] + 2008-01-25 Don Porter * changes: Updated for 8.5.1 release. @@ -7,7 +13,7 @@ * generic/tclInt.h: New macro TclGrowParseTokenArray() to * generic/tclCompCmds.c: simplify code that might need to grow * generic/tclCompExpr.c: an array of Tcl_Tokens in the parsePtr - * generic/tclParse.c: field of a Tcl_Parse. Replaces the + * generic/tclParse.c: field of a Tcl_Parse. Replaces the TclExpandTokenArray() routine via replacing: int needed = parsePtr->numTokens + growth; while (needed > parsePtr->tokensAvailable) { @@ -18,7 +24,8 @@ This revision merged over from dgp-refactor branch. * generic/tclCompile.h: Demote TclCompEvalObj() from internal stubs to - * generic/tclInt.decls: a MODULE_SCOPE routine declared in tclCompile.h. + * generic/tclInt.decls: a MODULE_SCOPE routine declared in + tclCompile.h. * generic/tclIntDecls.h: make genstubs * generic/tclStubInit.c: @@ -26,14 +33,14 @@ 2008-01-22 Don Porter * generic/tclTimer.c (AfterProc): Replace Tcl_EvalEx() with - Tcl_EvalObjEx() to evaluate [after] callbacks. Part of trend to - favor compiled execution over direct evaluation. + Tcl_EvalObjEx() to evaluate [after] callbacks. Part of trend to favor + compiled execution over direct evaluation. 2008-01-22 Miguel Sofer * generic/tclCmdIl.c (Tcl_LreverseObjCmd): - * tests/cmdIL.test (cmdIL-7.7): fix crash on reversing an empty - list [Bug 1876793]. + * tests/cmdIL.test (cmdIL-7.7): fix crash on reversing an empty list. + [Bug 1876793] 2008-01-20 Jeff Hobbs @@ -44,9 +51,9 @@ 2008-01-17 Don Porter - * generic/tclCompExpr.c: Revision to preserve parsed intreps - of numeric and boolean literals when compiling expressions with - (optimize == 1). + * generic/tclCompExpr.c: Revision to preserve parsed intreps of + numeric and boolean literals when compiling expressions with (optimize + == 1). 2008-01-15 Miguel Sofer @@ -56,38 +63,38 @@ * generic/tclExecute.c: - * generic/tclCompExpr.c: Fix literal leak in exprs [Bug 1869989] - * generic/tclExecute.c: (dgp) + * generic/tclCompExpr.c: Fix literal leak in exprs [Bug 1869989] (dgp) + * generic/tclExecute.c: * tests/compExpr.test: - * doc/proc.n: changed wording for access to non-local variables; - added mention to [namespace upvar]. Lame attempt at dealing with - documentation [Bug 1872708] + * doc/proc.n: changed wording for access to non-local variables; added + mention to [namespace upvar]. Lame attempt at dealing with + documentation. [Bug 1872708] 2008-01-15 Miguel Sofer - * generic/tclBasic.c: Replacing 'operator' by 'op' in the def - * generic/tclCompExpr.c: of struct TclOpCmdClientData to - * generic/tclCompile.h: accomodate C++ compilers [Bug 1855644] + * generic/tclBasic.c: Replacing 'operator' by 'op' in the def of + * generic/tclCompExpr.c: struct TclOpCmdClientData to accommodate C++ + * generic/tclCompile.h: compilers. [Bug 1855644] 2008-01-13 Jeff Hobbs - * win/tclWinSerial.c (SerialCloseProc, TclWinOpenSerialChannel): - use critical section for read & write side. [Bug 1353846] (newman) + * win/tclWinSerial.c (SerialCloseProc, TclWinOpenSerialChannel): use + critical section for read & write side. [Bug 1353846] (newman) 2008-01-11 Miguel Sofer - * unix/tclUnixThrd.c (TclpThreadGetStackSize): restore stack - checking functionality in freebsd [Bug 1850424] + * unix/tclUnixThrd.c (TclpThreadGetStackSize): restore stack checking + functionality in freebsd. [Bug 1850424] * unix/tclUnixThrd.c (TclpThreadGetStackSize): fix for crash in - freebsd [Bug 1860425]. + freebsd. [Bug 1860425] 2008-01-10 Don Porter * generic/tclStringObj.c (Tcl_AppendFormatToObj): Correct failure to * tests/format.test: account for big.used == 0 corner case in the - %ll(idox) format directives. [Bug 1867855]. + %ll(idox) format directives. [Bug 1867855] 2008-01-09 George Peter Staplin @@ -95,8 +102,8 @@ 2008-01-04 Jeff Hobbs - * tools/tcltk-man2html.tcl (make-man-pages): make man page title - use more specific info on lhs to improve tabbed browser view titles. + * tools/tcltk-man2html.tcl (make-man-pages): make man page title use + more specific info on lhs to improve tabbed browser view titles. 2008-01-02 Donal K. Fellows diff --git a/doc/man.macros b/doc/man.macros index 88d0342..bd35803 100644 --- a/doc/man.macros +++ b/doc/man.macros @@ -42,15 +42,14 @@ .\" .DE .\" End of indented unfilled display. .\" -.\" .SO -.\" Start of list of standard options for a Tk widget. The -.\" options follow on successive lines, in three columns separated -.\" by tabs. -.\" -.\" .SE ?manpage? -.\" End of list of standard options for a Tk widget. The manpage +.\" .SO ?manpage? +.\" Start of list of standard options for a Tk widget. The manpage .\" argument defines where to look up the standard options; if -.\" omitted, defaults to "options". +.\" omitted, defaults to "options". The options follow on successive +.\" lines, in three columns separated by tabs. +.\" +.\" .SE +.\" End of list of standard options for a Tk widget. .\" .\" .OP cmdName dbName dbClass .\" Start of description of a specific option. cmdName gives the @@ -68,7 +67,7 @@ .\" Print an open parenthesis, arg1 in quotes, then arg2 normally .\" (for trailing punctuation) and then a closing parenthesis. .\" -.\" RCS: @(#) $Id: man.macros,v 1.8 2007/12/13 15:22:32 dgp Exp $ +.\" RCS: @(#) $Id: man.macros,v 1.9 2008/01/29 15:32:33 dkf Exp $ .\" .\" # Set up traps and other miscellaneous stuff for Tcl/Tk man pages. .if t .wh -1.3i ^B @@ -83,7 +82,7 @@ .\} .ta \\n()Au \\n()Bu .ie !"\\$3"" \{\ -\&\\$1 \\fI\\$2\\fP (\\$3) +\&\\$1 \\fI\\$2\\fP (\\$3) .\".b .\} .el \{\ @@ -205,6 +204,8 @@ .. .\" # SO - start of list of standard options .de SO +'ie '\\$1'' .ds So \\fBoptions\\fR +'el .ds So \\fB\\$1\\fR .SH "STANDARD OPTIONS" .LP .nf @@ -216,10 +217,7 @@ .fi .ft R .LP -See the -.ie '\\$1'' \\fBoptions\\fR -.el \\fB\\$1\\fR -manual entry for details on the standard options. +See the \\*(So manual entry for details on the standard options. .. .\" # OP - start of full description for a single option .de OP -- cgit v0.12