Permalink
Browse files

initial import docs, from epple2web subversion project

  • Loading branch information...
cmosher01 committed Apr 21, 2012
1 parent 392ec64 commit e5171df3d18521393a0d592f9b20237417e3ec45
Showing with 6,010 additions and 0 deletions.
  1. BIN doc/80x15.png
  2. +19 −0 doc/Makefile
  3. BIN doc/applesplit.png
  4. +128 −0 doc/building.asciidoc
  5. BIN doc/callouts/1.png
  6. BIN doc/callouts/10.png
  7. BIN doc/callouts/11.png
  8. BIN doc/callouts/12.png
  9. BIN doc/callouts/13.png
  10. BIN doc/callouts/14.png
  11. BIN doc/callouts/15.png
  12. BIN doc/callouts/2.png
  13. BIN doc/callouts/3.png
  14. BIN doc/callouts/4.png
  15. BIN doc/callouts/5.png
  16. BIN doc/callouts/6.png
  17. BIN doc/callouts/7.png
  18. BIN doc/callouts/8.png
  19. BIN doc/callouts/9.png
  20. +263 −0 doc/cards.asciidoc
  21. +188 −0 doc/cassette.asciidoc
  22. +202 −0 doc/commands.asciidoc
  23. +63 −0 doc/configuration.asciidoc
  24. BIN doc/debian.png
  25. BIN doc/deploy/80x15.png
  26. BIN doc/deploy/applesplit.png
  27. BIN doc/deploy/callouts/1.png
  28. BIN doc/deploy/callouts/10.png
  29. BIN doc/deploy/callouts/11.png
  30. BIN doc/deploy/callouts/12.png
  31. BIN doc/deploy/callouts/13.png
  32. BIN doc/deploy/callouts/14.png
  33. BIN doc/deploy/callouts/15.png
  34. BIN doc/deploy/callouts/2.png
  35. BIN doc/deploy/callouts/3.png
  36. BIN doc/deploy/callouts/4.png
  37. BIN doc/deploy/callouts/5.png
  38. BIN doc/deploy/callouts/6.png
  39. BIN doc/deploy/callouts/7.png
  40. BIN doc/deploy/callouts/8.png
  41. BIN doc/deploy/callouts/9.png
  42. BIN doc/deploy/debian.png
  43. BIN doc/deploy/dos310rev0.png
  44. BIN doc/deploy/dos330boot.png
  45. BIN doc/deploy/epple2logo.png
  46. BIN doc/deploy/gplv3logo.png
  47. +2,325 −0 doc/deploy/index.html
  48. BIN doc/deploy/make.png
  49. BIN doc/deploy/note.png
  50. BIN doc/deploy/pinkmystery.png
  51. BIN doc/deploy/prodos.png
  52. BIN doc/deploy/redhat.png
  53. BIN doc/deploy/splitcolors.png
  54. BIN doc/deploy/tip.png
  55. BIN doc/deploy/warning.png
  56. BIN doc/deploy/windows.gif
  57. +83 −0 doc/display.asciidoc
  58. BIN doc/dos310rev0.png
  59. BIN doc/dos330boot.png
  60. +75 −0 doc/download.asciidoc
  61. BIN doc/epple2logo.png
  62. BIN doc/gplv3logo.png
  63. +61 −0 doc/index.asciidoc
  64. +2,325 −0 doc/index.html
  65. +61 −0 doc/keyboard.asciidoc
  66. BIN doc/make.png
  67. BIN doc/note.png
  68. +6 −0 doc/overview.asciidoc
  69. +12 −0 doc/paddles.asciidoc
  70. BIN doc/pinkmystery.png
  71. BIN doc/prodos.png
  72. BIN doc/redhat.png
  73. +173 −0 doc/screenshots.asciidoc
  74. +9 −0 doc/speaker.asciidoc
  75. BIN doc/splitcolors.png
  76. BIN doc/tip.png
  77. +17 −0 doc/usermanual.asciidoc
  78. BIN doc/warning.png
  79. BIN doc/windows.gif
