Updated the function reference document.

* Added doesclrscrafterexit() to cc65.h's list.
* Added header-file function lists for some new target platforms.

Merge pull request #307 from groessler/something_to_pull2

Add Atari version of of doesclrscrafterexit().

Use 'return0' for default 'doesclrscrafterexit()' implementation in libsrc/common.
Fix include/atari.h formatting.

fix wrong header reference in doesclrscrafterexit() description

Add issues from pull request #307.

Merge pull request #306 from groessler/something_to_pull

Some Atari runtime library fixes.

Add Atari version of of doesclrscrafterexit().

- Update documentation.
- Update atari.h and apple2.h header files.
- Adapt Atari test/target programs.
- Fix a typo in "div" entry in funcref.sgml.

Some Atari runtime library fixes.

* libsrc/atari/ucase_fn.s: Fix handling if input parameter 'tmp2' is 0.
* libsrc/atari/open.s: Set 'tmp2' parameter for 'ucase_fn' if DEFAULT_DEVICE
  is not defined.

Introduced internal gotoxy that pops both parameters.

About all CONIO functions offering a <...>xy variant call
  popa
  _gotoxy

By providing an internal gotoxy variant that starts with a popa all those CONIO function can be shortened by 3 bytes. As soon as program calls more than one CONIO function this means an overall code size reduction.

Added Apple II version of doesclrscrafterexit().

The prototype and documentation is supposed to be provided together with the ATARI version.

Added full stop.

Added chrcvt65 to the Visual Studio project.

Added --print-target-path option.

If cc65 is installed and used as designed there's no need whatsoever for CC65_HOME (both on *IX and Windows) from the perspective of the cc65 binaries. If the user however has to access files from the 'target' directory thenhe ends up with some assumption on the cc65 installation path nevertheless :-(

In order to avoid this I added the --print-target-path option. It "exports" the logic used by the cc65 binaries to locate their files to the user thus allowing him to leverage the same logic to locate the target files in his build scripts / Makefiles.

Write overlays to d64 image.

Harmonized goal name.

Allow usage of C1541 environment variable.

Removed shell for-loop.

Just a few of the many reasons why shell for-loops have no place in (GNUmake) Makefiles:
* They don't conform to https://www.gnu.org/software/make/manual/html_node/Utilities-in-Makefiles.html
* They break Windows builds for sure
* They don't fit to make's approach of working with sets
* They break make parallelism

Don't cleanup files "just in case".

The build doesn't create *.lbl files so we're not deleting *.lbl files.

Don't hide build commands.

The samples Makefile serves educational purposes. From that perspective it's counterproductive to hide the actual build commands. Apart fom that it becomes visible if an installed cc65 is used to build the samples.

Corrected cleanup semantics.

There's no zap goal in cc65 Makefiles.

Don't ignore more than necessary.

We know that the one and only cc65.zip we want to ignore lives in the root directory.

Fixed clean goal on Windows.

Now that the clean goal of the samples Makefile is part of the global clean goal it should work on Windows!

BTW: Ideally the whole samples Makefile should work on Windows ;-))

Adjusted to the cc65 Makefile style.

The cc65 Makefiles have a single .PHONY target. It serves as an overview of the "interesting" goals supported by the Makfile.

Removed tab characters.

The cc65 code base uses tab character only for make recipes.

Don'r presume that the C64 is the only target.

Other targets have disks too and if at some point some one is interested enough to add support for disk creation for other targets too then 'disk' is no good goal name for a C64 disk.

Don't fiddle with foreign files.

No cc65 tool creates *~ files so we don't cleanup *~ files. If some other tool (like an editor) creates *~ files it's up to the user - and only him - to decide when those files are to be deleted !

Merge pull request #305 from silverdr/target_goodies

corrected samples and samples.d64 targets

corrected all samples and samples.d64 targets

Merge pull request #287 from silverdr/target_goodies

moved output of target utils and drivers to separate directory

Merge pull request #303 from groessler/something_to_pull

Atari: get current drive on XDOS

Atari, getdefdev.s: use mnemonics for 'crvec'.

Merge pull request #304 from groessler/something_to_pull2

