Documentation Documentation Issues

[Jay Sage]

I've been spending a lot of time lately just reading through the documentation. Although I've been using TCC since it was 4DOS and Take Command since it was born, I'm amazed at how much I've learned. Either I have forgotten things, or new features were added without my noticing. I've also come across some mistakes. Nothing serious, but I always wanted users of my software to tell me out problems, so I'll try to report them.

@EVAL​

In the examples at the end, the last three have a wrong answer. For a second, I thought that the results were being truncated instead of rounded, because 3/7 was 0.4286 to four places but 0.42 to two places. The output is actually 0.43.

->echo %@eval[3 / 7=2]
0.43

It struck me as odd that the help states: "To ensure that expression is interpreted correctly, spaces should be placed on both sides of each operator..." However, many of the examples that follow do not heed that advice.

@DEVICE​

The help has not been updated to mention the TMP: and TMP#: devices, which, like CLIP: and CLIP#:, require the trailing colon.

Take Command Configuration Dialogs​

The help states: "If you select Apply, the settings will only apply for the duration of that session." There is no Apply button on any of the TCMD option tabs.

Configuration Dialog (for TCC)​

For these tabs, there is an Apply button, and the instructions are similar. However, it is not clear how one can click the Apply button and then resume work. The window stays open. If I click the 'X' in the corner, the changes do not seem to be saved, and if I click the OK button after clicking the Apply button, the changes become permanent.

Filename Completion Window​

The help says that the window is opened by F7 or Ctrl-Tab. F7 is correct. Ctrl-Tab opens a popup for selecting among the tabs in Take Command.

Miscellaneous​

There are a lot of places, especially examples, that refer to the directory \TCMD28\. Most of these are not terribly important, but there was one that said that something would default to that directory (or something like that). Unfortunately, I haven't been able to find it again.

 

[Joe Caverly]

There are a lot of places, especially examples, that refer to the directory \TCMD28\. Most of these are not terribly important, but there was one that said that something would default to that directory (or something like that). Unfortunately, I haven't been able to find it again.

Here are the results with references to TCMD28 in the TCMD 36.01.54 help file.

Joe

 

[vefatica]

However, it is not clear how one can click the Apply button and then resume work.

Apply then Cancel seems to do it.

 

[Jay Sage]

Apply then Cancel seems to do it.

Not for me. I turned off completion of aliases and internal commands, clicked Apply, then clicked Cancel. That TCC session (in a tab) was still finding both aliases and internal commands.

Ah, I just tried it in a standalone TCC session, and there your method seems to work. Not very intuitive. If one is supposed to be able to click Apply and have it effective, the window should close after clicking it.

 

[rconn]

If one is supposed to be able to click Apply and have it effective, the window should close after clicking it.

No - if you want to do that, click OK. Apply is intended to be used when you're making a number of changes and you want to do intermediate saves.

 

[Jay Sage]

No - if you want to do that, click OK. Apply is intended to be used when you're making a number of changes and you want to do intermediate saves.

Uh, not according to the help, which says: "If you select Apply, the settings will only apply for the duration of that session. If you select OK, the settings will be recorded in the appropriate section of the TCMD.INI file and will be in effect each time you start Take Command.

Until I read that, I thought that the purpose of the apply button was what you described, to let me save what I had done on one tab and go on to another tab before saving the results with OK.

Moreover, one does not have to click Apply to accomplish what you describe. If I make a change in one tab, move to another tab, and then return to the original tab, all the changes I made are still there. So there is no need to click Apply.