| Purpose: | Display or modify the Extended History list |
| Format: | XHISTORY [/= OFF | ON][/D/ F"..." | /M"..." | /Nf | /Nh | /Q] |
OFF Disable Extended Command History
ON Enable Extended Command History
See also Extended Command History and HISTORY.
Usage:
The Extended History displays and saves more information about the command than the original command history:
Timestamp - Date and time the command was executed
Run time - The elapsed time (in seconds.milliseconds format)
Return - The integer value returned by the command
CWD - The current working directory when the command was executed
Command - The original command line (before alias & variable expansion)
Extended history does not replace the existing command history, but provides more details about the command context when you have a large / complex history. XHISTORY can either display / modify the extended history from the command line, or in a scrollable popup window that allows you select the command to re-execute or modify from those displayed in the window. The extended directory history window includes a toolbar with buttons for editing and deleting lines.
To activate the command history popup window, press Ctrl-Shift- PgUp or Ctrl-Shift- PgDn at the command line. (The hotkey can be redefined by changing XHistWinOpen in the OPTION / Keyboard / History dialog.) A popup window will appear, with the command you most recently executed marked with a highlight. (If you just finished re-executing a command from the history, then the next command in sequence will be highlighted.)
Selecting an entry and pressing Enter will execute the selected history entry.
Selecting an entry and pressing Shift-Enter will execute the selected history entry in its original directory.
Selecting an entry and pressing Ctrl-Enter will copy the selected history command to the command line but not run it. This allows you to edit the command before executing it.
The keystroke K_XHISTCWD (default Ctrl-W, configurable in OPTION / Keyboard) will exit XHISTORY and change to the directory
where the selected command was originally executed.
The keystroke K_XHISTDELETE (default Ctrl-D, configurable in OPTION / Keyboard) will delete the selected XHISTORY entry.
The keystroke K_XHISTEDIT (default Ctrl-E) will allow you to edit the selected XHISTORY command line.
The keystroke K_XHISTSEARCH (default Ctrl-S) will search for a matching history entry.
Extended History can also be enabled / disabled from the OPTION / Command Line / Command History dialog.
XHISTORY first looks for its data file in ProgramData (usually c:\programdata\JP Software). If the data file isn't found (some Windows configurations block write access to ProgramData), XHISTORY will look in LocalAppData (usually "c:\users\username\AppData\Local\JP Software").
Options:
| /= | Display the XHISTORY command dialog to help you set the command line options. The /= option can be anywhere on the line; additional options will set the appropriate fields in the command dialog. |
| ON | Enable extended history (extended history can also be enabled / disabled in the OPTION dialog on the Command Line page) |
| /F"..." | Delete matching lines in the directory history. Matching supports extended TCC wildcards and regular expressions. You can search on any field: |
| /M"..." | Find matching lines in the directory history. Matching supports extended TCC wildcards and regular expressions. You can search on any field: |
