Skip to content

Commit 14794a9

Browse files
committed
Documented all deprecated features I could find
1 parent a9c46d5 commit 14794a9

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

docs/changelog/index.html

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ <h3>Contributors:</h3>
4545
<ul>
4646
<li>RPG Hacker</li>
4747
<li>randomdude999</li>
48+
<li>p4plus2</li>
49+
<li>Atari2</li>
4850
</ul>
4951

5052
<h3>Notes:</h3>
@@ -57,6 +59,8 @@ <h3>New features:</h3>
5759
<li>The Asar test suite can now verify user-printable strings. (RPG Hacker)</li>
5860
<li>The <code>error</code>, <code>warn</code> and <code>assert</code> commands now support the same functions as the print command. (RPG Hacker)</li>
5961
<li>Static labels (i.e. labels that don't move between passes) can now be used in more places, including if statements. (RPG Hacker)</li>
62+
<li>Asar can be built as a static library. (Atari2)</li>
63+
<li>Asar now uses named warnings and errors instead of magic numbers as identifiers. (p4plus2, RPG Hacker)</li>
6064
</ul>
6165

6266
<h3>Bug fixes:</h3>
@@ -67,11 +71,31 @@ <h3>Bug fixes:</h3>
6771
<li>For invalid table files, Asar now prints the line number of the first invalid entry. (RPG Hacker)</li>
6872
<li>When Asar generates addr-to-line mappings, it now includes multiple addresses for pseudo opcodes like &quot;asl #4&quot;. (RPG Hacker)</li>
6973
<li><code>'''</code> and <code>';'</code> are now valid can now be used without causing errors. (randomdude999, RPG Hacker)</li>
74+
<li>Fixed some edge case bugs in Asar's virtual filesystem (usable via the DLL) on Windows. (Atari2)</li>
7075
</ul></div>
7176

7277
<h3>Deprecated features:</h3>
7378
<ul>
74-
<li>Warning and error IDs: Asar now uses named warnings and errors. (p4plus2, RPG Hacker)</li>
79+
<li>Warning and error IDs: Use new name strings instead.</li>
80+
<li><code>JMP.l</code>: Use <code>JML</code> instead.</li>
81+
<li>Quoted symbolic arguments to functions (e.g. <code>sizeof("my_struct")</code>): Remove the quotes (<code>sizeof(my_struct)</code>).</li>
82+
<li>Redefining previously defined functions.</li>
83+
<li><code>math round</code> and <code>math pri</code>: Use parentheses and explicit rounding where xkas-style math emulation is needed instead.</li>
84+
<li><code>.d</code> length specifier on opcodes.</li>
85+
<li><code>if !condition</code> to negate conditions: Use <code>if not(condition)</code> instead.</li>
86+
<li>While blocks ending with <code>endif</code>: Use <code>endwhile</code> instead.</li>
87+
<li><code>bankcheck on</code>: Use <code>bankcheck full</code> or <code>bankcheck half</code> instead.</li>
88+
<li><code>rep</code> to repeat commands: Use while loops or unrolled loops instead.</li>
89+
<li>Windows-specific paths (e.g. <code>incsrc dir\file.asm</code>): Use cross-platform paths instead (<code>incsrc dir/file.asm</code>).</li>
90+
<li><code>table</code> command: Assign characters directly instead, like <code>'a' = $00</code>.</li>
91+
<li>Labels in <code>padbyte</code> or <code>fillbyte</code> commands.</li>
92+
<li><code>spc700-raw</code> architecture: Use <code>spc700</code> with <code>norom</code> instead.</li>
93+
<li><code>fastrom</code>: Has never actually worked and can be removed.</li>
94+
<li><code>header</code>: Doesn't do anything and can be removed.</li>
95+
<li>Non-UTF-8 source files: Re-save your source files as UTF-8 in a text editor of choice.</li>
96+
<li><code>;@command</code> and <code>@command</code> notation: Use <code>command</code> instead.</li>
97+
<li>Wrapping defines to resolve in quotes (e.g. <code>db "!define"</code>): The quotes aren't needed (<code>db !define</code>).</li>
98+
<li>Single-line/inline if statements: Use full if blocks with an <code>if</code>/<code>endif</code> pair instead.</li>
7599
</ul></div>
76100

77101
<hr />

0 commit comments

Comments
 (0)