mirror of
https://github.com/LIV2/amitools.git
synced 2025-12-06 06:32:47 +00:00
updated docs to mention machine68k
This commit is contained in:
parent
7ca4406520
commit
d6c121236b
@ -2,10 +2,5 @@ include MANIFEST.in
|
||||
include README.md
|
||||
include CHANGELOG.md
|
||||
include Makefile
|
||||
include machine/musashi/softfloat/softfloat-macros
|
||||
include machine/musashi/softfloat/softfloat-specialize
|
||||
include machine/musashi/*.txt
|
||||
recursive-include amitools/data *
|
||||
recursive-include amitools/fs/block/bootcode *
|
||||
recursive-include machine *.pyx *.c *.h
|
||||
recursive-include gen *.c *.h
|
||||
|
||||
1
Makefile
1
Makefile
@ -75,7 +75,6 @@ clean_py:
|
||||
|
||||
clean_ext:
|
||||
$(PYTHON) setup.py clean
|
||||
rm -f machine/*.so machine/emu.c
|
||||
|
||||
# install, distrib
|
||||
install:
|
||||
|
||||
25
README.md
25
README.md
@ -25,33 +25,42 @@ will be very helpful.
|
||||
### Optional Packages
|
||||
|
||||
- [lhafile - FS Edition][2]: required to use ```.lha``` file scanner
|
||||
- [cython][3]: (version >= **3.0.0**) required to rebuild the native module
|
||||
- [machine68k][3]: required to run `vamos`
|
||||
|
||||
[1]: https://pip.pypa.io/en/stable/installation/
|
||||
[2]: https://github.com/FrodeSolheim/python-lhafile
|
||||
[3]: https://cython.org
|
||||
[3]: https://github.com/cnvogelg/machine68k/
|
||||
|
||||
## Installation
|
||||
|
||||
### Stable/Release Version
|
||||
|
||||
If you only need the tools without `vamos` then you can install the pure
|
||||
Python version:
|
||||
|
||||
```bash
|
||||
pip3 install amitools
|
||||
```
|
||||
|
||||
If you want to run `vamos` then you need the CPU emulator from the `machine68k`
|
||||
package and you can install this dependency with:
|
||||
|
||||
```bash
|
||||
pip3 install 'amitools[vamos]'
|
||||
```
|
||||
|
||||
Note:
|
||||
|
||||
- on Linux/macOS may use ``sudo`` to install for all users
|
||||
- requires a host C compiler to compile the extension.
|
||||
- the version may be a bit outdated. If you need recent changes use the
|
||||
current version.
|
||||
|
||||
### Current Version from GitHub
|
||||
|
||||
Ensure you have Cython installed:
|
||||
If you wan to run `vamos` then first install the CPU emulator `machine68k`:
|
||||
|
||||
```bash
|
||||
pip3 install cython
|
||||
pip3 install -U git+https://github.com/cnvogelg/machine68k.git
|
||||
```
|
||||
|
||||
Then install `amitools` directly from the git repository:
|
||||
@ -70,10 +79,10 @@ Note:
|
||||
|
||||
- Follow this route if you want to hack around with the amitools codebase
|
||||
- Clone the Git repo: [amitools@git](https://github.com/cnvogelg/amitools)
|
||||
- Ensure you have Cython installed:
|
||||
- Ensure you have Cython and `machine68k` installed:
|
||||
|
||||
```bash
|
||||
pip3 install cython
|
||||
pip3 install cython machine68k
|
||||
```
|
||||
|
||||
- Enter the directory of the cloned repo and install via pip:
|
||||
@ -99,6 +108,8 @@ The new Documentation of `amitools` is hosted on [readthedocs][4]
|
||||
and dos calls with its own implementation and maps all file access to
|
||||
your local file system.
|
||||
|
||||
Note: `vamos` requires the package `machine68k` installed first!
|
||||
|
||||
- [xdftool][5]
|
||||
|
||||
Create and modify ADF or HDF disk image files.
|
||||
|
||||
@ -4,3 +4,4 @@ twine
|
||||
tox
|
||||
black
|
||||
build
|
||||
machine68k
|
||||
|
||||
@ -1,2 +1,3 @@
|
||||
pytest
|
||||
pytest-benchmark
|
||||
machine68k
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user