sync asap codec to ASAP 2.1

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@24511 a1c6a512-1295-4272-9138-f99709370657

1 files changed, 138 insertions, 55 deletions

diff --git a/apps/codecs/libasap/README b/apps/codecs/libasap/README
index d43a872b25..4da0aa7b90 100644
--- a/apps/codecs/libasap/README
+++ b/apps/codecs/libasap/README
@@ -1,59 +1,142 @@
 ASAP - Another Slight Atari Player
-----------------------------------
+==================================
 
-ASAP is a player of Atari 8-bit music for modern computers.
-It emulates the POKEY sound chip and the 6502 processor.
-The project was initially based on the routines from the Atari800 emulator,
+// This file is in AsciiDoc format. It is converted to README.html.
+:Compact-Option:
+
+ifdef::asapwww[]
+http://sourceforge.net/projects/asap/files/asap/[Download] |
+http://asap.git.sourceforge.net/git/gitweb.cgi?p=asap/asap;a=summary[Browse source code (Git)] |
+http://sourceforge.net/scm/?type=git&group_id=154391[Get latest source code (Git)] |
+http://sourceforge.net/projects/asap/[SourceForge project page]
+endif::asapwww[]
+
+ASAP is a player of http://en.wikipedia.org/wiki/Atari_8-bit_family[8-bit Atari]
+music for modern computers.
+It emulates the http://en.wikipedia.org/wiki/POKEY[POKEY sound chip]
+and the http://en.wikipedia.org/wiki/6502[6502 processor].
+The project was initially based on the routines from the
+http://atari800.sourceforge.net/[Atari800 emulator],
 but the current version has a completely new original emulation core.
 
