git @ Cat's Eye Technologies linapple / 637f287
Merge pull request #15 from maxolasersquad/install Unify and clean up INSTALL files. Joseph Carter authored 3 years ago GitHub committed 3 years ago
2 changed file(s) with 31 addition(s) and 187 deletion(s). Raw diff Collapse all Expand all
+0
-84
INSTALL less more
0 Linapple - crossplatfom emulator of Apple ][ (Apple2, Apple 2e) series computer for Linux or other OSes with SDL support.
1
2 [INSTALL]
3
4 You need SDL, cURL, zlib and libzip libraries development versions with -dev or -devel suffixes.
5
6 For Debian/Ubuntu their names are:
7 libsdl1.2-dev - Simple Direct Media crossplatform library for video,audio, events etc.
8 libcurl4 - openssl-dev - cURL net functions
9 zlib1g-dev - access .gz files
10 libzip-dev - access .zip files
11
12 All these libraries are available for free around the world.
13
14 For example for Debian/Ubuntu to install:
15 $ sudo apt-get install libsdl1.2-dev libcurl4-openssl-dev zlib1g-dev libzip-dev
16
17 After being SDL, zlib, cURL and libzip installed you will be able to compile linapple from sources:
18
19 Untar the package (in .bz2 format):
20 $ tar xjf linapple_src-2b.tar.bz2
21
22 Then go to src directory and compile.
23 $ cd linapple_src-2b/src
24 $ make
25
26 If there are no errors, you may install it if you wish:
27 $ sudo make install
28
29 It will be installed in /usr/local/linapple folder, whre you can find linapple.conf file for changing some linapple settings,
30 and empty `images` and `ftp` folders, where Apple 2 images files and downloaded through FTP cached images are meant to be in.
31
32 Of course you are free to choose any directories of your choice changing it in Makefile in src directory.
33 Note: you should read/write permissions for these folders, or linapple could not work properly.
34
35 For linaaple ability to unpack .zip and .gz files on the fly (either from local disks or from FTP) you also need read/write access for linapple working folder (which by default is /usr/local/linapple), for linapple unpacks these files as drive0.dsk and drive1.dsk for drive 1 and 2 respectively.
36
37 OK. If you installed it, you are able to run emulator from any place, just run it like this:
38 $ linapple
39
40 If you have chosen not to install it, go to the upper directory then and run the beast:
41 $ cd ..
42 $ ./linapple
43
44 If all files are on their places, you should see an X-Window with splash screen.
45 Press F2 (or F3 before to choose some disk image in drive 1), and go to work.
46
47 Note: linapple needs some files in its current working directory for proper working.
48
49 These files are:
50 splash.bmp - splash screen
51 charset40.bmp - charset for Apple][ (Apple 2e, etc.) text modes.
52 font.bmp - font for Help screen and Disk Select screens.
53 icon.bmp - nice icon, logo of Apple][ computer.
54 linapple.conf - configuration file.
55 Master.dsk - disk image with Applesoft(tm) DOS 3.3 inside. See Apple license (on apple.com) for details.
56
57 Essential are font.bmp and charset40.bmp, others can be omitted peacefully.
58
59 P.S. You may play with some options in Makefile in src directory, if you know what you want to do.
60
61 Note: See README file for more detailed instructions on using linapple.
62
63 [UNINSTALL]
64
65 To uninstall previously installed linapple (by `sudo make install` command) you may write this:
66 $ sudo make uninstall
67
68 This will remove by default entire `/usr/local/linapple` folder and `/usr/local/bin/linapple` script.
69
70 Also there is possible command for cleaning compiled binaries in src directory:
71 $ make clean
72
73 Note: `linapple` executable in upper directory will remain intact.
74
75 [CONTACT]
76
77 I will be glad to see your comments, suggestions and so on on my email beotiger@gmail.com
78
79 Sincerely Yours,
80 beotiger, December 2007 AD - March 2012 AD - June 2015
81 http://beotiger.com beotiger@gmail.com
82
83 Let Apple 2 live forever!
00 # Installation
1 # Build modernization by Greg Hedger, November 2017
2 # Ubuntu 16.04
1
2
3 ## Ubuntu 16.04
34
45 make
56 cd bin
67 ./linapple
78
8 # Prerequisites
9 sudo apt-get install libzip-dev libzip4 libcurl3 libcurl-ocaml-dev
9 ### Prerequisites
1010
11 ```bash
12 sudo apt-get git libzip-dev libsdl1.2-dev libcurl4-openssl-dev zlib1g-dev
13 ```
1114
12 # Historical INSTALL
15 ### Clone
16
17 ```bash
18 git clone git@github.com:linappleii/linapple.git
19 ```
1320 Linapple - crossplatfom emulator of Apple][ (Apple2, Apple 2) series computer for Linux or other OSes with SDL support.
1421
1522
16 [INSTALL]
23 ### Compile
1724
18 You need SDL, cURL, zlib and libzip:
25 ```bash
26 cd linapple
27 make
28 ```
1929
20 For Debian/Ubuntu their names are:
30 ### Global Install
31 ```shell
32 make install
33 ```
2134
22 libsdl1.2-dev - Simple Direct Media crossplatform library for video,audio, events etc.
23 libcurl4 - openssl-dev - cURL net functions
24 zlib1g-dev - access .gz files
25 libzip-dev - access .zip files
35 ### Run
2636
27 All these libraries are available for free around the world.
37 ```bash
38 bin/linapple
39 ```
2840
29 For example for Debian/Ubuntu to install:
41 Or if you did a global install.
3042
31 $sudo apt-get install libsdl1.2-dev libcurl4-openssl-dev zlib1g-dev libzip-dev
43 ```bash
44 linapple
45 ```
3246
47 ### Configure
3348
34 After being SDL, zlib, cURL and libzip installed you will be able to compile linapple from sources:
49 A directory name `linapple` can be found in your home directory. Edit the `linapple.conf` file.
3550
36 Untar the package (in .bz2 format):
37
38 $ tar xjf linapple-src_2a.tar.bz2
39
40
41 Then go to src directory and compile.
42
43 $ make
44
45 If there was no errors, you may install it if you wish:
46
47 $ cd bin
48 $ ./linapple
49
50 It will be install in /usr/local/linapple folder, whre you can find linapple.conf file for changing some linapple settings,
51 and empty `images` and `ftp` folders, where Apple 2 images files and downloaded through FTP images are meant to be in.
52
53 But of course you are free to choose any directories of your choice.
54 Note: you should read/write permissions of these folders, or linapple could not work properly.
55
56 For linaaple ability to unpack .zip and .gz files on the fly (either from local disks or from FTP) you also need read/write access for linapple working
57 folder (which by default is /usr/local/linapple), for linapple unpacks these files as drive0.dsk and drive1.dsk for drive 1 and 2 respectively.
58
59
60 OK.
61 If you installed it, you are able to run emulator from any place, just run it like this:
62
63 $ linapple
64
65
66 If you have chosen not to install it, go to the upper directory then and run the beast:
67
68 $ cd ..
69
70 $ ./linapple
71
72
73 If all files are on their places, you should see an X-Window with splash screen.
74 Press F2 (or F3 before to choose some disk image in drive 1), and go to work.
75
76 Note: linapple needs some files in its current working directory for proper working.
77
78 These files are:
79
80 splash.bmp - splash screen
81 charset40.bmp - charset for Apple][ (Apple 2e, etc.) text modes.
82 font.bmp - font for Help screen and Disk Select screens.
83 icon.bmp - nice icon, logo of Apple][ computer.
84 linapple.conf - configuration file.
85 Master.dsk - disk image with Applesoft(tm) DOS 3.3 inside. See Apple license (on apple.com) for details.
86
87 Essentials are font.bmp and charset40.bmp, others can be omitted peacefully.
88
89 P.S. You may play with some options in Makefile in src directory, if you know what you are to do. :)
90
91 Note: See README file for more detailed instructions on using linapple.
92
93
94 [UNINSTALL]
95
96 To uninstall previously installed linapple (by `sudo make install` command) you may write this:
97
98 $ sudo make uninstall
99
100 This will remove by default entire `/usr/local/linapple` folder and `/usr/local/bin/linapple` script.
101
102
103 Also there is possible command for cleaning compiled binaries in src directory:
104
105 $ make clean
106
107 Note: `linapple` executable in upper directory will remain intact.
108
109
110
111 [CONTACT]
112
113 I will be glad to see your comments, suggestions and so on on my email: beotiger@gmail.com
114
115 Sincerely Yours,
116 Krez beom beotiger, December 2007 AD - March 2012 AD
117
118 beotiger@mail.ru
119 beotiger@gmail.com
120
121 Let Apple 2 live forever!
122