Difference between revisions of "Command line parameters"

From TED Notepad
Line 1: Line 1:
<noinclude>{{manversion|6.1.0.2|feature}}__NOTOC__</noinclude>
+
<noinclude>{{manversion|6.3.0.8|feature}}__NOTOC__</noinclude>
  
 
{{example_start}}
 
{{example_start}}
 
{{example_body}}<b>TedNPad.exe</b>
 
{{example_body}}<b>TedNPad.exe</b>
&nbsp;            [ [ <b>{{feature|/l}} <u>xx</u></b> ] [ <b>{{feature|/c}} <u>xx</u></b> ] | <b>{{feature|/s}} <u>xx</u>,<u>yy</u></b> | <b>{{feature|/a}}</b> ]
+
 
&nbsp;            [ <b>{{feature|/p}}</b> ] [ <b>{{feature|/b}}</b> ] [ <b>{{feature|/u}}</b> ]
+
&nbsp;            [ [ <b>{{feature|/l}} <u>xx</u></b> ] [ <b>{{feature|/c}} <u>xx</u></b> ] | <b>{{feature|/s}} <u>p1</u>,<u>p2</u></b> | <b>{{feature|/a}}</b> | <b>{{feature|/E}}</b> ]
&nbsp;            [ <b>{{feature|/i}} <u>path</u></b> ] [ <b>{{feature|/nl}}</b> ] [ <b>{{feature|/ns}}</b> ]
+
 
 +
&nbsp;            [ <b>{{feature|/p}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/v}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/u}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/i}} <u>path</u></b> ]
 +
&nbsp;            [ <b>{{feature|/nl}}</b> ] [ <b>{{feature|/ns}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/x}} <u>xx</u></b> ] [ <b>{{feature|/y}} <u>yy</u></b> ] [ <b>{{feature|/w}} <u>ww</u></b> ] [ <b>{{feature|/h}} <u>hh</u></b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/T}}</b> ] [ <b>{{feature|/H}}</b> ]
 +
&nbsp;            [ <b>{{feature|/F}}</b> | <b>{{feature|/M}}</b>  | <b>{{feature|/m}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/b}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/?}}</b> ]
 +
 
 +
&nbsp;            [ <b>{{feature|/A}}</b> | <b>{{feature|/W}}</b> | <b>{{feature|/U}}</b> ]
 +
 
 
&nbsp;            <b>[drive:][path]filename</b>
 
&nbsp;            <b>[drive:][path]filename</b>
 
{{example_end}}
 
{{example_end}}

Revision as of 22:24, 6 October 2021

This section is up to date for TED Notepad version 6.3.1.0.
Control page Control:feature:Command line parameters
TedNPad.exe

  [ [ /l xx ] [ /c xx ] | /s p1,p2 | /a | /E ]

  [ /p ]

  [ /v ]

  [ /u ]

  [ /i path ]   [ /nl ] [ /ns ]

  [ /x xx ] [ /y yy ] [ /w ww ] [ /h hh ]

  [ /T ] [ /H ]   [ /F | /M | /m ]

  [ /b ]

  [ /? ]

  [ /A | /W | /U ]

  [drive:][path]filename

Note: All command line parameters must precede the filename to be loaded and must be delimited with at least one white-space to work properly. Since version 6.0, white-spaces between a parameter and its value are allowed. Some of the command line parameters are exclusive to each other and should not be used together, or the result may be undefined and may change from version to version.

Since version 6.3, if an unknown command line parameter is found, an error message is displayed. Prior to version 6.3, unknown command line parameters were ignored.


/l xx Go to Line

After the file is fully loaded, moves the caret to the beginning of the line number xx. If there is no such line (too few lines in the document), the caret is positioned on the beginning of the last line of the document.

Note: Zero and negative numbers can be used as line number.

  • Zero means the last line of the document; and negative number means how many lines to go from the last line upwards, e.g. -1 means the penultimate line. Likewise to positive numbers, if there is no such line (too few lines), the caret is positioned on the beginning of the first line of the document.

This parameter can be used together with /c parameter, to further move the caret within given line.

This parameter excludes /s, /a and /E parameters.

/c xx Go to Offset

