This is community effort to create a User Guide for the MEGA65 in the spirit of the original User Guide for the Commodore 64.

If you just want the typeset manuals, hop over to the releases page at:

https://github.com/MEGA65/mega65-user-guide/releases

• MingW32 (tested on MinGW-6.3.0, and MinGW-8.1.0) for Windows or GCC Compiler for Linux / Mac OS X.
• This project repo.
• The mega65-core repo: https://github.com/MEGA65/mega65-core is required for the memory tables included in the User Guide.
• The Simple C library for the MEGA65: https://github.com/MEGA65/mega65-libc is required to create api-conio.tex
• A typesetting environment that supports XeLaTeX, for example: http://www.tug.org/texworks/ for Windows.

The User Guide project is defined using a Makefile to build. Therefore if you are using an environment like TeXworks, do not use the built in Build button. That is for single file building only. For MingW32 users, just use:

mingw32-make or mingw32-make mega65-userguide.pdf in the main folder of the project to build the mega65-userguide.pdf file.

For linux: make or make mega65-userguide.pdf.

If you wish to build the reference manual, use: mingw32-make referenceguide.pdf.

If you wish to build the nexys4 setup guide, use: mingw32-make nexys4-setup-guide.pdf.

To build the entire book, use: mingw32-make mega65-book.pdf.

There is also a sandbox.pdf for experimenting with typesetting or components for the manuals. But it is not included in the makefile. Instead, it is able to be built directly using software like TeXworks.

The sandbox is faster to build and test changes more quickly. You can then transfer your work directly to the userguide.

The complete list of guides that can be individually built are:

It is recommended to install MacPorts, which gives easy access to a huge base of Linux/UNIX software. With MacPorts install following LaTeX packages:

sudo port install texlive-latex

sudo port install texlive-latex-extra

sudo port install texlive-latex-recommended

sudo port install latexmk

sudo port install latexdiff

Then creating the complete MEGA65 documentation is done in the local repository work directory with:

make clean

make mega65-book.pdf

make mega65-book.pdf

Calling "make" with the target twice is intentional and needed for getting all references resolved. Of course, you can create a shell script for these three lines.

For Linux users, the instructions are the similar, but use your favourite package manager to install a LaTeX package of your choice.

Combined with the LaTeX Workshop extension, this is a great IDE for working with the project. However be careful of the using the built-in terminal for compiling the guides. It's a powershell-based terminal and won't work with the Makefile. Nor will Command Prompt. Use a more Unix styled terminal like Git Bash.