Gentoo Linux Installation Notes
From OHRRPGCE-Wiki
Gentoo is a Linux metadistribution. All of Gentoo's packages are compiled from scratch, and are therefore optimized with more than generic x86 optimizations. This article will tell you how to install the latest WIP version of the OHRRPGCE on Gentoo Linux. The release version requires FreeBASIC 0.15b to function and it doesn't work very well. In the future, these notes will be for the release version.
Contents |
[edit] First Time Only
There are a few things that you'll need to do if you've never added the Hamsterrific overlay before. If this page is new to you, then you'll follow all of these directions
[edit] emerge layman
You may already have this package. If you do, skip this step. Otherwise, continue on:
# emerge layman
If this succeeded, type in the following commands:
# echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf
This will tell Portage to look at layman's make.conf as well as the system make.conf. All emerges until you add an overlay to layman will fail. You may want to do the following in case you won't be completing this howto all at once:
# layman -L # mkdir -p /usr/portage/local/layman # touch /usr/portage/local/layman/make.conf
Layman is now installed -- you can move on now.
[edit] Add Hamsterrific Overlay to Layman
Edit /etc/layman/layman.cfg with your favorite editor. Find the line that looks like this:
overlays : http://www.gentoo.org/proj/en/overlays/layman-global.txt
And change it to say:
overlays : http://www.gentoo.org/proj/en/overlays/layman-global.txt http://svn.ignition-project.com/hamsterrific-overlay.xml
(you're only adding the last line)
Save this file and type:
# layman -L
This will update layman's cache (or should; if you don't see "hamsterrific" in the list, try again in a minute).
[edit] Add the Hamsterrific Overlay to Portage
Type:
# layman -a hamsterrific
This will get a bunch of stuff from my repository and download it to your computer. This is a Good Thing(TM). After the files complete, move on to "Installing OHRRPGCE".
[edit] Returning Users
If you've already added the overlay and installed layman, you just need to run:
# layman -s hamsterrific
This will synchronize your copy with mine.
[edit] Installing OHRRPGCE
I have split up the OHRRPGCE into two seperate packages: ohrrpgce-custom-wip and ohrrpgce-player-wip. If you want both, you must install both. OHRRPGCE requires FreeBASIC, which I also provide in my overlay. I provide source and binary versions of FreeBASIC; only the binary version actually works with OHRRPGCE (blame FreeBASIC). The virtual package for FreeBASIC automatically picks the binary version of FreeBASIC. If you didn't understand anything I just said, or if you're ready to continue, type:
# emerge ohrrpgce-player-wip
You'll get a message about the package being masked. You should already know how to unmask packages since you're on Gentoo. If not, read the message it spouts out and do what it says. Basically, it amounts to adding lines like this to /etc/portage/package.keywords:
dev-lang/fbc-bin ~x86 games-rpg/ohrrpgce-player-wip ~x86 ... and so on ...
Also, keep in mind that to play games, you must be part of the "games" group. Read the output from the end of the install for more info.
And remember: if you want ohrrpgce-custom-wip, use it in place of ohrrpgce-player-wip in the examples.
[edit] Running OHRRPGCE
Open up your window manager's Run dialog and type /usr/games/bin/ohrrpgce-player-wip (or ohrrpgce-custom-wip). If all is well, it'll work. Otherwise, well, I dunno. Post to the mailing list and I'll see if I can help :).
In the future, I'll create .desktop files so you can start it from your menus.
[edit] Getting Updates
[edit] Updating the Overlay
You'll want to update the overlay when you run emerge --sync. To do this, type:
# layman -s hamsterrific
This will ensure you have the latest version of the package files.
[edit] Updating OHRRPGCE
Re-merge the packages, which will fetch an updated version from svn:
# emerge ohrrpgce-player-wip (or ohrrpgce-custom-wip)
This will update the version you have installed.
[edit] Final Notes
You CAN run both ohrrpgce-custom-wip and ohrrpgce-player-wip at the same time and have them both installed at the same time. It's probably a bad idea to run both simultaneously on the same game though. Also, /usr/games/lib/ohrrpgce/ is writable by root and anyone in the games group. To edit anything, you have to place the files in /usr/games/lib/ohrrpgce/. This will hopefully change in future versions of OHRRPGCE.
