h1. Building AMC from sources on Gentoo

As of September 16th of 2014, there are no AMC @ebuild@ available through any overlay, unfortunately.
Using this guide, you find all the information and resources to compile / install AMC 1.2.1. You will need to set up a local overlay (i.e. on your computer) to use the @ebuild@ provided in this page.

h2. Compile / Install using a local overlay

* Create a local overlay
For reference, here the original procedure, same procdure, with more explanations details : http://wiki.gentoo.org/wiki/Overlay/Local_overlay
Run the following commands as @root@ (don't forget to give your overlay a nice name ) :
<pre>
# mkdir -p /usr/local/portage/{metadata,profiles}
# echo 'NameOfTheOverlay' > /usr/local/portage/profiles/repo_name
# echo 'masters = gentoo' > /usr/local/portage/metadata/layout.conf
# chown -R portage:portage /usr/local/portage
</pre>
Get @portage@ ready to make use of this new overlay :
<pre>
# echo 'PORTDIR_OVERLAY="/usr/local/portage ${PORTDIR_OVERLAY}"' >> /etc/portage/make.conf
</pre>

* Install the provided files (ebuild and patch)
Create directories as necessary :
<pre>
# mkdir -p /usr/local/portage/app-office/auto-multiple-choice/files/
</pre>
Download the files on this page, and store them in the following directories :
<pre>
/usr/local/portage/app-office/auto-multiple-choice/auto-multiple-choice-1.2.1.ebuild
/usr/local/portage/app-office/auto-multiple-choice/files/auto-multiple-choice-1.2-makefiles.patch
</pre>
By default (and I apologize for this bad practice), this @ebuild@ is marked as stable on arch "@amd64@" (64 bits linux). Add your arch is needed in the @KEYWORDS@ variable in the @ebuild@ file (e.g. "@x86@", or better "@~x86@".)

* Generate the @Manifest@
Still as @root@ user :
<pre>
cd /usr/local/portage/app-office/auto-multiple-choice/
ebuild auto-multiple-choice-1.2.1.ebuild manifest clean
</pre>
Now AMC should be ready for installation. Each and every time you change the @ebuild@, you need to generate again the @Manifest@.

* Install AMC
All that is left to do, is to run your favorite "@emerge@" line :
<pre>
emerge -qav auto-multiple-choice
</pre>

h2. Installation using an @overlay@

No existing @overlay@ yet. :-(

h2. Updates to the documentation

The provided @ebuild@ and this documentation are relatively new and untested. Feel free to adapt and to give some feedback (forums or wiki).