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.

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

Moved kernal entries to cbm_kernal.inc

Updated Visual Studio solution files to VS 2017.

atari.sgml: use consistent naming for realtime clock.

Some documentation fixes

- gamate.sgml: remove empty section "Hardware access"
- telestrat.sgml: remove wrong "<descrip>" tags

atari.sgml: fix typo

atari.sgml: Add documentation for Atari clock_... functions implementation.

Replaced systime() with clock_gettime().

Fixed reference to clock_settime().

Fixed typo.

Added target docs on the clock_... functions.

Fixed two typos.

Code review aftermath 2: Put defines into parentheses

Adaptations due to code review.

Support for self explanatory KBCODE values

Added VIC control register names

Fix duplicated variables

Stratsed vectors added

Some variables from TELEMON 2.4 added

Saved 2 bytes and fixed error in case of negative result.

Made div-test.c use doesclrscrafterexit().

It no longer waits for a key tap if it doesn't need to do that.

Also, normalized the source code formatting.

Added basic docs on the clock_... functions.

Updated URLs.

Adjusted comments to match actual prototypes.

Add definitions in telestrat.inc (TELEMON 2.4)

Fixed the Plus4's serial driver's ACIA address.

.byt "" emits no data; avoid a ca65 crash.

Fixes #775 on GitHub.

Fix comments and TELEMON uppercase

Correct grab default value

update ld65.sgml with telestrat target

By default, we get the memory reserved for hires mode

Clean wherey.s

Cleaning telestrat.cfg (no need to have bashead segment). Some primitives added

Remove BASHEAD segment which is not useful

'--no-std-lib' was renamed to '--no-target-lib'

Don't output a warning about alignment when section address is defined by START or OFFSET and fits required alignment requirements

Adjusted library name.

Renamed to '--no-std-lib'

Renamed to '--no-crt-lib'

CL65: --no-rtl option for disabling default runtime library

ca65.sgml fails to document z: a: f: address size override prefixes.

Post-review tweaks.

Typo

Even more optimization, cleanup, bugfix, comments.

Stack adjustment code optimizations.

Formatting tweaks.

Testcase added.

Fix for issue #735

Changed a comment and an error message into more specific text.

Fix crash due to mistaken symbol identity.

Merged pull request #771 from DankRank/master.

da65: properly scan empty strings in info file.

da65: properly scan empty strings

Previously, doing something like `LABEL { NAME ""; ADDR $1000; };` would
result in $1000 being labeled as NAME: instead of being unnamed.

Always put goto stack-adjustments in the RODATA segment.

Minor style adjustment.

Testcase .ref updated for new warning style.

Formatting fixes.

Fix non-goto jumps (i.e. inline assembly).