1
0
mirror of https://github.com/pfusik/xasm.git synced 2024-06-15 18:29:31 +00:00

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

View File

@ -23,25 +23,25 @@ with the extension changed to `.obx`.
OPTIONS
-------
*/c*::
*-c*::
Specifies that lines skipped due to a false condition
should be included in the listing file.
[[new_deflabel]]*/d:*'LABEL'='VALUE'::
[[new_deflabel]]*-d* 'LABEL'='VALUE'::
Defines a label.
'LABEL' should be a valid label name.
'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.
*/l*'[:LISTING_FILE]'::
*-l* '[LISTING_FILE]'::
Generates listing file.
If 'LISTING_FILE' is omitted, the listing filename
is 'SOURCE_FILE' with the extension changed to `.lst`.
[[new_makefile]]*/M*::
[[new_makefile]]*-M*::
Prints a rule for use in a `Makefile`.
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)
@ -50,29 +50,31 @@ replaced by the *make* macro `$@` and `SOURCE_FILE` replaced by the macro `$<`.
Dollars in the command line are doubled.
Your `make` or shell may require further escaping.
*/o*':OBJECT_FILE'::
*-o* 'OBJECT_FILE'::
Sets output file name.
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.
[[new_quiet]]*/q*::
[[new_quiet]]*-q*::
Quiet mode. Prevents *xasm* from printing its banner and compilation summary.
*/t*'[:LABEL_FILE]'::
*-t*' [LABEL_FILE]'::
Generates label table.
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.
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
------