list of mxmlc/compc arguments

Posted on August 9, 2006 | 7 comments

[lang_en]

Have you ever tried to figure out all the configuration parameters of mxmlc?

Well there is a lot of information inside the mxmlc itself. You can actually list all the simple and advanced command line arguments that are available. It even gives you power to search across multiple sets of lists to get speciifc information about your search terms. Lets take a more in depth look.
You start by running:

mxmlc -help

You should see:

Adobe Flex Compiler (mxmlc)
Version 2.0 build 143452
Copyright (c) 2004-2006 Adobe Systems, Inc. All rights reserved.

-help [keyword] [...]
For information on command line syntax and descriptions of
configuration variables, specify a search string, or one of the
following special keywords:
syntax   - describe the general syntax of the command line
list     - show a list of all basic configuration variables
advanced - also match advanced configuration variables
aliases  - sort using the short alias for the variable
details  - always display the full details for each item
Any other help keyword provided is used to match a full or partial
configuration variable, alias, or text to search for in the
description of the configuration variable.

For example, '-help advanced aliases foo' would show all
configuration options (both basic and advanced) containing the text
'foo', sorted by alias name.

In the description of individual configuration variables, required
values are marked with angle brackets, and optional values are marked
with square brackets.  The notation [...] is used to indicate that
the values are a list of arbitrary length.

From here you can run the help on specific keywords or upon the special keywords. You’ll see the special keywords defined as syntax, list, advanced, aliases, and details.

Here is my quick search for “theme”

C:\Documents and Settings\renaun>mxmlc -help theme
Adobe Flex Compiler (mxmlc)
Version 2.0 build 143452
Copyright (c) 2004-2006 Adobe Systems, Inc. All rights reserved.

-compiler.theme [filename] [...]
alias -theme
list of CSS or SWC files to apply as a theme (repeatable)

You can list and search through all the mxml arguments to find what you are looking for, this is much better then livedocs, hehe…

I am going to list all the arguments from the simple and more advanced special keywords to have a running list of arguments. The items in bold are found in the mxmlc -advanced list but not in the livedocs.
-benchmark
-compiler.accessible
-compiler.actionscript-file-encoding
-compiler.allow-source-path-overlap
-compiler.as3
-compiler.context-root
-compiler.debug
-compiler.defaults-css-url
-compiler.doc
-compiler.es
-compiler.external-library-path [path-element] [...]
-compiler.fonts.languages.language-range
-compiler.fonts.local-fonts-snapshot
-compiler.fonts.managers [manager-class] [...]
-compiler.fonts.max-cached-fonts
-compiler.fonts.max-glyphs-per-face
-compiler.headless-server
-compiler.include-libraries [library] [...]
-compiler.incremental
-compiler.keep-all-type-selectors
-compiler.keep-generated-actionscript
-compiler.library-path [path-element] [...]
-compiler.locale
-compiler.namespaces.namespace
-compiler.optimize
-compiler.profile
-compiler.services
-compiler.show-actionscript-warnings
-compiler.show-binding-warnings
-compiler.show-deprecation-warnings
-compiler.source-path [path-element] [...]
-compiler.strict
-compiler.theme [filename] [...]
-compiler.use-resource-bundle-metadata
-compiler.verbose-stacktraces

-compiler.warn-warning_type

-compiler.warn-array-tostring-changes
-compiler.warn-assignment-within-conditional
-compiler.warn-bad-array-cast
-compiler.warn-bad-bool-assignment
-compiler.warn-bad-date-cast
-compiler.warn-bad-es3-type-method
-compiler.warn-bad-es3-type-prop
-compiler.warn-bad-nan-comparison
-compiler.warn-bad-null-assignment
-compiler.warn-bad-null-comparison
-compiler.warn-bad-undefined-comparison
-compiler.warn-boolean-constructor-with-no-args
-compiler.warn-changes-in-resolve
-compiler.warn-class-is-sealed
-compiler.warn-const-not-initialized
-compiler.warn-constructor-returns-value
-compiler.warn-deprecated-event-handler-error
-compiler.warn-deprecated-function-error
-compiler.warn-deprecated-property-error
-compiler.warn-duplicate-argument-names
-compiler.warn-duplicate-variable-def
-compiler.warn-for-var-in-changes
-compiler.warn-import-hides-class
-compiler.warn-instance-of-changes
-compiler.warn-internal-error
-compiler.warn-level-not-supported
-compiler.warn-missing-namespace-decl
-compiler.warn-negative-uint-literal
-compiler.warn-no-constructor
-compiler.warn-no-explicit-super-call-in-constructor
-compiler.warn-no-type-decl
-compiler.warn-number-from-string-changes
-compiler.warn-scoping-change-in-this
-compiler.warn-slow-text-field-addition
-compiler.warn-unlikely-function-value
-compiler.warn-xml-class-has-changed