After the file is fully loaded, moves the caret to the offset xx. If there is no such offset (the document is too short), the caret is positioned to the end of the document.

Note: Zero and negative numbers can be used as offset number.

  • Zero means the end of the document, after the very last character; and negative number means how many characters to go from the end of the document upwards, e.g. -1 means before the last character. Likewise to positive numbers, if there is no such offset (the document is too short), the caret is positioned on the beginning of the document.

This parameter can be used together with /l parameter, to further move the caret within given line. If the given offset goes beyond the given line, the caret is pushed respectively further into text of the following lines, until the end of the document is reached. If zero or negative offset is given, the caret is moved naturally along previous lines, until the beginning of the document is reached. In other words, after the starting line is calculated from the /l parameter, offset calculation according to /c parameter is done relatively to the beginning of that line downwards or upwards, bound only with document boundaries.

This parameter excludes /s, /a and /E parameters.

Note: Since version 6.0, TED Notepad does not convert newlines upon loading, therefore there is no need to re-calculate offsets to match the extent of newlines conversion. However, multi-character encoding sequences still might get converted into single-character representations upon loading, e.g. in UTF-8 files.

/s xx,yy Set Selection

After the file is fully loaded, automatically sets the selection from offset number xx to offset number yy. If there is no such offset (the document is too short), the respective selection boundary is positioned to the end of the document.

Note: Zero and negative numbers can be used as offset numbers.

  • Zero means the end of the document, after the very last character; and negative number means how many characters to go from the end of the document upwards, e.g. -1 means before the last character. Likewise to positive numbers, if there is no such offset (the document is too short), the caret is positioned on the beginning of the document.

This parameter excludes /l, /c, /a and /E parameters.

/a Select All

Selects all text after the file is fully loaded.

This parameter excludes /l, /c, /s and /E parameters.

/p Print

Prints the document after the file is fully loaded, then exits.

/b Create New File

Skips questions about whether to create a new file, if the file given thru command line does not exist. Without this command line parameter, TED Notepad asks, whether to create a new file, if the file to be loaded cannot be found.

/i inifile Config INI File

Forces the application to use inifile file upon loading and saving Config.

Note: Hierarchical INI file loading and system Registry fallback do not apply, if this parameter is used. Loading of Config is strictly bound to this inifile.

TedNPad.exe /i "d:\config\ted notepad.ini" d:\my notepad\todo.txt

Note: If the inifile contains spaces, make sure to use double quotes. Double quotes are not needed only if the inifile contains no white-spaces.

/nl Don't Load Settings

Skips any attempts to load Config from system Registry or Cascading Portable INI files. Can be used to quicken the application start-up, or for any kind of troubleshooting.

TedNPad.exe /nl /ns d:\my notepad\todo.txt

/ns Don't Save Settings

Skips any attempts to save Config into system Registry or Cascading Portable INI files. Can be used to quicken the termination of the application, or for any kind of troubleshooting.

Note: The Save checked button in the Settings dialog won't work as well. See section Settings page of the Settings dialog.

TedNPad.exe /nl /ns d:\my notepad\todo.txt

/na No Lengthy Asserts

(this parameter is only available in testing versions, do not use it in public releases)

Skips lengthy storage asserts after each text operation. With small files, this is usually not necessary. However, storage assertions can become a big nuisance with larger files. This parameter allows to skip the most lengthy tests, it does not, however, disable all testing routines.

/d xx Do Command

(temporary parameter, officially unpublished, subject to change without notice)

This parameter can be used to directly auto-invoke an xx action in TED Notepad, after the application starts up and loads the file from the command line. While the xx is a number of action to invoke, list of action numbers is not available yet. However, using various tools, advanced users can perhaps find these numbers out on their own, since these action numbers are the command numbers used by the application menu and accelerators.

Caution: This parameter was a long-shot attempt to provide macro support, and was never finished. Action numbers may change silently from version to version. Behavior of this parameter may be modified silently as well.

/u Check for Updates

Instead of launching the application and opening a document, connects to the application homepage and checks for available updates. Displays a message box upon new version and allows to open the official download page.

Note: Result of the last check is also displayed in the Status Bar as a hint from time to time.

TedNPad.exe /u