Tcl Source Code

OriginalBugID: 5716 Bug
Version: 8.3.1
SubmitDate: '2000-05-25'
LastModified: '2000-05-29'
Severity: MED
Status: Assigned
Submitter: techsupp
ChangedBy: hobbs
OS: All
FixedDate: '2000-10-25'
ClosedDate: '2000-10-25'


Name:
David LeBlanc

ObservedBehavior:
Neither the puts or fconfigure man pages (as in Windows hlp file), discuss the use or configurability of standard channel names like stderr, stdout, stdin (and maybe the windows specific ones like con?).

DesiredBehavior:
Add mention of these standard channel names to the man pages, and also discuss how/if the can be configured (for example to -encoding binary).

Logged In: YES 
user_id=75003

Committed to head.

File Added - 10797: 219250.diff.1

Logged In: YES 
user_id=75003

Update of patch after editorial
comments by Christopher Nelson.

File Added - 10757: 219250.diff

Logged In: YES 
user_id=75003

David LeBlanc = <[email protected]>
Here is a patch extending several manpages.

Logged In: YES 
user_id=79902

Since you're dealing with #402725, you get this bug too.

(<SIGH> I can't log in because the login page won't connect to it's database.  I'm having enough troulbe submitting this without trying to do TWO transactions.)

On 'Windows, I'd have the word "channel" in the fconfigure, open, etc. "man" pages pop up a little descriptive window that says something about "Preconfigured channels like stdin, stdout, and stderr, or channels opened by [open] or [socket]".

I'm embarrased to find that the std* channels are not in the index of my book. :-(

-- Chris Nelson

I'm thinking about fixing this, but the problem is that I'm not sure which manual page to alter!  While in some ways it is [fconfigure] that makes most sense, it is the sort of sense that requires you to know about their existence in the first place, and that indicates to me that they really should be discussed elsewhere.  Definitely not open (you don't open them) and puts seems rather tangential.  I suppose they really ought to be documented on the tclsh (and wish) manpage...

As for "discuss how/if the can be configured (for example to -encoding binary)." nothing has to be done. The standard channels are channels, hence they can be configured via "fconfigure". to mention them is good idea, despite the fact that it will strike Unix people as odd, we simply "know" of their existence.