w2cas: use atexit() to wait for key press at program ternination.

Use atexit() to wait for key press at program ternination.

Idea by polluks.

Atari: make __getdefdev function ROM-friendly

Atari: get current drive on XDOS

samples zip and install targets moved into samples/Makefile as agreed

Minor adjustment to recent change.

Merge pull request #302 from groessler/something_to_pull

Small optimization in apple2 exec.s.

Small optimization in apple2 exec.s.

Indenting optimised

Post-review changes

Merge pull request #300 from clbr/ld65

ld65: Be more verbose in token errors

ld65: Be more verbose in token errors

Merge pull request #297 from groessler/something_to_pull

Atari: add new function '_is_cmdline_dos()' and some other small changes

Merge pull request #294 from greg-king5/standard-functions

Make a small optimization to some library functions' inlined versions.

Merge pull request #298 from groessler/something_to_pull2

make BSS segment optional in atari-cassette.cfg

make BSS segment optional in atari-cassette.cfg

forgot to add the new file atari/is_cmdline_dos.s in my last commit...

Atari: add new function '_is_cmdline_dos()' and some other small changes.

- use this function instead of directly looking at _dos_type in the included
  targetutil and test programs
- fixes/improvements to the Atari runtime library regarding the recently
  changed _dos_type values
- libsrc/atari/targetutil/w2cas.c: exit if no filename was entered
- add documentation for the new function

Small optimization of some cc65-generated loops.

"bne" means also branch-on-not-zero.  Therefore, this optimization doesn't put a compare-to-zero between an increment and a "bne".

Merge pull request #295 from groessler/something_to_pull

Atari: add command line support for XDOS

Fix style issue.

atari.h: update _dos_type values

add support for XDOS command lines

atari.inc: add XDOS defines and remove trailing whitespace

docs for targets with target utilities adjusted

removed variable usage

ignoring zip target output

adapted for zip/install targets

Ignores adjusted

directory structure changed from driver-centric to target-centric

Merge pull request #289 from OzHawk/patch-1

Update the missing entries in the kernel jump table for the Vic20 wit…

Update kernal.s

moved output of target utils and drivers to separate directory

Update the missing entries in the kernel jump table for the Vic20 with the actual function addresses.

The Vic20 does not have kernal table entries for the following functions.

;-----------------------------------------------------------------------------
; Functions which are not in the kernal jump table for VIC-20 but are for C64

CINT        := $E518
IOINIT      := $FDF9
RAMTAS      := $FD8D

All other kernal entries are the same as the C64, however, without this change, the startup code fails.

Without this change the vic20.lib builds incorrectly.

Merge pull request #285 from greg-king5/asm-volatile

Add the C keyword "volatile" to the __asm__ statement grammar.

Added the optional C keyword "volatile" to the __asm__ statement grammar.