-debug-password
-default-background-color
-default-frame-rate
-default-script-limits
-default-size
-dump-config
-externs [symbol] [...]
-file-specs [path-element] [...]
-frames.frame [label] [classname] [...]
-help [keyword] [...]
-includes [symbol] [...]
-lazy-init
-licenses.license
-link-report
-load-config
-load-externs

-metadata.contributor
-metadata.creator
-metadata.date
-metadata.description
-metadata.language
-metadata.localized-description
-metadata.localized-title
-metadata.publisher
-metadata.title

-output
-raw-metadata
-resource-bundle-list
-runtime-shared-libraries [url] [...]
-use-network
-version
-warnings

Here is the list of options that are in the livedocs and not in the mxmlc -advanced

-compiler.warn-warning_type and -metadata options refer to groups of options shown above. In the livedocs options all metadata options are shown in the alias form (contributor,creator,date,description,langugage,localized-description,localized-title,publisher and title).

max-recursion-depth
max-execution-time
defaults-css-url
generate-frame-loader

There is a bunch of more good information at the flexcoders post by Roger located at http://groups.yahoo.com/group/flexcoders/message/46751

[/lang_en]

[lang_zh]

Renaun-
how has the site been doing lately?
你们有没有试过了解mxmlc的所有配置范围吗?

mxmlc自己有很多很多的信息。你可以列举一个有所有可获得的简单和发达的命令行争论。它也有为了找具体信息包括搜查多重名单的能力。我们一起看–

一开始:

mxmlc -help

应该看到:

Adobe Flex Compiler (mxmlc)
Version 2.0 build 143452
Copyright (c) 2004-2006 Adobe Systems, Inc. All rights reserved.

-help [keyword] [...]
For information on command line syntax and descriptions of
configuration variables, specify a search string, or one of the
following special keywords:
syntax   - describe the general syntax of the command line
list     - show a list of all basic configuration variables
advanced - also match advanced configuration variables
aliases  - sort using the short alias for the variable
details  - always display the full details for each item
Any other help keyword provided is used to match a full or partial
configuration variable, alias, or text to search for in the
description of the configuration variable.

For example, '-help advanced aliases foo' would show all
configuration options (both basic and advanced) containing the text
'foo', sorted by alias name.

In the description of individual configuration variables, required
values are marked with angle brackets, and optional values are marked
with square brackets.  The notation [...] is used to indicate that
the values are a list of arbitrary length.

从这里你可以在具体单词或特别单词开”帮助”。特别单词定义为
文法(syntax),目录 (list), 发达 (advanced), 表字 (alias) 和端详 (details)。

这儿有”题材”的快叟:

C:\Documents and Settings\renaun>mxmlc -help theme
Adobe Flex Compiler (mxmlc)
Version 2.0 build 143452
Copyright (c) 2004-2006 Adobe Systems, Inc. All rights reserved.

-compiler.theme [filename] [...]
alias -theme
list of CSS or SWC files to apply as a theme (repeatable)

为了寻找你想得到的你可以列举和搜查mxml所有的争论, 这比livedocs 好得多,哈哈…

我先列举简单和更高级的特别单词, 为了产生争论的目录。黑体的就是mxmlc高级的但不在livedocs.

-benchmark
-compiler.accessible
-compiler.actionscript-file-encoding
-compiler.allow-source-path-overlap
-compiler.as3
-compiler.context-root
-compiler.debug
-compiler.defaults-css-url
-compiler.doc
-compiler.es
-compiler.external-library-path [path-element] [...]
-compiler.fonts.languages.language-range
-compiler.fonts.local-fonts-snapshot
-compiler.fonts.managers [manager-class] [...]
-compiler.fonts.max-cached-fonts
-compiler.fonts.max-glyphs-per-face
-compiler.headless-server
-compiler.include-libraries [library] [...]
-compiler.incremental
-compiler.keep-all-type-selectors
-compiler.keep-generated-actionscript
-compiler.library-path [path-element] [...]
-compiler.locale
-compiler.namespaces.namespace
-compiler.optimize
-compiler.profile
-compiler.services
-compiler.show-actionscript-warnings
-compiler.show-binding-warnings
-compiler.show-deprecation-warnings
-compiler.source-path [path-element] [...]
-compiler.strict
-compiler.theme [filename] [...]
-compiler.use-resource-bundle-metadata
-compiler.verbose-stacktraces

-compiler.warn-warning_type