View
Binary file not shown.
View
@@ -0,0 +1,19 @@
+.SUFFIXES: .asciidoc .html
+
+.asciidoc.html :
+ asciidoc -b html5 $<
+
+all : doc
+
+doc : index.html
+
+clean :
+ rm -f index.html
+
+install :
+ mkdir -p deploy
+ cp *.html *.png *.gif deploy
+ cp -R callouts deploy
+
+uninstall :
+ rm -Rf deploy
View
Binary file not shown.
View
@@ -0,0 +1,128 @@
+== Building From Source
+
+
+
+The Epple ][ Emulator is written in C+\+, and can be built
+using the standard +make+ program.
+
+The primary dependency is
+http://www.libsdl.org/[Simple DirectMedia Layer] (SDL).
+Your linux distribution may provide a package. Or else
+you can download it directly from SDL's web site. In
+either case, be sure to install the ``Development Libraries''
+for your particular platform.
+
+
+
+=== Debian Linux Example
+
+[source,sh]
+---------------------------------------------------
+sudo apt-get install build-essential libsdl1.2-dev # <1>
+cd
+mkdir epple2
+cd epple2
+wget http://mosher.mine.nu/epple2/download/epple2-latest.tar.gz # <2>
+tar xzvf epple2-1.0.tar.gz
+mkdir build # <3>
+cd build
+../epple2-1.0/configure # <4>
+make # <5>
+sudo make install # <6>
+---------------------------------------------------
+<1> Install dependencies: gcc, make, SDL
+<2> Retrieve the latest Epple ][ source distribution
+<3> Use this directory for a VPATH-style build
+<4> Run one-time configuration script for your system. Use +--help+ for more information.
+<5> Compile and link. Program will be +src/epple2+
+<6> Install into standard system directories
+
+
+
+=== Windows/MSYS Example
+
+==== Install MinGW/MSYS
+
+Install MSYS into +C:\msys\+
+
+Install MinGW into +C:\msys\mingw\+
+
+For more information on MinGW and MSYS, see http://www.mingw.org/[].
+
+==== Install SDL
+
+At http://www.libsdl.org/[] find the download page.
+Download the ``Development Libraries'' for Win32/mingw, for example:
+
++SDL-devel-1.2.13-mingw32.tar.gz+ (Mingw32)
+
+and save it to your MSYS home directory (for example, +C:\msys\home\Administrator+).
+Run MSYS, and at the bash prompt, go to your home directory and
+untar the SDL archive to your home directory:
+
+[source,sh]
+--------
+$ cd
+$ tar xzvf SDL-devel-1.2.13-mingw32.tar.gz
+--------
+
+Then follow the instructions to install SDL, for example:
+
+[source,sh]
+--------
+$ cd SDL-1.2.13
+$ make native
+--------
+
+==== Untar Epple ][ Source
+
+Download the Epple ][ Source Distribution
+and save it to your MSYS home directory (for example, +C:\msys\home\Administrator+).
+Run MSYS, and at the bash prompt, go to your home directory and
+untar the epple2 source distribution tar file. For example:
+
+[source,sh]
+--------
+$ cd
+$ tar xzvf epple2-1.0.tar.gz
+--------
+
+==== Build Epple ][
+
+Then build as follows. I recommend doing a VPATH build,
+where you build into a different directory than the source
+directory. To accomplish this, create a new directory for
+building, somewhere, such as:
+
+[source,sh]
+--------
+$ cd
+$ mkdir buildepple2
+$ cd buildepple2
+--------
+
+Then run +configure+ from there. For the MSYS build to work,
+you need some extra parameters to the build, and you could
+also add some compiler options to optimize the build. For
+example (from the +buildepple2+ directory you just created):
+
+[source,sh]
+--------
+$ ~/epple2/configure --prefix= \
+CXXFLAGS="-I/usr/include -O4 -msse3" \
+CFLAGS="-I/usr/include" \
+LDFLAGS="-L/usr/lib -mconsole -mthreads -mno-cygwin"
+$ make
+--------
+
+If all goes well, it will build without any errors.
+If you get errors about not finding +SDL.h+, make sure
+SDL is installed, and make sure the configure command
+is correct. (If you just run configure without the
+options shown above, you will get this error at build time.)
+The result of the build (on Windows platform) is
+
++installer/epple2.msi+
+
+which is an installable file for Windows. To install
+epple2, just double-click on this file from Explorer.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
View
Binary file not shown.
Oops, something went wrong.

0 comments on commit e5171df

Please sign in to comment.