Merge https://github.com/cc65/cc65

Pull to fix extra changes in PR #863

Fixed LinuxDoc Tools issues in some verbatim blocks in the Atari document.

Adds address after JVB instruction in the display list example.

Fix 32/64-bit int/pointer casts

Remove trailings spaces from CBM-related asm files

Changed enum for FP-register index.

AtariOS: Fix for FPIDX enum

Added a C header that translates from the source file's encoding to PetSCII.

It can be used to undo what "cbm_screen_charmap.h" does.  Together, those headers let you mix screen-code and PetSCII string and character literals in a C source file's Assembly output.

Merge remote-tracking branch 'irgendwer/AtariOS_Structure' into master

Code review changes and improved formatting.

Atari OS: Reestablished DCB structure, fixed union span and timer2.

Renamed a C header.

All of Commodore's 8-bit computer models use the same screen-codes.

Fixed the CBM screen-code C header.

Changed the number literals from Assembly format to C format.  Swapped the (upper-/lower-case) mappings of letters because the header converts from ASCII, not PetSCII.

Merge pull request #852 from IrgendwerA8/AtariOS_Structure

Access Atari OS variables by structure. seems good. Thanks!

Added missing pointer star for Basic structure.

Code review changes and build fix.

Refactorred a CBM screen-code macro, so that we can use it as an operand.

For example: lda #scrbyte 'B'

Access Atari OS variables by structure.

Minor math optimizations

Merge pull request #849 from polluks/patch-4

Update cbm510.sgml

Update cbm510.sgml

There is just one CIA but it's not called "CIA1"...

Merge remote-tracking branch 'dmsc/xex-c' into upstream-master

Change XEX configuration file names to better reflect original names.

Also, updates documentation with the new files.

Add sample linker configurations for Atari binary output in C.

Separate header and trailers of Atari system_check chunk.

This allows to omit the headers and trailers if needed.

Don't write INITAD if the memory area is empty.

Add support for INITAD to the Atari binary format.

un-remove TABs in doc/using-make.sgml

Move Atari-specific PIA reg vals to atari.h

