Programmer Guide/Command Reference/NEW - Revision history

Toni at 14:03, 21 January 2019

2019-01-21T14:03:19Z

← Older revision		Revision as of 16:03, 21 January 2019
Line 14:		Line 14:
	;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).		;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).
	;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.		;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.
	;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new ~~[[Programmer_Guide/Shell_Items\|shell item]]~~.		;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new .
	;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.		;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.
	;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.		;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
	;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the <code>[[Programmer_Guide/Command_Reference/DELETE\|DELETE]]</code> command. Note: This option is case-sensitive.		;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the <code>[[Programmer_Guide/Command_Reference/DELETE\|DELETE]]</code> command. Note: This option is case-sensitive.
	;<code>/u</code>: If specified, the created item is protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.		;<code>/u</code>: If specified, the created item is protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
	;<code>/z</code>		;<code>/z</code>: Use this option, to create a reference to an already existing shell item (also if owned by another shell). For more details read the section about [[Programmer_Guide/Shell_Items\|shell items]]

	The following example creates a new table with an automatic name and assigns the name to a local variable or exits if the table was not created.		The following example creates a new table with an automatic name and assigns the name to a local variable or exits if the table was not created.

Jw at 06:54, 25 October 2016

2016-10-25T06:54:11Z

← Older revision		Revision as of 08:54, 25 October 2016
Line 18:		Line 18:
	;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.		;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
	;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the <code>[[Programmer_Guide/Command_Reference/DELETE\|DELETE]]</code> command. Note: This option is case-sensitive.		;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the <code>[[Programmer_Guide/Command_Reference/DELETE\|DELETE]]</code> command. Note: This option is case-sensitive.
	;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.		;<code>/u</code>: If specified, the created item is protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
	;<code>/z</code>		;<code>/z</code>

Jw at 06:51, 6 May 2015

2015-05-06T06:51:34Z

← Older revision		Revision as of 08:51, 6 May 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	{{Programmer Guide}}		{{Programmer Guide}}

	The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.		The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.

Jw: Consolidating two 'NEW' pages

2015-05-06T06:50:59Z

Consolidating two 'NEW' pages

← Older revision		Revision as of 08:50, 6 May 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	{{Programmer Guide}}		{{Programmer Guide}}

			The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.

	NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

	The <code>NEW</code> ~~command creates~~ a new ~~[[Programmer_Guide~~/~~Shell_Items\|shell~~ item]] of ~~the type~~ <~~var~~>~~itemtype~~</~~var~~> ~~and named~~ <~~var~~>~~itemname~~</~~var~~>.		The following is applicable to all <code>NEW</code> commands:

			The argument <var>itemname</var> can be set to '<code></code>' if the item should automatically be given a unique name (e.g. <code>NEW FILE * /File</code>).
			The name of a new item is always stored in the variable <code>#NEW</code> if the command was successfully completed, otherwise <code>#NEW</code> is set to '<code></code>'.
			*An item must be deleted (<code>DELETE name</code>) before another <code>NEW</code> command using the same name can be successfully executed.
			<code>NEW</code> commands can be used in inline statements with the syntax <code>#item = $(NEW itemx paramx)</code>. The variable <code>#item</code> is assigned the value of <code>#NEW</code>. Therefore if the command fails, both are assigned the value <code></code>.

	;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).		;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).

Jw: Consolidating two 'NEW' pages

2015-05-06T06:48:57Z

Consolidating two 'NEW' pages

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:{{SUBPAGENAME}}}}
   NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent|/I]] ] [ /U|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]
@@ Line 9: / Line 10: @@
 ;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.
 ;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
-;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE|delete command]]. Note: This option is case-sensitive.
+;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are protected from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the <code>[[Programmer_Guide/Command_Reference/DELETE|DELETE]]</code> command. Note: This option is case-sensitive.
 ;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
 ;<code>/z</code>

Christian at 15:10, 25 April 2014

2014-04-25T15:10:12Z

← Older revision		Revision as of 17:10, 25 April 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}

	NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

Christian: Undo revision 4194 by Christian (Talk)

2011-04-21T18:32:05Z

Undo revision 4194 by Christian (Talk)

← Older revision		Revision as of 20:32, 21 April 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}

	NEW <var~~>~~itemtype</var~~>~~ <var~~>~~itemname</var~~>~~ [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var~~>~~createargs</var~~>~~ [ <var~~>~~createopts</var~~>~~ ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

	The <code~~>~~NEW</code~~>~~ command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var~~>~~itemtype</var~~>~~ and named <var~~>~~itemname</var~~>~~.		The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.

	;<var~~>~~itemtype</var~~>~~: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).		;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).
	;<var~~>~~itemname</var~~>~~: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.		;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.
	;<var~~>~~createargs</var~~>~~: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].		;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].
	;<code~~>~~/I</code~~>~~: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code~~>~~NEW</code~~>~~ will generate a warning rather than an error if arguments are missing or it is unable create the new item.		;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.
	;<code~~>~~/G</code~~>~~: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.		;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
	;<code~~>~~/U</code~~>~~: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.		;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.
	;<code~~>~~/u</code~~>~~: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.		;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
	;<code~~>~~/z</code~~>~~		;<code>/z</code>

Christian: Text replace - ">" to ">"

2011-04-21T18:31:45Z

Text replace - ">" to ">"

← Older revision		Revision as of 20:31, 21 April 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}

	NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

	The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.		The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.

	;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).		;<var>itemtype</var>: The type of the new [[Programmer_Guide/Shell_Items\|shell item]]. This must be unique (in the item namespace of a shell).
	;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.		;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.
	;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].		;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].
	;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.		;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.
	;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.		;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
	;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.		;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.
	;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.		;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
	;<code>/z</code>		;<code>/z</code>

Admin at 16:34, 22 March 2011

2011-03-22T16:34:07Z

← Older revision		Revision as of 18:34, 22 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}

	NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ <var>createargs</var> ] [ <var>createopts</var> ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

	The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.		The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.

Admin at 16:33, 22 March 2011

2011-03-22T16:33:03Z

← Older revision		Revision as of 18:33, 22 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}

	NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/~~Command_Reference_Intro~~/Silent\|/I]] /U\|/u /G ] [ <var>createargs</var> [ <var>createopts</var> ] ]		NEW <var>itemtype</var> <var>itemname</var> [ [[Programmer_Guide/Command_Reference_Options/Silent\|/I]] ] [ /U\|/u ] [ /G ] [ <var>createargs</var> ] [ <var>createopts</var> ] ]

	The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.		The <code>NEW</code> command creates a new [[Programmer_Guide/Shell_Items\|shell item]] of the type <var>itemtype</var> and named <var>itemname</var>.
Line 8:		Line 8:
	;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.		;<var>itemname</var>: The name of the new [[Programmer_Guide/Shell_Items\|shell item]]. If this argument is set to the character '''*''', the name is choosen automatically.
	;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].		;<var>createargs</var>: Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new [[Programmer_Guide/Shell_Items\|shell item]].
	;<code>/I</code>: Enable [[Programmer_Guide/~~Command_Reference_Intro~~/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.		;<code>/I</code>: Enable [[Programmer_Guide/Command_Reference_Options/Silent\|silent error reporting]]. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.
	;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.		;<code>/G</code>: Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.
	;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.		;<code>/U</code>: If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the [[Programmer_Guide/Command_Reference/DELETE\|delete command]]. Note: This option is case-sensitive.
	;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.		;<code>/u</code>: If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.
	;<code>/z</code>		;<code>/z</code>