TCEDIT |
Purpose: | Calls the Take Command Editor |
Format: | TCEDIT [range .../C /EXIT /INI /PRINT /START /O:[-]acdeginorstuz ] file [/GOTOLINE:n /PRINT /RDONLY] ... |
file |
File(s) to edit |
/EXIT (edit TCEXIT.BTM) |
|
/START (edit TCSTART.BTM) |
|
/INI (edit TCMD.INI) |
|
|
File Selection
Supports extended wildcards, ranges, multiple file names, and include lists.
File Completion Syntax:
The default filename completion syntax is: [1] dirs btm bat cmd [2*] *
Usage:
TCEDIT opens a tabbed environment in which INI, script, FTP and HTTP files can be edited. TCEDIT supports syntax colorization for many scripting languages, including .BAT, .BTM, and .CMD batch files, Perl, Python, Ruby, and Tcl. Each argument on the command line is assumed to be a filename to be opened in a separate tab window.
TCEDIT will display document changes in the margin and in the text. In the text, inserted characters appear with colored underlines and points where characters were deleted are shown with small triangles. The margin shows a block indicating the overall state of the line. The states are modified (orange), saved (green), saved then reverted to modified (green-yellow), and saved then reverted to original (cyan). The change history can be toggled on or off with the "Options / Change History" menu entry.
When loading a file, TCEDIIT will first check for the file type (UTF-16, UTF-8 with BOM, or ANSI). If the file doesn't have a UTF-16 or UTF-8 BOM, it is read as an ANSI file with the current console code page, and converted to UTF-8 before editing. It will be converted back to an ANSI file with the current code page when it is saved. This allows TCEDIIT to properly display high-bit ASCII characters in the editor.
If you specify a file that doesn't exist when starting TCEDIIT (and you didn't specify /C), TCEDIIT will display a messagebox asking if you want to create the file.
Yes - Creates a new empty file and opens it in the active tab window
No - Opens an untitled empty tab window (you will need to name the file before saving)
Cancel - Exits TCEDIIT
TCEDIT will select the syntax lexer (colorization) based on the file extension:
.bat | TCMD (or CMD) |
.btm | TCMD |
.cmd | TCMD (or CMD) |
.css | CSS |
.htm | HTML |
.html | HTML |
.lua | Lua |
.php | PHP |
.pl | Perl |
.ps1 | PowerShell |
.py | Python |
.rb | Ruby |
.sh | Bash shell |
.sql | SQL |
.tcl | Tcl/Tk |
.vbs | VBScript |
.xml | XML |
TCEDIT also supports reading from the clipboared (CLIP:), FTP, and HTTP sites.
The TCEDIT window includes a slider control on the lower right corner of the status bar to control the transparency level. You can also change the transparency with Ctrl-Shift-Mousewheel.
If you are editing a TCC batch file, use the (default) TCC Syntax in the Options menu. If you are editing a batch file to run under CMD.EXE, select CMD Syntax. If you select CMD Syntax, TCEDIT will reconfigure the batch file parser for maximum CMD.EXE compatibility, including disabling TCC-only internal commands, aliases, variables, functions, and plugins.
TCEdit will monitor the filesystem for any changes to the file(s) being edited. If another application modifies a file, the IDE will display a message notifying you of the change and asking if you want to reload the updated file.
TCEdit allows you to create and edit NTFS streams. The syntax is "filename.ext:streamname".
Toolbar
The edit window toolbar (which is configurable by clicking on the rightmost down arrow), has a number of icons to control debugging. Each has a tooltip for quick reference:
New | Create a new batch file in a new tab window. |
Open | Open an existing batch file in a new tab window. |
Save | Save the current batch file. |
Print the current batch file. |
Cut | Copy the highlighted selection to the clipboard and delete it from the file. |
Copy | Copy the highlighted selection to the clipboard. |
Paste | Copy the contents of the clipboard to the current cursor location. |
Delete | Delete the highlighted selection. |
Undo | Undo the last edit. |
Redo | Restore the last Undo. |
Find | Search for text. |
File Properties | Displays information on the current file. |
Command Prompt | Start another copy of TCC (this is useful if you need to perform some tasks while debugging a file.) |
Help | Display the online help. |
You can get help for the currently selected (highlighted) command / variable / function by pressing Ctrl-F1, or right-clicking the mouse and selecting Help from the context menu.
Open will load the file and any associated bookmark file (filename.ext.bmark).
Save will save the file and any associated bookmark file (filename.ext.bmark) and the watched variables file.
Piping Input to TCEdit
TCEdit supports piped input. For example, "dir | TCEdit" will load the contents of the directory into the first tab window.
TCEdit supports piped output with the "File / Write to STDOUT" menu option. This allows you to edit the pipe input before sending it on to be processed by another app. For example:
dir /b | tcedit | someapp
Options:
tcedit mytest.cmd /gotoline:24 [yourtest.cmd /gotoline:12 ...]
You may use any combination of the sorting options below. If multiple options are used, the listing will be sorted with the first sort option as the primary key, the next as the secondary key, and so on:
n | Sort by filename and extension, unless e is explicitly included. This is the default. |
- | Reverse the sort order for the next sort key |
a | Sort names and extensions in standard ASCII order, instead of numerically when numeric substrings are included in the name or extension. |
c | Sort by compression ratio |
d | Sort by date and time (oldest first); also see /T:acw |
e | Sort by extension |
g | Group subdirectories first, then files |
i | Sort by description |
o | Sort by owner |
r | Reverse the sort order for all options |
s | Sort by size |
t | Same as d |
u | Unsorted |
z | Same as s |
tcedit filename /print
/RDONLY | Start TCEdit in read-only mode for the file preceding the /RDONLY argument on the command line. |
0 None
1 Word
2 Character
3 Whitespace
/Wrap applies to all files following it on the command line.