-The ASAP project includes the following programs:
-* ASAP2WAV - portable command-line utility that generates WAV files
-* WASAP - tiny player for Windows
-* plugin for Apollo
-* plugin for foobar2000 0.9
-* plugin for GSPlayer
-* plugin for MOC
-* plugin for Winamp
-* plugin for XMMS
-* DirectShow source filter (for Windows Media Player)
-* Java version of ASAP2WAV
-* Java applet
-* Java midlet
-* C# version of ASAP2WAV
-
-The following input formats are supported:
-* SAP (Slight Atari Player - standard file format for playing Atari 8-bit
-  music on modern computers)
-* CMC (Chaos Music Composer)
-* CMR (CMC Rzog)
-* DMC (DoublePlay CMC)
-* MPT (Music ProTracker)
-* MPD (MPT DoublePlay)
-* RMT (Raster Music Tracker)
-* TMC, TM8 (Theta Music Composer 1.x)
-* TM2 (Theta Music Composer 2.x)
-
-If you are looking for Atari 8-bit music, there is a single big collection
-of it called Atari SAP Music Archive (http://asma.atari.org).
-
-If you are interested in the ASAP project, please subscribe its mailing list:
-https://lists.sourceforge.net/lists/listinfo/asap-users
-As in the Atari800 project, this is a combined list for end users
-and for developers. Once you subscribe, you can post comments, ideas
-and questions about ASAP. They will be answered ASAP. ;-)
-
-If, for some reason, you do not want to subscribe the mailing list,
-but have a bug report, feature request or a small code patch, you can use
-the sf.net tracker. Use "Bugs", "Feature Requests" or "Patches" link
-on this page:
-http://sourceforge.net/projects/asap/
-
-ASAP is free software; you can redistribute it and/or modify it
-under the terms of the GNU General Public License as published
-by the Free Software Foundation; either version 2 of the License,
-or (at your option) any later version.
-
-ASAP is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty
-of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-See the included GNU General Public License for more details.
+ASAP includes the following programs:
+
+- asapconv - portable command-line converter {asapwin=}
+- WASAP - tiny player for Windows {asapwin=}
+- plugin for http://koti.welho.com/hylinen/apollo/[Apollo] {asapwin=}
+- plugin for http://foobar2000.org/[foobar2000] {asapwin=}
+- plugin for http://hp.vector.co.jp/authors/VA032810/[GSPlayer] {asapwin=}{asapwince=}
+- plugin for http://moc.daper.net/[MOC]
+- plugin for http://www.winamp.com/[Winamp] {asapwin=}
+- plugin for http://www.microsoft.com/windows/windowsmedia/player/[Windows Media Player] {asapwin=}
+- plugin for http://xbmc.org/[XBMC] {asapwin=}
+- plugin for http://xmms.org/[XMMS]
+- plugin for http://www.un4seen.com/[XMPlay] {asapwin=}
+- POKEY sound emulation DLL for http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker] {asapwin=}
+- Java version of ASAP2WAV - command-line converter to WAV files {asapjava=}
+- Java applet - for web pages {asapjava=}{asapwww?(see link:applet.html[online demo])}
+- Java midlet - for mobile devices {asapjava=}
+- C# version of ASAP2WAV
+- experimental JScript version of ASAP2WAV running in Windows Script Host {asapjavascript=}
+- experimental JavaScript version of ASAP2WAV running in Firefox {asapjavascript=}
+- Flash player - for web pages {asapflash=}{asapwww?(see link:flash.html[online demo])}
+
+{asapports}The summary of the differences between the above versions is in link:PORTS.xml[this table].
+
+There are other projects which use ASAP:
+
+- http://mmsap.sourceforge.net/[mmSAP 2] - standalone player for GNU/Linux with GTK+ user interface
+- http://www.rockbox.org/[Rockbox] - open source firmware for MP3 players
+
+
+Input file formats
+------------------
+
+ASAP supports the following file formats (determined by the filename extension):
+
+SAP (Slight Atari Player)::
+The format designed for playing 8-bit Atari music on modern computers.
+All other formats can be converted to SAP.
+http://asma.atari.org/[Atari SAP Music Archive (ASMA)]
+is a single big collection of SAP files.
+
+CMC (Chaos Music Composer)::
+Atari music editor from early 1990s.
+
+CM3 (CMC "3/4")::
+CMC with modified pattern length.
+
+CMR (CMC "Rzog")::
+CMC with modified bass sounds.
+
+CMS (Stereo Double CMC)::
+Stereo CMC.
+
+DMC (DoublePlay CMC)::
+CMC with 6502 routine executed at double rate of the original CMC.
+
+DLT (Delta Music Composer)::
+Atari music editor from 1990s.
+
+MPT (Music ProTracker)::
+Atari music editor from 1990s.
+
+MPD (MPT DoublePlay)::
+MPT with 6502 routine executed at double rate of the original MPT.
+
+RMT (http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker])::
+Modern Atari music editor running on Windows.
+
+TMC, TM8 (http://jaskier.atari8.info/[Theta Music Composer] 1.x)::
+Atari music editor from late 1990s.
+The two file extensions are treated identically and played in stereo.
+TM8 means it's stereo (8-channel) music while TMC can be either mono or stereo.
+
+TM2 (http://jaskier.atari8.info/[Theta Music Composer] 2.x)::
+Modern Atari music editor.
+
+
+ifdef::asapsrc[]
+include::INSTALL[]
+endif::asapsrc[]
+
+ifdef::asapflash[]
+include::flash/USAGE[]
+endif::asapflash[]
+
+ifdef::asapjava[]
+include::java/USAGE[]
+endif::asapjava[]
+
+ifdef::asapjavascript[]
+include::javascript/USAGE[]
+endif::asapjavascript[]
+
+ifdef::asapwin[]
+include::win32/USAGE[]
+endif::asapwin[]
+
+ifdef::asapwince[]
+include::gsplayer/USAGE[]
+endif::asapwince[]
+
+include::NEWS[]
+
+include::CREDITS[]
+
+
+Feedback
+--------
+
+If you are interested in the ASAP project, please subscribe its
+https://lists.sourceforge.net/lists/listinfo/asap-users[mailing list].
+This list is for users and developers.
+Once you subscribe, you can post comments, ideas and questions about ASAP.
+They will be answered ASAP. ;-)
+
+Use http://sourceforge.net/tracker/?group_id=154391[tracker]
+to submit bug reports, feature requests and small code patches.
+
+ifdef::asapwww[]
+image::http://sflogo.sourceforge.net/sflogo.php?group_id=154391&type=13["Get ASAP - Another Slight Atari Player at SourceForge.net. Fast, secure and Free Open Source software downloads",width=120,height=30,link="http://sourceforge.net/projects/asap/"]
+endif::asapwww[]