It prevents the statement's Assembly code from being optimized (e.g., moved or removed).  Optimization is disabled for that statement's entire function (other functions aren't affected).

Merge pull request #283 from polluks/sp65

Fixed CPU definition of Lynx.

Fixed CPU definition of Lynx. Removed nonsense target vc20.

Merge pull request #281 from polluks/sp65

sp65: A forgotten option. Empty arguments are not silent anymore.

A forgotten option. Empty arguments are not silent anymore.

Merge pull request #280 from greg-king5/misaligned

Show a warning message about misaligned segments, for all badly-aligned segments.

Moved a warning message, about misaligned segments, to a configuration function.

It used to be shown only if the segment was written into a binary file.  Now, it's shown for all badly-aligned segments.

Renamed chrcvt to chrcvt65 and added it to the build.

The /Makefile presumes that all binaries are are named *65 so chrcvt had to be renamed in order to be added to the build.

Updated Protovision Shop URL.

Use .macpack to include macro package.

Made use of recently added Apple scrcode macro.

Added scrcode macro for the Apple II.

Although the Apple II generally works with plain ASCII (i.e. in the ProDOS 8 MLI) the actual screen codes differ. This fixes #260.

Merge pull request #279 from greg-king5/atmos-reconfig

Convert the Atmos configuration to the new constructor segment model.

Allow _sys() to call ROM routines.

_sys() is supposed to be (primarily) intended to call ROM routines. Leveraging the "file overlay" mechanism of the cc65 build system allows to provide a Apple II specific _sys() implementation that temporarily switches in the ROM.

Minor fixes for recent doc change.

Updated documentation to reflect the current linker configs.

Converted the Atmos configuration to the new constructor segment model.

Harmonized asm linker configs.

- All segments but CODE are optional and CODE is R/W. Both together allow to "just" write code/data without ever explicitly using a segment.

- Symbols are defined for the BSS. This allows to use/implement zerobss.

- The ZP memory area isn't artificially limited.

Consider the segment attributes 'define' and 'optional' mutually exclusive.

In normal situations it isn't too useful to define symbols for optional segments as those symbols can't be presumed to be always present.

I in fact suspect that most currently present combinations of 'define' and 'optional' aren't useful - apart form the overlay configurations of course.

Moved run location of ONCE segment.

Make the same changes to the Apple II that were done with https://github.com/cc65/cc65/commit/0ee9b2e446198746c3a05b142ecd00784becf727 to the C64.

Notes:
- The startup code deliberately doesn't make use of symbols defined for the LC segment as that segment is optional.
- The <...>-asm.cfg configs move the segment BSS to an own memory area BSS although this doesn't seem necessary. However the benefit is that the size of the memeory area MAIN is identical to the number of bytes loaded from disk into RAM. To keep this an invariant for all Apple II configs allows to simplify the EXEHDR to just refer to the symbols defined for MAIN.

Adjusted constructors.

The constructors are _NOT_ allowed anymore to access the BSS. Rather they must use the DATA segment or the INIT segment. The latter isn't cleared at any point so the constructors may use it to expose values to the main program. However they must make sure to always write the values as they are not pre-initialized.

Adjust linker config to match startup code.

Apply https://github.com/cc65/cc65/commit/aaf90c1252a09346deb1ccdab96546368afdbbdd to the Supervision default configuration.

Fixed segment properties.

The CBMx10 targets don't use the INIT segment in the startup code. So it may turn out to be not necessary at all for certain programs.

The CBMx10 targets don't need symbols for the ONCE segment. Likely their definition was a C&P error in the first place.

Moved things into ONCE.

Code and or data used only during initialization belongs into the ONCE segment.

Removed symbol definition for ONCE.

Almost all targets don't need symbols for the ONCE segment. Likely their definition was a C&P error in the first place.

Removed ONCE segment.

Pure assembler programs don't have constructors. Therefore constructor code ending up in an assembler program should trigger an error.

Fixed INIT properties.

The main chunk load header references __BSS_LOAD__ so BSS must be the first bss type segment. Subsequent changes will move ONCE to share its address with the BSS. Then it'll be necessary to load INIT from disk. Therefore we do it right now.

Fixed BSS properties.

The cassette boot file header references __BSS_RUN__ so BSS must be the first bss type segment (and for sure isn't optional).

Use AX paradigm.

Cleaned up C64 linker configs.

The BSS segment and the ONCE segment share the same start address. So they need to be placed in two different memory areas.

So far BSS was placed in the MAIN memory area and ONCE was placed in an additional memory area. Both memory areas were written to the output file. They just "happened" to be loadable and runnable at a stretch.

Now ONCE is placed in the MAIN memory area and BSS is placed in an additional memory area. Only MAIN is written to the output file. It becomes more obvious that BSS is "just" defined to share memory with ONCE.

Don't presume the stack size to be a multiple of pages.

Merge pull request #274 from bbbradsmith/doc-cc65-intern

New documentation: cc65-intern.sgml

Use AX paradigm for stack initalization.

Renamed RAM to MAIN for all disk based targets.

The name RAM doesn't make much sense in general for a memeory area because i.e. the zero page is for sure RAM but is not part of the memory area named RAM.

For disk based targets it makes sense to put the disk file more into focus and here MAIN means the main part of the file - in contrast to some header.

Only for ROM based targets the name RAM is kept as it makes sense to focus on the difference between RAM and ROM.