PIA is also used in the Commodore PET, and for different
purposes (see http://www.6502.org/users/andre/petindex/progmod.html#pia1),
so extracted Atari-specific register #defines and placed them in atari.h.

remote TABs in doc/ and test/

Merge pull request #834 from jedeoric/master

Update telestrat target doc, add tgi_clear support for telestrat target, stratsed & telemon 2.4 vars added

Add translation from PETSCII to screen codes.

Fixed 65C02 timing again.

Merge pull request #843 from polluks/patch-4

Fixed 65C02 timing.

Fixed 65C02 timing.

remove TABs

Fix typo

Adds test code for the Atari (xex) linker file format.

Adds documentation and a sample config file for the ATARI format.

Rewrites ATARI EXE segment writing to optimally write segment sizes.

We now expand segments as needed to write a minimal set of headers.

Don't support overwrite segments.

This simplifies the memory area size calculations.

Only write full ATARI XEX header in the first chunk.

Remove unused function.

Add support for Atari XEX file format to LD65

Fixed a note in "ca65.sgml".

String escapes are converted to a target platform's encoding.

add more clearly what rom stratoric contains

Use Timer2 for mouse polling.

This follows a suggestion by Sijmen Schouten in issue #818.
Platoterm64 now works with mouse at 1200 baud.

Bump MOUSE_API_VERSION in asminc/mouse-kernel.inc.

Fix typo in testcode/lib/mouse-test.c.

fix uppercase

fix comma in telestrat.sgml

fix doc/telestrat.sgml

fix uppercase command

Merge branch 'master' into master

Telemon variables added

Comment the ATASCII to screen code conversion.

Optimize the conversions from Atari ASCII to screen codes.

Merge pull request #829 from inexorabletash/string-escapes

ca65: Add string_escapes feature. Resolves #535

Cleaned up _pia.h register stuff a bit

Most documentation say that most of the bits are normally set to 1 or 0,
so just mentioning that in the comments.

A.N.A.L.O.G. issue 59 (April 1988) "Bits & Pieces" column, "Atari Zucchini"
(https://www.atarimagazines.com/analog/issue59/bits_pieces.php) implies
that they are used for specific things, but it's not clear enough to be
useful (or specifically states "Too complex and not pertinent").

This is probably sufficient for most purposes; if any PIA / PACTL/PBCTL
experts pop up, they can tell us exactly how those 4 bits can be utilized.

Atari colors into _gtia.h; NMIRES/NMIST as union

Use a C "union" to give both read (NMIST) and write (NMIRES) labels
to their shared register in ANTIC. (h/t @groessler).

Consolodate duplicated color definitions (HUE_..., COLOR_... and TGI_COLOR_...;
and the "_gtia_mkcolor()" macro), found in both "atari.h" and "atari5200.h",
moving it to "_gtia.h", which they both share (and which makes the most sense).

atari.h: Shadow registers for hardware registers

Comment adjustments; removed surperfluous keycodes

Cleaned up comments in Atari 8-bit headers.
Internal keycodes (POKEY's KBCODE) were already #defined in atari.h,
so didn't need a whole new set in _pokey.h.

Relocate register values outside structs, + more

Relocated register #define'd values outside of the structs,
improved comment format, expanded & corrected some things.

h/t Trevin Beattie (https://user.xmission.com/~trevin/) for the PIA
register descriptions.

Adjustments per most feedback on cc65 PR 831

(I appreciate the feedback!)

Some PIA register #defines

Some register #defines for PIA.

(Some may be too Atari-centric -- I know PIA chip was used by PET &
perhaps other platforms supported by cc65.  If so, perhaps we can
define them elsewhere.  Not sure whether they'd be the same for 5200;
I admit I know zilch about that system except that it's _more or less_
an Atari 400)

POKEY: Add register #defines & internal kybd codes

Add #defines for certain registers' values.
Also add #defines for internal keyboard codes (unrelated to ATASCII;
e.g. [Q] = 47, [W] = 46, [Shift] adds 64, etc), as seen in KBCODE.

Note about hues varying depending on environment

There aren't really standard color names (e.g., Compute!'s Mapping the Atari and First Book of Atari Graphics have different names), and exact colors shown depend on the system & device, anyway. Added a note.

Tweaks to description of ANTIC chip in _antic.h

Tweak to comments at the top

Added #defines for GTIA register values

Add more register #defines to ANTIC header file

 * DMACTL - playfield size, DMA access, PMG resolution
 * CHACTL - inverted text, inverse effects
 * NMIEN

Also, added #define equivalents for Display List mode line instructions
based on Atari 8-bit OS (aka Atari BASIC "GRAPHICS" command) values
(e.g., "DL_GRAPHICS0" == "DL_CHR40x8x1").

Added some more documentation in the comments.

Added macros with assembly language for the start/end of Display List
Interrupt (DLI) functions.

Changed most "backticks" (grave accents) into apostrophes.

Quotations that are embraced by tick marks now look better, in most fonts.

ca65: Add string_escapes feature. Resolves #535

Added an error message, in case there's a typo in the definitions of long command-line options.

Fixed a duplicate-label test.

Don't call strcmp() if either argument is NULL.

Added, to Plus4 and GEOS linker configure files, the ability to set the start and end addresses of the program region.

Merge pull request #828 from Marrin/marrin-docfix

Fixed documented return type.

Fixed documented return type.

fix for err blank line removal

Moved contents of SetNewMode doc

removed fastcall from SetNewMode

corrected text formatting

moved to better folder location

Issue 814

SetNewMode() documentation = issue #814

Added SetNewMode() to geoslib  - #814

change reference to $0200FF to $0200xx

remove redundant line

use pre-existing ZP storage. Make 32-bit pointer value loading more self-evident

add support for detecting 45GS02

Added missing external declaration of c64_65816_emd.

Now tgi_clear() works

Fixed typo.

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix. Whitespace cleanup

Added SER_ prefix

Changed prefix SWL_ to SER_

Updated to use cbm_kernal.inc. Whitespace cleanups