Deprecate DOS-style options.

This commit is contained in:
Piotr Fusik 2020-05-25 21:36:28 +02:00
parent d3908ec95e
commit 65a2c1fbdd
2 changed files with 27 additions and 25 deletions

View File

@ -1,6 +1,6 @@
// xasm 3.1.1 by Piotr Fusik <fox@scene.pl> // xasm 3.1.1 by Piotr Fusik <fox@scene.pl>
// http://xasm.atari.org // http://xasm.atari.org
// Can be compiled with DMD v2.089.0. // Can be compiled with DMD v2.092.0.
// Poetic License: // Poetic License:
// //
@ -2938,17 +2938,17 @@ int main(string[] args) {
writeln(TITLE); writeln(TITLE);
if (exitCode != 0) { if (exitCode != 0) {
write( write(
`Syntax: xasm source [options] `Syntax: xasm SOURCE [OPTIONS]
/c Include false conditionals in listing -c Include false conditionals in listing
/d:label=value Define a label -d LABEL=VALUE Define a label
/i Don't list included files -i Don't list included files
/l[:filename] Generate listing -l [FILENAME] Generate listing
/o:filename Set object file name -o FILENAME Set object file name
/M Print Makefile rule -M Print Makefile rule
/p Print absolute paths in listing and error messages -p Print absolute paths in listing and error messages
/q Suppress info messages -q Suppress info messages
/t[:filename] List label table -t [FILENAME] List label table
/u Warn of unused labels -u Warn of unused labels
`); `);
return exitCode; return exitCode;
} }

View File

@ -23,25 +23,25 @@ with the extension changed to `.obx`.
OPTIONS OPTIONS
------- -------
*/c*:: *-c*::
Specifies that lines skipped due to a false condition Specifies that lines skipped due to a false condition
should be included in the listing file. should be included in the listing file.
[[new_deflabel]]*/d:*'LABEL'='VALUE':: [[new_deflabel]]*-d* 'LABEL'='VALUE'::
Defines a label. Defines a label.
'LABEL' should be a valid label name. 'LABEL' should be a valid label name.
'VALUE' may be any expression (may reference to labels defined in source files). 'VALUE' may be any expression (may reference to labels defined in source files).
You may use several */d* options to define many labels from the command line. You may use several *-d* options to define many labels from the command line.
*/i*:: *-i*::
Excludes included files from the listing file. Excludes included files from the listing file.
*/l*'[:LISTING_FILE]':: *-l* '[LISTING_FILE]'::
Generates listing file. Generates listing file.
If 'LISTING_FILE' is omitted, the listing filename If 'LISTING_FILE' is omitted, the listing filename
is 'SOURCE_FILE' with the extension changed to `.lst`. is 'SOURCE_FILE' with the extension changed to `.lst`.
[[new_makefile]]*/M*:: [[new_makefile]]*-M*::
Prints a rule for use in a `Makefile`. Prints a rule for use in a `Makefile`.
First line of the rule lists 'OBJECT_FILE' as the target of the rule First line of the rule lists 'OBJECT_FILE' as the target of the rule
and all source files (including the ones specified with `icl` and `ins` directives) and all source files (including the ones specified with `icl` and `ins` directives)
@ -50,29 +50,31 @@ replaced by the *make* macro `$@` and `SOURCE_FILE` replaced by the macro `$<`.
Dollars in the command line are doubled. Dollars in the command line are doubled.
Your `make` or shell may require further escaping. Your `make` or shell may require further escaping.
*/o*':OBJECT_FILE':: *-o* 'OBJECT_FILE'::
Sets output file name. Sets output file name.
The default is 'SOURCE_FILE' with the extension changed to `.obx`. The default is 'SOURCE_FILE' with the extension changed to `.obx`.
[[new_fullpaths]]*/p*:: [[new_fullpaths]]*-p*::
Prints absolute paths in listing and error messages. Prints absolute paths in listing and error messages.
[[new_quiet]]*/q*:: [[new_quiet]]*-q*::
Quiet mode. Prevents *xasm* from printing its banner and compilation summary. Quiet mode. Prevents *xasm* from printing its banner and compilation summary.
*/t*'[:LABEL_FILE]':: *-t*' [LABEL_FILE]'::
Generates label table. Generates label table.
If 'LABEL_FILE' is omitted then the table is appended at the end of the listing. If 'LABEL_FILE' is omitted then the table is appended at the end of the listing.
[[new_unlabels]]*/u*:: [[new_unlabels]]*-u*::
Issues a warning message for each label whose value is unused. Issues a warning message for each label whose value is unused.
Alternatively, you may use Unix-style options, for example: Alternatively, you may use DOS-style options, for example:
----------------------------------------------------------- -----------------------------------------------------------
xasm -i -d DEBUG=1 -l listing.lst source.asx xasm /i /d:DEBUG=1 /l:listing.lst source.asx
----------------------------------------------------------- -----------------------------------------------------------
These are however deprecated because they are incompatible with MSYS.
SYNTAX SYNTAX
------ ------