-compiler.warn-array-tostring-changes
-compiler.warn-assignment-within-conditional
-compiler.warn-bad-array-cast
-compiler.warn-bad-bool-assignment
-compiler.warn-bad-date-cast
-compiler.warn-bad-es3-type-method
-compiler.warn-bad-es3-type-prop
-compiler.warn-bad-nan-comparison
-compiler.warn-bad-null-assignment
-compiler.warn-bad-null-comparison
-compiler.warn-bad-undefined-comparison
-compiler.warn-boolean-constructor-with-no-args
-compiler.warn-changes-in-resolve
-compiler.warn-class-is-sealed
-compiler.warn-const-not-initialized
-compiler.warn-constructor-returns-value
-compiler.warn-deprecated-event-handler-error
-compiler.warn-deprecated-function-error
-compiler.warn-deprecated-property-error
-compiler.warn-duplicate-argument-names
-compiler.warn-duplicate-variable-def
-compiler.warn-for-var-in-changes
-compiler.warn-import-hides-class
-compiler.warn-instance-of-changes
-compiler.warn-internal-error
-compiler.warn-level-not-supported
-compiler.warn-missing-namespace-decl
-compiler.warn-negative-uint-literal
-compiler.warn-no-constructor
-compiler.warn-no-explicit-super-call-in-constructor
-compiler.warn-no-type-decl
-compiler.warn-number-from-string-changes
-compiler.warn-scoping-change-in-this
-compiler.warn-slow-text-field-addition
-compiler.warn-unlikely-function-value
-compiler.warn-xml-class-has-changed

-debug-password
-default-background-color
-default-frame-rate
-default-script-limits
-default-size
-dump-config
-externs [symbol] [...]
-file-specs [path-element] [...]
-frames.frame [label] [classname] [...]
-help [keyword] [...]
-includes [symbol] [...]
-lazy-init
-licenses.license
-link-report
-load-config
-load-externs

-metadata.contributor
-metadata.creator
-metadata.date
-metadata.description
-metadata.language
-metadata.localized-description
-metadata.localized-title
-metadata.publisher
-metadata.title

-output
-raw-metadata
-resource-bundle-list
-runtime-shared-libraries [url] [...]
-use-network
-version
-warnings
livedocs有的选项但是高级mxmlc没有就是:

-compiler.warn-warning_type and -metadata options refer to groups of options shown above. In the livedocs options all metadata options are shown in the alias form (contributor,creator,date,description,langugage,localized-description,localized-title,publisher and title).

max-recursion-depth
max-execution-time
defaults-css-url
generate-frame-loader

在flexcoders,Roger贴上的更多信息

http://groups.yahoo.com/group/flexcoders/message/46751

[/lang_zh]

  • http://thefalken.livejournal.com Tom Chiverton

    Eww, dude !
    Is there something wrong with the livedocs, rooted around about http://livedocs.macromedia.com/flex/2/docs/00001500.html ?

  • http://www.renaun.com Renaun Erickson

    The only thing is there are differences between the two sources. Livedocs shows mostly alias and has good descriptions. The mxmlc -advanced list shows some that are not explained fully (or well) in the livedocs. And then there are some in the livedocs that are not in the mxmlc -advanced list.

  • http://adobe.com matthew horn

    Some notes about the compiler options that appear in the advanced mxmlc list but do not appear in livedocs:
    compiler.doc – was not implemented at publish date.
    compiler.keep-all-type-selectors – this is supposed to be an internal-only option for Flex Builder.
    compiler.profile – was not implemented at publish date.
    compiler.warn-warning_type – I thought these were pretty self-explanatory and decided to leave them out of the livedocs doc.

    I’ll look into why licenses.license, raw-metadata, and compiler.use-resource-bundle-metadata have been left out of livedocs.

    The metadata options (such as contributor, creator, and data) are in livedocs, but I didnt include their prefix (“metadata.”) since they are unique (as are all compiler options), so they show up in the general list in alphabetical order.

    hth,
    matt horn
    flex docs

  • http://www.renaun.com Renaun Erickson

    Matt,

    Thank you for the update.

    Renaun

  • Josephine

    Hi, Renaun.
    Do you know where the action script files are kept if -compiler.keep-generated-actionscript is set to true?
    Thanks,
    Josephine

  • Josephine

    Duh. Nevermind. I found them under as3/generated/

  • Pingback: KinRou Blog » mxmlc compiler agument options

  • Pingback: » Ò»¸öÓÐȤµÄFlex¼¼ÊõÕ¾µã :: Fluid idea for RIA

  • Gnanasekaran

    Is it possible to compile more than one mxml file in a command line?
    Like mxmlc *.mxml

  • Pingback: Strings :: Domani Studios » Blog Archive » FDT, Ant, and Debugging