Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve README #372

Merged
merged 5 commits into from
Dec 27, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 12 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,11 @@
# amiga-gcc [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YRRBRLCKDU3H6)
The GNU C-Compiler with Binutils and other useful tools for cross development

This is a Makefile based approach to build the same files as in the old amigaos-toolchain to reduce the build time.
The GNU C Compiler with binutils and other useful tools for cross compiling software for the Commodore Amiga.

This is a Makefile based approach to building the amigaos-toolchain, aiming to reduce its build time.

Currently, these tools are built:

Right now these tools are build:
* binutils
* gcc with libs for C/C++/ObjC
* fd2sfd
Expand All @@ -14,6 +16,7 @@ Right now these tools are build:
* vlink
* libnix
* ixemul (not really, but the headers are used)

# COPYRIGHTS
* amiga-netinclude: 'Roadshow' -- Amiga TCP/IP stack, Copyright © 2001-2016 by Olaf Barthel. Freely Distributable.
* aros-stuff: libpthread, Copyright (C) 2014 Szilard Biro.
Expand All @@ -33,12 +36,10 @@ Right now these tools are build:
* vbcc: copyright in 1995-2022 by Volker Barthelmann, free for non-commercial purposes.
* vlink: copyright 1995-2022 by Frank Wille, free for non-commercial purposes.

There are also libraries - calles SDK - which can be downloaded and installed plus libraries that are built from source. All of these provide their own copyrights - too long to list here.
There are also libraries (SDKs) which can be downloaded and installed. These libraries can all be built from source. All of these libraries are provided under their respective licenses.

To get it work together and enhance it, some patches are applied here and there and the gcc compiler contains a tad more hacks/enhancements.
None if these changese modifies the original copyright in any way. All other stuff here is published using the GNU GENERAL PUBLIC LICENSE V2.
Various AmigaOS-specific patches have been applied to this version of gcc. None if these changes modify the original copyright in any way. All other changes are published under the terms of the GNU GENERAL PUBLIC LICENSE V2.

# Short Guide
## Prerequisites
### Centos
`sudo yum install wget gcc gcc-c++ python git perl-Pod-Simple gperf patch autoconf automake make makedepend bison flex ncurses-devel gmp-devel mpfr-devel libmpc-devel gettext-devel texinfo rsync readline-devel`
Expand Down Expand Up @@ -81,6 +82,7 @@ CC=gcc-12 CXX=g++-12 gmake all SHELL=$(brew --prefix)/bin/bash
```
export PATH=$(brew --prefix bison)/bin:$PATH
```
* This version of gcc supports building binaries optimised for the various Motorola 68K series CPUs from the 68000 to the 68060 and also features some optimisations for the Vampire/Apollo 68080.

### macOS on M1
Native builds on M1 Macs are now directly supported.
Expand Down Expand Up @@ -152,14 +154,14 @@ sudo usermod -a -G users username
After adding the user to the group, you may have to logout and login again to apply the changes to your user.

## Building
Simply run `make all`. Also add -j to speedup the build.
In most cases you can simply run `sudo make all`. You can use `-j` to speed up the build, adjusting the value of `-j` to the number of cores you wish to use for the build process.

```
make clean
make drop-prefix
time make all -j3
time make all -j4
```
takes roughly 10 minutes on my laptop running ubuntu. takes forever running cygwin on windows^^.
The above commands take roughly 10 minutes on my laptop running Ubuntu yet the same commands take forever running cygwin on Windows.

## Kickstart 1.3

Expand Down