From f8e065e3e2aa864122529167bff82b75811dcedc Mon Sep 17 00:00:00 2001 From: "jan.nijtmans" Date: Mon, 17 Feb 2025 14:44:20 +0000 Subject: Remove references to ancient TIP's --- doc/Cancel.3 | 3 +-- doc/Ensemble.3 | 2 -- doc/Namespace.3 | 3 --- doc/chan.n | 8 +++----- doc/copy.n | 2 -- doc/file.n | 1 - doc/library.n | 8 +++----- doc/lreplace.n | 4 ---- doc/tclvars.n | 21 +-------------------- doc/tm.n | 4 ++-- doc/zlib.n | 12 ------------ 11 files changed, 10 insertions(+), 58 deletions(-) diff --git a/doc/Cancel.3 b/doc/Cancel.3 index 72dd939..e9b497a 100644 --- a/doc/Cancel.3 +++ b/doc/Cancel.3 @@ -77,7 +77,6 @@ object is shared with some other location (including the Tcl evaluation stack) it should have its reference count incremented before calling this function. .SH "SEE ALSO" -interp(n), Tcl_Eval(3), -TIP 285 +interp(n), Tcl_Eval(3) .SH KEYWORDS cancel, unwind diff --git a/doc/Ensemble.3 b/doc/Ensemble.3 index 0c2ea9d..f31049f 100644 --- a/doc/Ensemble.3 +++ b/doc/Ensemble.3 @@ -4,8 +4,6 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" This documents the C API introduced in TIP#235 -'\" .TH Tcl_Ensemble 3 8.5 Tcl "Tcl Library Procedures" .so man.macros .BS diff --git a/doc/Namespace.3 b/doc/Namespace.3 index 399bd7d..4b74d47 100644 --- a/doc/Namespace.3 +++ b/doc/Namespace.3 @@ -4,9 +4,6 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" Note that some of these functions do not seem to belong, but they -'\" were all introduced with the same TIP (#139) -'\" .TH Tcl_Namespace 3 8.5 Tcl "Tcl Library Procedures" .so man.macros .BS diff --git a/doc/chan.n b/doc/chan.n index ef965e5..808312e 100644 --- a/doc/chan.n +++ b/doc/chan.n @@ -90,14 +90,12 @@ the Tcl program. .PP Channels are automatically closed when an interpreter is destroyed and when the process exits. -From 8.6 on (TIP#398), nonblocking channels are no longer switched to +Nonblocking channels are not switched to blocking mode when exiting; this guarantees a timely exit even when the peer or a communication channel is stalled. To ensure proper flushing of -stalled nonblocking channels on exit, one must now either (a) actively +stalled nonblocking channels on exit, one must either (a) actively switch them back to blocking or (b) use the environment variable -\fBTCL_FLUSH_NONBLOCKING_ON_EXIT\fR, which when set and not equal to -.QW \fB0\fR -restores the previous behavior. +\fBTCL_FLUSH_NONBLOCKING_ON_EXIT\fR. .RE .\" METHOD: configure .TP diff --git a/doc/copy.n b/doc/copy.n index 56160a0..46b3c78 100644 --- a/doc/copy.n +++ b/doc/copy.n @@ -24,7 +24,6 @@ name of the object or class to be copied, \fIsourceObject\fR, and optionally the name of the object or class to create, \fItargetObject\fR, which will be resolved relative to the current namespace if not an absolute qualified name and -.VS TIP473 \fItargetNamespace\fR which is the name of the namespace that will hold the internal state of the object (\fBmy\fR command, etc.); it \fImust not\fR refer to an existing namespace. @@ -32,7 +31,6 @@ If either \fItargetObject\fR or \fItargetNamespace\fR is omitted or is given as the empty string, a new name is chosen. Names, unless specified, are chosen with the same algorithm used by the \fBnew\fR method of \fBoo::class\fR. -.VE TIP473 The copied object will be of the same class as the source object, and will have all its per-object methods copied. If it is a class, it will also have all the class methods in the class copied, but it will not have any of its instances diff --git a/doc/file.n b/doc/file.n index 6d213a2..b306976 100644 --- a/doc/file.n +++ b/doc/file.n @@ -564,7 +564,6 @@ between platforms: .\" METHOD: tempfile .TP \fBfile tempfile\fR ?\fInameVar\fR? ?\fItemplate\fR? -.\" TIP #210 Creates a temporary file and returns a read-write channel opened on that file. If the \fInameVar\fR is given, it specifies a variable that the name of the temporary file will be written into; if absent, Tcl will attempt to arrange diff --git a/doc/library.n b/doc/library.n index af9d776..0bad31a 100644 --- a/doc/library.n +++ b/doc/library.n @@ -9,7 +9,7 @@ .so man.macros .BS .SH NAME -auto_execok, auto_import, auto_load, auto_mkindex, auto_qualify, auto_reset, foreachLine, parray, readFile, tcl_findLibrary, tcl_endOfWord, tcl_startOfNextWord, tcl_startOfPreviousWord, tcl_wordBreakAfter, tcl_wordBreakBefore, writeFile \- standard library of Tcl procedures +auto_execok, auto_import, auto_load, auto_mkindex, auto_qualify, auto_reset, foreachLine, parray, readFile, tcl_findLibrary, tcl_endOfWord, tcl_nonwordchars, tcl_startOfNextWord, tcl_startOfPreviousWord, tcl_wordBreakAfter, tcl_wordBreakBefore, tcl_wordchars, writeFile \- standard library of Tcl procedures .SH SYNOPSIS .nf \fBauto_execok \fIcmd\fR @@ -473,8 +473,7 @@ These variables are only used in the \fBtcl_endOfWord\fR, This variable contains a regular expression that is used by routines like \fBtcl_endOfWord\fR to identify whether a character is part of a word or not. If the pattern matches a character, the character is -considered to be a non-word character. The default value is -.QW "\\W" . +considered to be a non-word character. The default value is \fB\eW\fR. .\" VARIABLE: tcl_wordchars .TP \fBtcl_wordchars\fR @@ -482,8 +481,7 @@ considered to be a non-word character. The default value is This variable contains a regular expression that is used by routines like \fBtcl_endOfWord\fR to identify whether a character is part of a word or not. If the pattern matches a character, the character is -considered to be a word character. The default value is -.QW "\\w" . +considered to be a word character. The default value is \fB\ew\fR. .SH "SEE ALSO" env(n), info(n), re_syntax(n) .SH KEYWORDS diff --git a/doc/lreplace.n b/doc/lreplace.n index 47d33f9..6f3fda4 100644 --- a/doc/lreplace.n +++ b/doc/lreplace.n @@ -31,12 +31,10 @@ list, and \fBend\fR refers to the last element of the list. If either \fIfirst\fR or \fIlast\fR is less than zero, it is considered to refer to before the first element of the list. This allows \fBlreplace\fR to prepend elements to \fIlist\fR. -.VS TIP505 If either \fIfirst\fR or \fIlast\fR indicates a position greater than the index of the last element of the list, it is treated as if it is an index one greater than the last element. This allows \fBlreplace\fR to append elements to \fIlist\fR. -.VE TIP505 .PP If \fIlast\fR is less than \fIfirst\fR, then any specified elements will be inserted into the list before the element specified by \fIfirst\fR @@ -82,7 +80,6 @@ proc lremove {listVariable value} { } .CE .PP -.VS TIP505 Appending elements to the list; note that \fBend+2\fR will initially be treated as if it is \fB6\fR here, but both that and \fB12345\fR are greater than the index of the final item so they behave identically: @@ -93,7 +90,6 @@ a b c d e % set var [\fBlreplace\fR $var 12345 end+2 f g h i] a b c d e f g h i .CE -.VE TIP505 .SH "SEE ALSO" list(n), lappend(n), lassign(n), ledit(n), lindex(n), linsert(n), llength(n), lmap(n), lpop(n), lrange(n), lremove(n), lrepeat(n), diff --git a/doc/tclvars.n b/doc/tclvars.n index 180e540..344050a 100644 --- a/doc/tclvars.n +++ b/doc/tclvars.n @@ -10,7 +10,7 @@ .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME -argc, argv, argv0, auto_path, env, errorCode, errorInfo, tcl_interactive, tcl_library, tcl_nonwordchars, tcl_patchLevel, tcl_pkgPath, tcl_platform, tcl_precision, tcl_rcFileName, tcl_traceCompile, tcl_traceExec, tcl_wordchars, tcl_version \- Variables used by Tcl +argc, argv, argv0, auto_path, env, errorCode, errorInfo, tcl_interactive, tcl_library, tcl_patchLevel, tcl_pkgPath, tcl_platform, tcl_precision, tcl_rcFileName, tcl_traceCompile, tcl_traceExec, tcl_version \- Variables used by Tcl .BE .SH DESCRIPTION .PP @@ -322,7 +322,6 @@ On UNIX machines, this is the value returned by \fBuname -s\fR. The version number for the operating system running on this machine. On UNIX machines, this is the value returned by \fBuname -r\fR. .IP \fBpathSeparator\fR -'\" Defined by TIP #315 The character that should be used to \fBsplit\fR PATH-like environment variables into their corresponding list of directory names. .IP \fBplatform\fR @@ -456,24 +455,6 @@ and interpreter. This variable and functionality only exist if \fBTCL_COMPILE_DEBUG\fR was defined during Tcl's compilation. .RE -.\" VARIABLE: tcl_wordchars -.TP -\fBtcl_wordchars\fR -. -The value of this variable is a regular expression that can be set to -control what are considered -.QW word -characters. It defaults to \fB\ew\fR, which is any Unicode -word character (number, letter, or underscore). -.\" VARIABLE: tcl_nonwordchars -.TP -\fBtcl_nonwordchars\fR -. -The value of this variable is a regular expression that can be set to -control what are considered -.QW non-word -characters. It defaults to \fB\eW\fR, which is anything but a -Unicode word character (number, letter, or underscore). .\" VARIABLE: tcl_version .TP \fBtcl_version\fR diff --git a/doc/tm.n b/doc/tm.n index 6bb1ac3..bfe79d4 100644 --- a/doc/tm.n +++ b/doc/tm.n @@ -307,9 +307,9 @@ fails because the user is unknown will be omitted from search paths. .SH "SEE ALSO" package(n), Tcl Improvement Proposal #189 .QW "\fITcl Modules\fR" -(online at https://tip.tcl-lang.org/189.html), Tcl Improvement Proposal #190 +(online at https://core.tcl-lang.org/tips/doc/trunk/tip/189.md), Tcl Improvement Proposal #190 .QW "\fIImplementation Choices for Tcl Modules\fR" -(online at https://tip.tcl-lang.org/190.html) +(online at https://core.tcl-lang.org/tips/doc/trunk/tip/190.md) .SH "KEYWORDS" modules, package .\" Local Variables: diff --git a/doc/zlib.n b/doc/zlib.n index 4c6cb2b..c8349d3 100644 --- a/doc/zlib.n +++ b/doc/zlib.n @@ -141,7 +141,6 @@ to the \fBzlib push\fR command: .\" OPTION: -dictionary .TP \fB\-dictionary\fI binData\fR -.VS "TIP 400" Sets the compression dictionary to use when working with compressing or decompressing the data to be \fIbinData\fR. Not valid for transformations that work with gzip-format data. The dictionary should consist of strings (byte @@ -149,7 +148,6 @@ sequences) that are likely to be encountered later in the data to be compressed, with the most commonly used strings preferably put towards the end of the dictionary. Tcl provides no mechanism for choosing a good such dictionary for a particular data sequence. -.VE .\" OPTION: -header .TP \fB\-header\fI dictionary\fR @@ -193,7 +191,6 @@ compression algorithm depends on what format is being produced or consumed. .\" OPTION: -dictionary .TP \fB\-dictionary\fI binData\fR -.VS "TIP 400" This read-write options gets or sets the initial compression dictionary to use when working with compressing or decompressing the data to be \fIbinData\fR. It is not valid for transformations that work with gzip-format data, and should @@ -201,7 +198,6 @@ not normally be set on compressing transformations other than at the point where the transformation is stacked. Note that this cannot be used to get the current active compression dictionary mid-stream, as that information is not exposed by the underlying library. -.VE .\" OPTION: -flush .TP \fB\-flush\fI type\fR @@ -243,7 +239,6 @@ and \fIoptions\fR are supported: The stream will be a compressing stream that produces zlib-format output, using compression level \fIlevel\fR (if specified) which will be an integer from 0 to 9, -.VS "TIP 400" and the compression dictionary \fIbindata\fR (if specified). .VE .TP @@ -251,7 +246,6 @@ and the compression dictionary \fIbindata\fR (if specified). . The stream will be a decompressing stream that takes zlib-format input and produces uncompressed output. -.VS "TIP 400" If \fIbindata\fR is supplied, it is a compression dictionary to use if required. .VE @@ -261,11 +255,9 @@ required. The stream will be a compressing stream that produces raw output, using compression level \fIlevel\fR (if specified) which will be an integer from 0 to 9, -.VS "TIP 400" and the compression dictionary \fIbindata\fR (if specified). Note that the raw compressed data includes no metadata about what compression dictionary was used, if any; that is a feature of the zlib-format data. -.VE .TP \fBzlib stream gunzip\fR . @@ -283,11 +275,9 @@ for keys see \fBzlib gzip\fR). . The stream will be a decompressing stream that takes raw compressed input and produces uncompressed output. -.VS "TIP 400" If \fIbindata\fR is supplied, it is a compression dictionary to use. Note that there are no checks in place to determine whether the compression dictionary is correct. -.VE .RE .SS "CHECKSUMMING SUBCOMMANDS" .\" METHOD: adler32 @@ -380,10 +370,8 @@ way in which the transformation is applied: .\" OPTION: -dictionary .TP \fB\-dictionary\fI binData\fR -.VS "TIP 400" Sets the compression dictionary to use when working with compressing or decompressing the data to be \fIbinData\fR. -.VE .\" OPTION: -finalize .TP \fB\-finalize\fR -- cgit v0.12