js-dos.com (api on top of em-dosbox), changes:

* add --memory-init-file 0 to linker flags
* add js-dos cmake project
* digger.test
* dosbox api
* nice ui
* fullscreen support
* zlib extraction
* Document some code
* Migrate to literate coffeescript
* Fix gulpfile.js (add task sequence)
* Add coffeelint task
* Add docco, fix documentation
* Fix dreamlayers#29
* enable EMTERPRETER

README.md

@@ -1,184 +1,25 @@
-DOSBox ported to Emscripten
-===========================
+# js-dos
 
-About
------
+The aim of the project is to provide nice web-API for em-dosbox.
 
-[DOSBox](http://www.dosbox.com/) is an open source DOS emulator designed for
-running old games. [Emscripten](https://github.com/kripken/emscripten)
-compiles C/C++ code to JavaScript. This is a version of DOSBox which can be
-compiled with Emscripten to run in a web browser. It allows running old DOS
-games and other DOS programs in a web browser.
+## How to build
 
-DOSBox is distributed under the GNU General Public License. See the
-[COPYING file](https://github.com/dreamlayers/em-dosbox/blob/em-dosbox-0.74/COPYING)
-for more information.
-
-Status
-------
-
-Em-DOSBox runs most games successfully in web browsers. Although DOSBox has
-not been fully re-structured for running as an Emscripten main loop, most
-functionality is available thanks to emterpreter sync. A few programs can
-still run into problems due to paging exceptions.
-
-Other issues
-------------
-
-* Game save files are written into the Emscripten file system, which is by
-  default an in-memory file system. Saved games will be lost when you close
-  the web page.
-* Compiling in Windows is not supported. The build process requires a
-  Unix-like environment due to use of GNU Autotools. See Emscripten
-  [issue 2208](https://github.com/kripken/emscripten/issues/2208).
-* Emscripten [issue 1909](https://github.com/kripken/emscripten/issues/1909)
-used to make large switch statements highly inefficient. It seems fixed now,
-but V8 JavaScript Engine [issue
-2275](http://code.google.com/p/v8/issues/detail?id=2275) prevents large switch
-statements from being optimized. Because of this, the simple, normal and
-prefetch cores are automatically transformed. Case
-statements for x86 instructions become functions, and an array of function
-pointers is used instead of the switch statements. The `--enable-funarray`
-configure option controls this and defaults to yes.
-* The same origin policy prevents access to data files when running via a
-file:// URL in some browsers. Use a web server such as
-`python -m SimpleHTTPServer` instead.
-* In Firefox, ensure that
-[dom.max\_script\_run\_time](http://kb.mozillazine.org/Dom.max_script_run_time)
- is set to a reasonable value that will allow you to regain control in case of
-a hang.
-* Firefox may use huge amounts of memory when starting asm.js builds which have
-not been minified.
-* The FPU code uses doubles and does not provide full 80 bit precision.
-DOSBox can only give full precision when running on an x86 CPU.
-
-Compiling
----------
-
-Use the latest stable version of Emscripten (from the master branch). For
-more information see the the
-[Emscripten installation instructions](https://kripken.github.io/emscripten-site/docs/getting_started/downloads.html).
-Em-DOSBox depends on bug fixes and new features found in recent versions of
-Emscripten. Some Linux distributions have packages with old versions, which
-should not be used.
-
-First, create `./configure` by running `./autogen.sh`. Then
-configure with `emconfigure ./configure` and build with `make`.
-This will create `src/dosbox.js` which contains DOSBox and `src/dosbox.html`,
-a web page for use as a template by the packager. These cannot be used as-is.
-You need to provide DOSBox with files to run and command line arguments for
-running them.
-
-This branch supports SDL 2 and uses it by default. Emscripten will
-automatically fetch SDL 2 from Emscripten Ports and build it. Use of `make -j`
-to speed up compilation by running multiple Emscripten processes in parallel
-[may break this](https://github.com/kripken/emscripten/issues/3033).
-Once SDL 2 has been built by Emscripten, you can use `make -j`.
-To use a different pre-built copy of Emscripten SDL 2, specify a path as in
-`emconfigure ./configure --with-sdl2=/path/to/SDL-emscripten`. To use SDL 1,
-give a `--with-sdl2=no` or `--without-sdl2` argument to `./configure`.
-
-Emscripten emterpreter sync is used by default. This enables more DOSBox
-features to work, but requires an Emscripten version after 1.29.4 and may
-cause a small performance penalty. To disable use of emterpreter sync,
-add the `--disable-sync` argument to `./configure`. When sync is used,
-the Emscripten
-[memory initialization file](https://kripken.github.io/emscripten-site/docs/optimizing/Optimizing-Code.html#memory-initialization)
-is enabled, which means `dosbox.html.mem` needs to be in the same folder as
-`dosbox.js`. The memory initialization file is large. Serve it in compressed
-format to save bandwidth.
-
-WebAssembly
------------
-
-[WebAssembly](https://github.com/kripken/emscripten/wiki/WebAssembly) is a
-binary format which is meant to be a more efficient replacement for asm.js.
-To build to WebAssembly instead of asm.js, the `-s WASM=1` option needs to
-be added to the final `emcc` link command. There is no need to rebuild the
-object files. You can do this using the `--enable-wasm` option when running
-`./configure`. Since WebAssembly is still under very active development, use
-the latest incoming Emscripten and browser development builds like
-[Firefox Nightly](https://nightly.mozilla.org/) and
-[Chrome Canary](https://www.google.com/chrome/browser/canary.html).
-
-Building with WebAssembly changes the dosbox.html file. Files packaged
-using a dosbox.html without WebAssembly will not work with a WebAssembly
-build.
-
-Running DOS Programs
---------------------
-
-To run DOS programs, you need to provide a suitable web page, load files into
-the Emscripten file system, and give command line arguments to DOSBox. The
-simplest method is by using the included packager tools.
-
-The normal packager tool is `src/packager.py`, which runs the Emscripten
-packager. It requires `dosbox.html`, which is created when building Em-DOSBox.
-If you do not have Emscripten installed, you need to use `src/repackager.py`
-instead. Any packager or repackager HTML output file can be used as a template
-for the repackager. Name it `template.html` and put it in the same directory
-as `repackager.py`.
-
-The following instructions assume use of the normal packager. If using
-repackager, replace `packager.py` with `repackager.py`. You need
-[Python 2](https://www.python.org/downloads/) to run either packager.
-
-If you have a single DOS executable such as `Gwbasic.exe`, place
-it in the same `src` directory as `packager.py` and package it using:
-
-```./packager.py gwbasic Gwbasic.exe```
-
-This creates `gwbasic.html` and `gwbasic.data`. Placing those in the same
-directory as `dosbox.js` and viewing `gwbasic.html` will run the program in a
-web browser:
-
-Some browsers have a same origin policy that prevents access to the required
-data files while using `file://` URLs. To get around this you can use Python's
-built in Really Simple HTTP Server and point the browser to
-[http://localhost:8000](http://localhost:8000).
-
-```python -m SimpleHTTPServer 8000```
-
-If you need to package a collection of DOS files. Place all the files in a
-single directory and package that directory with the executable specified. For
-example, if Major Stryker's files are in the subdirectory `src/major_stryker`
-and it's launched using `STRYKER.EXE` you would package it using:
-
-```./packager.py stryker major_stryker STRYKER.EXE```
-
-Again, place the created `stryker.html` and `stryker.data` files in the same
-directory as `dosbox.js` and view `stryker.html` to run the game in browser.
-
-You can also include a [DOSBox
-configuration](http://www.dosbox.com/wiki/Dosbox.conf) file that will be
-acknowledged by the emulator to modify any speed, audio or graphic settings.
-Simply include a `dosbox.conf` text file in the package directory before you
-run `./packager.py`.
-
-To attempt to run Major Stryker in CGA graphics mode, you would create the
-configuration file `/src/major_stryker/dosbox.conf` and include this body of
-text:
+Follow to the guide: https://github.com/dreamlayers/em-dosbox/#compiling to build em-dosbox, and then:
 
 ```
-[dosbox]
-machine=cga
+cd js-dos
+mkdir build
+cd build
+./emcmake cmake ../api
+make -j4
 ```
 
-Then package it using:
+## Building api
 
-```./packager.py stryker-cga major_stryker STRYKER.EXE```
-
-Credits
--------
+```
+cd js-dos/api
+npm install gulp gulp-coffee gulp-concat gulp-coffeelint gulp-docco run-sequence
+gulp
+```
 
-Most of the credit belongs to the
-[DOSBox crew](http://www.dosbox.com/crew.php).
-They created DOSBox and made it compatible with a wide variety of DOS games.
-[Ismail Khatib](https://github.com/CeRiAl) got DOSBox
-to compile with Emscripten, but didn't get it to work.
-[Boris Gjenero](https://github.com/dreamlayers)
-started with that and got it to work. Then, Boris re-implemented
-Ismail's changes a cleaner way, fixed issues and improved performance to make
-many games usable in web browsers. Meanwhile,
-[Alon Zakai](https://github.com/kripken/) quickly fixed Emscripten bugs which
-were encountered and added helpful Emscripten features.
+Built will be in js-dos/api/dist folder, use test.html as example.

js-dos/3rd-party/libzip-0.11.2/API-CHANGES

@@ -0,0 +1,118 @@
+* libzip API changes
+
+This file describes changes in the libzip API and how to adapt your
+code for them.
+
+You can define ZIP_DISABLE_DEPRECATED before including <zip.h> to hide
+prototypes for deprecated functions, to find out about functions that
+might be removed at some point.
+
+* 0.11
+
+** new type zip_flags_t
+
+The functions which have flags now use the zip_flags_t type for this.
+All old flags fit; you need code only to adapt if you were saving flags in a
+local variable. Use zip_flags_t for such a variable.
+This affects:
+zip_fopen()
+zip_fopen_encrypted()
+zip_fopen_index()
+zip_fopen_index_encrypted()
+zip_get_archive_comment()
+zip_get_archive_flag()
+zip_get_num_entries()
+zip_get_name()
+zip_name_locate()
+zip_set_archive_flag()
+zip_source_zip()
+zip_stat()
+zip_stat_index()
+
+*** ZIP_FL_*, ZIP_AFL_*, ZIP_STAT_* are now unsigned constants
+
+To match the new zip_flags_t type.
+
+*** zip_add(), zip_add_dir()
+
+These functions were replaced with zip_file_add() and zip_dir_add(), respectively,
+to add a flags argument.
+
+*** zip_rename(), zip_replace()
+
+These functions were replaced with zip_file_rename() and zip_file_replace(),
+respectively, to add a flags argument.
+
+*** zip_get_file_comment()
+
+This function was replaced with zip_file_get_comment(); one argument was promoted from
+int to zip_uint32_t, the other is now a zip_flags_t.
+
+*** zip_set_file_comment()
+
+This function was replaced with zip_file_set_comment(); an argument was promoted from
+int to zip_uint16_t, and a zip_flags_t argument was added.
+
+** integer type size changes
+
+Some argument and return values were not the right size or sign.
+
+*** zip_name_locate()
+
+The return value was int, which can be too small. The function now returns zip_int64_t.
+
+
+*** zip_get_num_entries()
+
+The return type is now signed, to allow signaling errors.
+
+*** zip_set_archive_comment()
+
+The last argument changed from int to zip_uint16_t.
+
+** extra field handling rewritten
+
+The zip_get_file_extra() and zip_set_file_extra() functions were removed.
+They only worked on the whole extra field set.
+
+Instead, you can now set, get, count, and delete each extra field separately,
+using the functions:
+zip_file_extra_field_delete()
+zip_file_extra_field_delete_by_id()
+zip_file_extra_field_get()
+zip_file_extra_field_get_by_id()
+zip_file_extra_fields_count()
+zip_file_extra_fields_count_by_id()
+zip_file_extra_field_set()
+Please read the corresponding man pages for details.
+
+** new functions
+
+*** zip_discard()
+
+The new zip_discard() function closes an archive without committing the
+scheduled changes.
+
+*** zip_set_file_compression()
+
+The new zip_set_file_compression() function allows setting compression
+levels for files.
+
+** argument changes
+
+*** file names
+
+File names arguments are now allowed to be NULL to have an empty file name.
+This mostly affects zip_file_add(), zip_dir_add(), and zip_file_rename().
+
+For zip_get_name(), zip_file_get_comment(), and zip_get_archive_comment(), if
+the file name or comment is empty, a string of length 0 is returned.
+NULL is returned for errors only.
+
+Previously, NULL was returned for empty/unset file names and comments and
+errors, leaving no way to differentiate between the two.
+
+/* Local Variables:  */
+/* mode: org         */
+/* End:              */
+

js-dos/3rd-party/libzip-0.11.2/AUTHORS

@@ -0,0 +1,2 @@
+Dieter Baron <[email protected]>
+Thomas Klausner <[email protected]>