A proper changelog added.

Changelog in docs seems to be a bit long now, which affects readability, so it will be removed.

CHANGELOG.md

@@ -0,0 +1,353 @@
+## [1.13.3](https://github.com/z00m128/sjasmplus/releases/tag/v1.13.3) - 21.7.2019
+- bugfixes, new examples (check tests/lua_examples)
+- UTF BOM are now detected, UTF8 BOM is silently skipped, UTF16/32 BOMs cause fatal error
+- `ZXSPECTRUMNEXT` device is now initialized with whole memory zeroed (no more ZX48 sysvars)
+- `DEFL` documented, "no forward reference" rule relaxed for `EQU`
+- some error messages reworded to make them easier to comprehend
+
+## [1.13.2](https://github.com/z00m128/sjasmplus/releases/tag/v1.13.2) - 28.6.2019
+- `OPT` has now also `listoff` and `liston` commands
+- added to `--syntax` option: case insensitive instructions, `bBw` added/changed
+- new macro examples, minor fixes and refactoring
+- `SAVETRD` implementation refactored (more checks, less bugs, "replace" file feature)
+- operators `{address}` and `{b address}` are now official and documented
+
+## [1.13.1](https://github.com/z00m128/sjasmplus/releases/tag/v1.13.1) - 30.05.2019
+- added `--syntax` command line option
+- added `OPT` directive (modifies some command line options)
+- added way to use structure at designed address
+- `MACRO` can be now named through label (optional syntax)
+- added `DEFARRAY+` directive (for splitting long list of `DEFARRAY` values)
+- added `CSPECTMAP` directive for `MAP` files for CSpect emulator
+- added support for `SJASMPLUSOPTS` environment variable
+- Z80N new variants of syntax, now also `mul de : mul : pixelad hl : pixeldn hl` works
+- minor bugfixes, improvements and internal refactorings (error reporting)
+- updated syntax-highlight file for KDE5 editors (Kate)
+
+## [1.13.0](https://github.com/z00m128/sjasmplus/releases/tag/v1.13.0) - 05.05.2019
+- [may break old sources] `DEVICE`: each assembling pass resets also
+  "device". To work with "device" memory (`SAVESNA`, `SAVETAP`, ...) you
+  must select the device (and slot and pages) before producing machine
+  code which you want to work with (`SAVESNA`, `SAVETAP`, ...).
+  If only single `DEVICE` is used in whole source batch, then the setting
+  is "global" and will be applied to all lines of source (in 2nd+ pass).
+- [may break old sources] `ZXSPECTRUM128` based devices map into slots
+  by default banks {7, 5, 2, 0}. (was {0, 5, 2, 7} in older versions)
+- [may break old sources] `ZXSPECTRUM128` based devices have sysvars and
+  stack set up as in `USR 0` mode (`ZXSPECTRUM48` system variables and
+  default stack content).
+- [may break old sources] `MAP` + `FIELD` directives removed (`STRUCT` is better and working)
+- `MMU` directive (fusing `SLOT` + `PAGE` and extending them)
+- `SAVEDEV` directive (similar to `SAVEBIN`)
+- `SAVENEX` directive (for ZX Spectrum Next)
+- INCBIN: support for negative offset/length values, support for `MMU` wrapping
+- INCBIN: support for file chunks of 64+ki size (usable with `MMU`)
+- Fixed: `INCTRD` offset, binary `STDOUT` on windows, `SAVETRD`, `SAVEHOB` filenames
+- Fixed: LUA used inside macros, LUA get_word, LUA error reporting
+- parser: added C++(like) numeric literals
+- `ZXSPECTRUMNEXT` device added
+- refactoring of label/define implementation = less memory leaks, more correct
+  "label.mem_page" values, "Unreal" labels dump is more correct too
+- docs: now the CSS file is actually used, and default style modified a bit
+- new MACRO examples, syntax-highlight file for KDE5 editors (Kate)
+
+## [1.12.0](https://github.com/z00m128/sjasmplus/releases/tag/v1.12.0) - 07.04.2019
+- Fixed parsing of expressions starting with string literal
+- Fixed listing of `DS` directive with negative values, added value check warning
+- Fixed possible wrong indexing of some arrays internally
+- Fixed parsing of single-word instructions in colon-packed-no-space macros
+- Making macro arguments substitution a bit more aggressive, to work also with
+  `DEFINE`, `IFDEF`, `IFNDEF`, `DEFARRAY` directives inside macro (this gives the coder
+  more macro power and freedom, but the error reporting may get lot more confused)
+- Refactoring substring substitution for macro-arguments and defines, now it
+  should work always. To prohibit some macro/define to substitute into middle
+  of the string, start its name with underscore, like "_VERSION".
+- THIS MAY BREAK SOME OLDER SOURCES, SORRY. Also the rules for substitutions
+  will be in the future further modified and documented, to make them more
+  intuitive and predictable, so there may be more breakage even later.
+- Adding fake instructions break and exit for CSpect emulator (`--zxnext=cspect`)
+
+## [1.11.1](https://github.com/z00m128/sjasmplus/releases/tag/v1.11.1) - 01.04.2019
+- Fixed global labels in `MACRO` and in `IFUSED`, `IFNUSED`
+- Fixed nested `IF`-`DUP`-`IF`
+- Fixed local labels fail when amount of lines did change between passes
+- Fixed Makefile to build when path to project contains space
+- Added macro-example: turn `DJNZ .` into `DJNZ $` (to fix Zeus syntax source)
+- Added `--msg=lst` and `--msg=lstlab` options to produce listing file to `STDERR`
+- Added options to read input file from `STDIN` and output "raw" binary to `STDOUT`
+
+## [1.11.0](https://github.com/z00m128/sjasmplus/releases/tag/v1.11.0) - 22.03.2019
+- Added ZX Spectrum Next instructions support
+- Added `--msg` option, directives `DG` and `DH`
+- Changed listing layout to fixed-width type
+- Errors, Warnings and similar are now channeled to `STDERR`
+- Fixed string literal parser, added two apostrophes and escaped zero
+- Fixed docs templates (HTML is now more valid)
+- Fixed nesting `DUP` issue
+- Fixed CRLF handling in parser
+- Fixed `-D` option for multiple asm files
+- Fixed address display when the 64kB limit exceeded
+- Fixed lost code when current memory leaves device slot in "disp" mode
+- Fixed `IF` inside `MACRO`, `DUP` and `REPT`
+- Fixed `ALIGN` behavior and docs wording
+- Fixed `INCHOB`, `INCBIN` (offset / length)
+- Fixed `INCLUDE`, `INCLUDELUA` system path priority ("" vs <>)
+- Fixed `END` behavior
+- Fixed `DEFARRAY` to work as documented
+- Fixed and refactored `WORD`, `DWORD`, `D24`
+- Fixed and extended `STRUCT`
+- Multiple bugfixes in listing generation
+- Multiple bugfixes of internal code
+- Refactored options parser, instruction parser and Warning/Error system
+- C++14 standard is now required minimum (to compile sjasmplus sources)
+- Added automated-testing scripts, with 50+ tests
+- GitHub connected with Cirrus Continuous Integration service
+
+## [1.10.4](https://github.com/z00m128/sjasmplus/releases/tag/v1.10.4) - 09.01.2019
+- `Bytes lost` error reworked (and changed to warning)
+- Error/warning messages are displayed in last pass only (where possible)
+- Fixed 64k limit warnigs
+- BinIncFile reworked
+
+## [1.10.3](https://github.com/z00m128/sjasmplus/releases/tag/v1.10.3) - 26.11.2018
+- Fixed macro issue with commas inside quotes
+- Fixed `IFUSED` and `IFNUSED` directives
+- Fixed `STRUCT` directive
+- Added support of register operands for operators `HIGH` and `LOW`
+
+## [1.10.2](https://github.com/z00m128/sjasmplus/releases/tag/v1.10.2) - 09.08.2018
+- Fixed bug in `UNDEFINE` directive
+- Fixed bug in parser line wrapping
+
+## [1.10.1](https://github.com/z00m128/sjasmplus/releases/tag/v1.10.1) - 15.05.2018
+- Fixed bug in `OUTPUT` directive (bugfix of flushing buffer)
+- Implemented `TAPOUT`, `TAPEND` and `OUTEND` directives
+
+## [1.10.0](https://github.com/z00m128/sjasmplus/releases/tag/v1.10.0) - 06.05.2018
+- Implemented full featured `SAVETAP` and `EMPTYTAP` directives
+
+## [1.09](https://github.com/z00m128/sjasmplus/releases/tag/v1.09) - 07.09.2017
+- `-D` commandline parameter added
+- `INCHOB`, `INCBIN` bugfix
+
+## [1.08](https://github.com/z00m128/sjasmplus/releases/tag/v1.08) - 23.12.2016
+- a lot of compilation warnings were cleaned up
+- CMake build method implemented
+
+## [1.07-rc9](https://github.com/z00m128/sjasmplus/releases/tag/v1.07-RC9) - 11.10.2016
+- a few compilation warnings were cleaned up
+- documentation was added
+
+## [1.07-rc8](https://github.com/z00m128/sjasmplus/releases/tag/v1.07-RC8) - 05.05.2016
+- new makefile
+- compilation errors fixed
+- a few compilation warnings were cleaned up
+
+## [1.07-rc7](https://github.com/z00m128/sjasmplus/releases/tag/v1.07-RC7)
+- Added new `SAVETAP` pseudo-op. It's support up to 1024kb ZX-Spectrum's RAM
+- Added new `--nofakes` commandline parameter
+- Another fix of 48k SNA snapshots saving routine
+- Added new `UNDEFINE` pseudo-op
+- Added new `IFUSED`, `IFNUSED` pseudo-ops for labels (such `IFDEF` for defines)
+- Fixed labels list dump rountine (`--lstlab` command line parameter)
+
+## 1.07-rc6 - 27.03.2008
+- Applied bugfix patches for `SAVEHOB`, `SAVETRD` pseudo-ops by Breeze
+- Fixed memory leak in line parsing routine
+- Fixed 48k SNA snapshots saving routine
+- Added missing `INF` instruction
+- Fixed code parser's invalid addressing of temporary labels in macros
+
+## 1.07-rc5bf - 31.05.2007
+- Bugfix patches by Ric Hohne
+- Important bugfix of memory leak
+- Bugfix of strange crashes at several machines
+- Added yet another sample for built-in LUA engine. See end of this file
+- Added sources of CosmoCubes demo to the "examples" directory
+
+## 1.07-rc5 - 13.05.2007
+- `ALIGN` has new optional parameter
+- Corrected bug of RAM sizing
+- Corrected bug of structures naming
+
+## 1.07-rc4bf - 02.12.2006
+- Corrected important bug in code generation functions of SjASMPlus
+
+## 1.07-rc4 - 28.11.2006
+- Corrected bug with `SAVEBIN`, `SAVETRD` and possible `SAVESNA`
+- Add Makefile to build under Linux, FreeBSD etc
+
+## 1.07-rc3 - 12.10.2006
+- `SAVESNA can save 48kb snapshots
+- Corrected `DEFINE` bug
+- Corrected bug of incorrect line numbering
+
+## 1.07-rc2 - 28.09.2006
+- `SAVESNA` works and with device `ZXSPECTRUM48`
+- Added new device `PENTAGON128`
+- In `ZXSPECTRUM48` device and others attributes has black ink and white paper by default
+
+## 1.07-rc1bf - 23.09.2006
+- Corrected bug with `_ERRORS` and `_WARNINGS` constants
+- Added error message, when `SHELLEXEC` program execution failed
+
+## 1.07-rc1 - 17.09.2006
+- 3-pass design
+- Built-in Lua scripting engine
+- Changed command line keys
+- Documentation converted to HTML
+- Added new directives: `DEVICE`, `SLOT`, `SHELLEXEC`
+- Added predefined constanst: `_SJASMPLUS=1`, `_ERRORS` and other
+- Changed output log format
+- And many many more
+
+## 1.06 Stable - 2006.08.02
+- Corrected bug in `INCTRD`
+- Added version of compiler for DOS
+
+## 1.06-rc3 - 2006.07.25
+- Corrected some important bugs
+
+## 1.06-rc2bf - 2006.04.23
+- Corrected bug in `LABELSLIST`
+
+## 1.06rc2 - 2006.04.20
+- Corrected bugs in `STRUCT`, `ENDS`
+- Applied changes from new version of SjASM 0.39g:
+	- `ENDMAP` directive
+	- `DEFM` and `DM` synonyms for `BYTE`
+- Some bug fixes:
+	- file size is reset when a new output file is opened
+	- `bytes lost` warning fixed
+And thanks to Konami Man:
+  - `PHASE` and `DEPHASE` directives as synonyms of `TEXTAREA` and `ENDT`
+  - `FPOS` directive.
+  - Expanded `OUTPUT` directive.
+  - The possibility to generate a symbol file.
+
+## 1.06-rc1 - 2006.01.19
+- WARNING! To enlarge compatibility of the SjASMPlus with other assemblers, the key `-B` ENABLES(but no disables) possibility writing pseudo-ops from the beginning of line.
+- Corrected bug with chars which position in ascii table is more than 127
+- Corrected bug with `DISP`, `ENT`
+- Added new pseudo-op `DEFM`, `DM` as synonym of `DB`, `DEFB`, `BYTE`
+- `DEFL`(this is new pseudo-op) and `LABEL=...` can be redefined
+- Corrected bug with temporary labels in `DUP`, `REPT`
+- New pseudo-op `DEFARRAY` to create array of DEFINEs. Can not be redefined
+
+## 1.05 Stable
+- Corrected bug with including external files
+- Now sjasm.exe has icon.
+- To distributive included version for FreeBSD
+- Corrected bug, when `END` could not be a label
+- Added new key `-B`
+
+## 1.05-rc3
+- Corrected small bug of directive processing
+- Added support of {..} as in Alasm (see below)
+- Added possibility to write commands ADC,ADD,AND,BIT and etc throught comma: XOR B,C,A ;---> XOR B / XOR C / XOR A
+
+## 1.05-rc2
+- Second very important fix of procedure of line reading
+- Corrected bug in `INCTRD`
+- Added possibility to write commands LD,INC,DEC,CALL,DJNZ,JP,JR throught comma (in test mode!): LD A,D,A,0,HL,100h or INC A,B,C,D,A,A etc
+
+## 1.05-rc1
+- Very important fix of procedure of line reading
+
+## 1.05 (debug)
+- Now you can write directives from the beginning of line
+- Added directive `.<expression> <code>`, where `<expression>` - count of repeats, `<code>` - code, which need to repeat
+- Corrected small bug of `IF` and `IFN`
+- Added directive `LABELSLIST` (by Kurles^HS^CPU)
+- Added directive `DISPLAY` analogue of Alasm's directive (by Kurles^HS^CPU)
+- Added directives `EMPTYTRD`, `SAVETRD`, `INCHOB`, `INCTRD`
+- Remade procedure of lines reading (added support of end lines codes of Mac and Unix)
+- Added support of resting of `DUP`, `REPT` and synonym of `EDUP` -- `ENDR`
+- Corrected error with macros
+
+## 1.04 (debug)
+- Speeded up! 250000 lines of code compiles with 1.15 sec instead of 2.5 sec! And SjASMPlus will no more eat so much RAM.
+- Added support of encodings (WIN/DOS) --- directive `ENCODING` and key `-d` (by Kurles^HS^CPU)
+- Added directive `IFN` an opposition of `IF`
+
+## 1.03 (debug)
+- Added counter of compiled lines
+- Added directive `SAVEHOB`, which saves block of memory in Hobeta format (by Kurles^HS^CPU)
+- Corrected bug with using <..> in directives `INCLUDE`, `INCBIN` and etc (by Kurles^HS^CPU)
+
+## 1.02 (debug)
+- New synonym of `INCBIN` -- `INSERT`
+- Added support of ZX-Spectrum memory. Use key `-m` for this.
+- With key `-m` enabling new directives `PAG`E, `SAVESNA`, `SAVEBIN` and extra parameter of `ORG <address>,<pagenumber>`
+- Added directives `DISP`, `ENT` (`PHASE`, `UNPHASE`, `DEPHASE`)
+- Speeded up. 250000 lines of code compiles with 2.5 sec instead of 7 sec!
+- Max length of line now is 1024 bytes
+
+## 1.01 alpha
+- Added synonym of EX AF,AF' -- EXA
+- Corrected small bug with DEFINEs
+- Small speed up
+- Added support of single quotes for `BYTE`, `DB`, `DC`, `DZ`, in which don't working slash (example \n will be \n, but not carry to new line)
+- Commented all changes in sources
+- -Q & -L was returned (yet in test mode)
+
+## 1.00 alpha
+- Added key `-P` which enabled reverse compiling of POP (i.e POP  AF,BC will be compiled to pop  bc / pop  af)
+- Support code throught colon (LD A,C:INC A:PUSH AF:IFDEF FX:LD A,D:ENDIF...)
+- New synonym of `REPT` -- `DUP`
+- Synonyms of IXH,IXL and IYH,IYL: XH,XL,LX,HX,YH,YL,HY,LY
+- Corrected small bugs (with SIZE and other)
+- Shortened listing file was more friendly
+- Display time of compilation
+
+## 0.39f
+- Maximum, minimum, and, or, mod, xor, not, shl, shr, low and high operators added.
+- Logical operations result in -1 or 0 instead of 1 or 0. Of course, -1 for true and 0 for false ;)
+- Fixed the "ifdef <illegal identifier>" bug
+
+## 0.30
+- `#` Can be used now to indicate a hexadecimal value
+- Local "number" labels should really work now
+- Multiple error messages per source line possible
+- Things like ld a,(4)+1 work again (=> ld a,5). Somehow I broke this in v0.3
+- Filenames don't need surrounding quotes anymore
+- Macro's can be nested once again
+- Better define-handling
+- `Textarea` detects forward references
+- Include within include searches relative to that include
+- Unlocked some directives (assert, output)
+- `#` Can be used in labels
+- No space needed between label and `=` in statements like `label=value`
+- The `export` directive now exports `label: EQU value` instead of `label = value`
+- Labelnames starting with a register name (like HL_kip) shouldn't confuse SjASM anymore
+- RLC, RRC, RL, RR, SLA, SRA, SLL (SLI), RES and SET undocumented instructions added
+- `ex af,af` and `ex af` are possible now
+- Added defb, defw and defs
+- Locallabels now also work correctly when used in macros
+- Added `//` and limited `/* */` comments
+- SjASM now checks the label values between passes
+- `>>>` Operator added
+- Sources included
+- `>>>` And `>>` operators now work the way they should (I think)
+- Removed the data/text/pool-bug. (Together with the data/text/pool directives. ~8)
+- Added `endmodule` and `endmod` to end a module
+- `STRUCT` directive
+- `REPT`, `DWORD`, `DD`, `DEFD` directives
+- More freedom with character constants; in some cases it's possible to use double quotes...
+- It's now possible to specify include paths at the command line
+- Angle brackets are used now to include commas in macroarguments. So check your macro's
+- Fixed a structure initialization bug
+- It's not possible to use CALLs or jumps without arguments anymore
+- `DZ` and `ABYTEZ` directives to define null terminated strings
+- SjASM now checks for lines that are too long
+- Added "16 bit" LD, LDI and LDD instructions
+- PUSH and POP accept a list of registers
+- Added "16 bit" SUB instruction
+- Unreferenced labels are indicated with an 'X' in the labellisting
+- Unknown escapecodes in strings result in just one error (instead of more)
+- Labelnameparts now have a maximum of 70 characters
+- Improved IX and IY offset checking
+
+## 0.2
+- SjASM v0.3x assumes Z80-mode as there are no other cpus supported
+- All calculations are 32 bits