TIP 685: rename "string is unicode" to "string is transferable"

Login
Author:        Harald Oehlmann
State:         Final
Type:          Project
Vote:          Done
Created:       10-01-2024
Tcl-Version:   8.7
Tcl-Branch:    tip-685
Vote-Summary:  4 / 2 / 0
Votes-For:     BG, KW, MC, SL
Votes-Against: DP, JN
Votes-Present: none
Obsoleted-By:  652

Abstract

This TIP proposes to rename "string is unicode" to "string is transferable".

Background

TIP 597 introduced "string is unicode". Please refer to this TIP for a description. TIP 652 proposes to remove this class from the "string is" command.

On a core list discussion, it was expressed:

Rationale

The current class name "unicode" is seen as miss-leading, see TIP 652.

The name "transferable" suggests, that the string is tested to be ready for a transfer to an external resource like a file or data base.

It is proposed, that this TIP is voted together with TIP 652.

Specification

Rename:

string is unicode ?-strict? data

to

string is transferable ?-strict? data

If TIP 652 is accepted, this TIP is automatically widthdrawn.

Rename the directly connected C API function

Tcl_UniCharIsUnicode

to

Tcl_UniCharIsTransferable

The manual page adds a phrase like: "The purpose is to test a string to be transfered to an external resource."

Implementation

The implementation of this TIP is in the Tcl tip-685 branch.

Copyright

This document has been placed in the public domain.