The command line syntax is as follows:
IntentUp <source> [ <destination> ] [ <options> ]
<source> can be either a file or directory. <source> is required. If a file, the extension must be included. Permitted extensions are IKS, IKP, and IKM. IKB (binary) files are not translatable. If a directory, the /e option determines what extensions are selected for translation. All files which live in the directory and have the target extension(s) will be translated.
<destination> can be either a file or directory. A directory is more common. If not present, the directory of the source is used, and a string is appended to the output file name, according to the /a option. This ensures that the destination file will not overwrite the source file.
If the destination is a directory, a file with the same name and extension as the source file will be created. If one is already present in the destination directory, the behavior is to either fail or overwrite, according to the /o option.
The syntax for options is
/<option letter>[<space><option value>]
Multiple options can be combined in the same command. Order does not matter for options. For example:
IntentUp “C:\myOldFiles” “C:\myNewFiles” /m 100 /o /e “iks”
translates all the iks files in C:\myOldFiles into Intent Language version 3 IKS files in C:\myNewFiles, ensuring that line length is limited to 100 characters, and overwriting any identically named files already present in C:\myOldFiles.
/a Append name
/a “<suffix>”
Appends the suffix characters to the file name if writing to the source directory. The default is /a “_v3”. Thus, foo.iks will translated into foo_v3.iks. This option only applies if the destination is a directory and is identical to the source directory (which is the case if the destination directory is not supplied).
/e Extensions to translate
/ e “<extensions>”
Selects only files with the provided extensions for translation. The default is /e “iks,ikp,ikm”. Case is not significant. In no case will any files other than Intent source (IKS), Intent project (IKP), or Intent model (IKM) be selected.
/I Indent string
/I “<indent chars>”
Provides the system with a string to insert for each level of indentation on output. The default is /I “ “ (two spaces). Note that it is not possible to type \t for tabs – actual tabs must be inserted.
/m Max Line Length
/m <n>
Causes lines longer than n (an integer) to be “continued”. This is a soft limit. If the line cannot be broken at the given point, it will be broken at the next opportunity. The absolute maximum line length is 255. The minimum is 40. The default is 80.
/o Overwrite
/o
If present, indicates that files of the same name may be overwritten. The default is to NOT overwrite, and report a level 2 warning (severe warning).
/q Quiet mode
/q
If present, does not report statistics. Note that this does not affect warnings and errors, which are controlled by /w. The default is to report statistics.
/w Warning Level
/w <integer>
Determines what level of warnings errors will be reported. The integer is interpreted as follows:
0 No warnings are reported 1 Errors only are reported 2 Errors and severe warnings are reported 3 All Errors and warnings are reported
The default is /w 3.