games-strategy/openra-bin: add README.gentoo

diff --git a/games-strategy/openra-bin/ChangeLog b/games-strategy/openra-bin/ChangeLog
index 31e5db82e115dcf4894fe7887f43c89de6320b10..ca89df13638285a9e34ed54e1de67545f399d683 100644 (file)
--- a/games-strategy/openra-bin/ChangeLog
+++ b/games-strategy/openra-bin/ChangeLog
@@ -2,6 +2,10 @@
 # Copyright 1999-2012 Gentoo Foundation; Distributed under the GPL v2
 # $Header: $
 
+  14 Apr 2012; hasufell <julian.ospald@googlemail.com>
+  openra-bin-20120315.ebuild, +files/README.gentoo:
+  add README.gentoo
+
   03 Apr 2012; hasufell <julian.ospald@googlemail.com>
   openra-bin-20120315.ebuild:
   older versions of nvidia-cg-toolkit don't work

diff --git a/games-strategy/openra-bin/Manifest b/games-strategy/openra-bin/Manifest
index c8b13f9f9b41cdb0dd35f09d245657b9f5895675..acb17f011ec2cd18b238d6e8339383563d841f44 100644 (file)
--- a/games-strategy/openra-bin/Manifest
+++ b/games-strategy/openra-bin/Manifest
@@ -1,7 +1,8 @@
+AUX README.gentoo 4754 RMD160 84b3167a9eb057952a922e45eda5bd2e39403200 SHA1 a4a6f67f03e346eb6919cf1b7226a0e3ec405c8b SHA256 fe5d3a65472701fdfa44fe3e27aad694a13881932f75dbbba5c1fc3464ca006f
 AUX openra-cnc.desktop 179 RMD160 37515323230b95ea3f9ae55b8583a6b485eb84f4 SHA1 a9df52c1967e00da6790bf987c55caf16b09e4b6 SHA256 6d5d77d5206ce24a40eac150f70ef9561553da5390dcd010ccaac064db31a0ef
 AUX openra-editor.desktop 147 RMD160 1b71e5a6d3c67349c874bd62d2884249fbe6573f SHA1 03c302358840fb2e7988dcae5b5d5d2639c3e65d SHA256 be65ea2c5548662ce0ee5d9863f26fac0c0626dc712bb1c1e6ff6a6af064621d
 AUX openra-ra.desktop 169 RMD160 c625dc42ef786f4fab61f510b495459ecf18f8aa SHA1 264747729e1c83bd24ea4b7cd884c3ea1479ddad SHA256 f6ca60a25bc66619d83a0bf93d990f338299ef42e54a4c3eb237239057b08686
 DIST openra-release.20120315-1-any.pkg.tar.xz 2609992 RMD160 b8e3df8598881f1d6120f085c122d38d8df29ffa SHA1 0b7f3db0cc07ced9df630f228fdf0aa6b464814a SHA256 8b8870569b0d1810fb04d786ce0cffc232bd94083b32c915981e3c2c6e392773
-EBUILD openra-bin-20120315.ebuild 2138 RMD160 c9124797f43c6829886990b212645659f1621e43 SHA1 53b3dc44648f64c2803122fdd069653b7cc0212a SHA256 0f5ae86d72e6de6970aeb663665595d27bf34829b73758d4813033c4a7c2315b
-MISC ChangeLog 530 RMD160 c29c14ff14325338d9f022a48f9cf8dbf4a4ccb4 SHA1 67474f3377b53e196df9c96b1a9c8cd84b3c486b SHA256 96e40f170652bfeb294501fbe0f8a0470d4c00865c440be6537bee2869241daf
+EBUILD openra-bin-20120315.ebuild 2170 RMD160 298a00d4742abec94565eb1ed3eef30e982ec99a SHA1 aff8ab978a92f648eece99081b09668a309c438a SHA256 a06491e1e3abd93f5168fb774ceb17453f68bbe45bcfd0920a5c73781e1fa407
+MISC ChangeLog 658 RMD160 9294cca97de3eccb5ff8c2c5460c4327f57064dc SHA1 54c4e9a22959789c0427e82d4d8242b2d6ea28cf SHA256 aeb0d68926706034bd7dfbbf8cdec400fb79da7e579d1843529d9e70135047da
 MISC metadata.xml 277 RMD160 deef251b1089c0d0655fdbf52772c18f013c3786 SHA1 0c0b2d64253140602f55f3a9f253d15bf3feac45 SHA256 3706bb4995873a3063e6224888dee01cde0df6f2522f745b2d38ebcc7db0cd2f

diff --git a/games-strategy/openra-bin/files/README.gentoo b/games-strategy/openra-bin/files/README.gentoo
new file mode 100644 (file)
index 0000000..33502af
--- /dev/null
+++ b/games-strategy/openra-bin/files/README.gentoo
@@ -0,0 +1,111 @@
+OpenRA is a Libre/Free Real Time Strategy game engine supporting early
+Westwood games like Command & Conquer and Command & Conquer: Red Alert.
+
+Distributed mods include a reimagining and updating of both the Red
+Alert and Command & Conquer multiplayer games.
+
+You may run the game from desktop games menu or just manually
+run the game with `mono OpenRA.Game.exe Game.Mods=ra` for Red Alert
+or `mono OpenRA.Game.exe Game.Mods=cnc` for Command & Conquer.
+
+If you have problems starting the game consider switching to
+alternative Cg Renderer. You may run the game with alternative
+Cg Graphics Renderer from desktop games menu or by adding
+`Graphics.Renderer=Cg` parameter explicitly to above console commands
+ (convenient for some integrated graphics cards).
+To run explicitly with a default one use `Graphics.Renderer=Gl`
+parameter. The default Graphics Renderer is a better one, so
+don't forget to upgrade your graphics hardware drivers to the
+latest version. For Cg renderer also try to upgrade nvidia-cg-toolkit
+too. 
+
+The RA packages will need to be extracted to ~/.openra/Content/ra/
+before the RA mod will actually work. The C&C packages will need
+to be extracted to ~/.openra/Contet/cnc/ for C&C mod. You may 
+execute OpenRA and it will suggest to download content from original
+CD or a minimal one from OpenRA site automatically. You may also try
+to download minimal content pack from OpenRA site manually by using
+OpenRA Utility:
+
+cd /usr/share/games/openra
+mono OpenRA.Utility.exe --download-url=http://open-ra.org/get-dependency.php?file=ra-packages,/tmp/ra-packages.zip
+mono OpenRA.Utility.exe --extract-zip=/tmp/ra-packages.zip,~/.openra/Content/ra/
+
+The same commands for C&C mod:
+mono OpenRA.Utility.exe --download-url=http://open-ra.org/get-dependency.php?file=cnc-packages,/tmp/cnc-packages.zip
+mono OpenRA.Utility.exe --extract-zip=/tmp/cnc-packages.zip,~/.openra/Content/cnc/
+
+But the better choice is to download a full pack from original game CD
+(or iso). However, full CD pack usage result in slower game start from
+OpenRA Lobby. It happens due to a lot of unnecessary things like video
+clips were pre-packaged in it. If you want optimal game start and all
+music themes (made by Frank Klepacki) from classic CD you should
+download them from OpenRA Forum:
+http://www.sleipnirstuff.com/forum/viewtopic.php?f=83&t=15063
+
+The minimal required files for the Red Alert mod are:
+EITHER:
+ * conquer.mix
+ * temperat.mix
+ * interior.mix
+ * snow.mix
+ * sounds.mix
+ * allies.mix
+ * russian.mix
+OR: (Usually pretty long game start)
+ * main.mix
+AND:
+ * redalert.mix
+
+The minimal required files for the Command and Conquer mod are:
+ * cclocal.mix
+ * speech.mix
+ * conquer.mix
+ * sounds.mix
+ * tempicnh.mix
+ * temperat.mix
+ * winter.mix
+ * desert.mix
+
+If you have a case-sensitive filesystem you must change the filenames to
+lower case.
+
+Red Alert and C&C have been released by EA Games as freeware. They could be
+downloaded from http://www.commandandconquer.com/classic
+Unfortunately the installer is 16-bit and so won’t run on 64-bit operating
+systems. This can be worked around by using the Red Alert Setup Manager
+ (http://ra.afraid.org/html/downloads/utilities-3.html).
+Make sure you apply the no-CD protection fix so all the files needed
+are installed to the hard drive.
+
+If your notebook doesn't show long battery life under OpenRA load you can
+do several things:
+1. Turn off "Show Shellmap" item under General tab of Settings menu.
+2. Edit ~/.openra/settings.yaml in the "Graphics:" section to add
+framelimiter. Add "CapFramerate: True" string there to enable framelimiter.
+The default setting is 60 frames per second. You can change it's value by
+adding "MaxFramerate: 70", for example, string in that section. Be careful
+with special tab symbols at the beginning of the strings. Don't forget to
+backup your settings file.
+
+Please note: OpenRA has 2 types of released versions:
+1. Release Versions or just Versions.
+2. Unstable Playtests Versions or just Playtests.
+Release Versions are considered as more stable ones. Playtests are also
+pretty stable in most cases but they have usually more features wich are
+needed to be tested before inclusion into release. So, if you have any
+problems, please report them to the IRC channel #openra on irc.freenode.net
+(Use http://webchat.freenode.net/ if you don't have IRC client)
+or to the bug-tracker (http://bugs.open-ra.org).
+
+You may also see servers list with
+http://master.open-ra.org/list.php
+or by using orabot on IRC channel:
+]games (or !games)
+to see the games wich are waiting to start or
+]games --all
+to see all games.
+
+Please read HACKING for an overview of the engine and read OpenRA Wiki
+page for more info about the game and it's development:
+https://github.com/OpenRA/OpenRA/wiki

diff --git a/games-strategy/openra-bin/openra-bin-20120315.ebuild b/games-strategy/openra-bin/openra-bin-20120315.ebuild
index 81223473d884bc1da5c054808ca37a05bd495efd..c4481755e14f5a6b8022bb5c5a8fe4116a1ceb50 100644 (file)
--- a/games-strategy/openra-bin/openra-bin-20120315.ebuild
+++ b/games-strategy/openra-bin/openra-bin-20120315.ebuild
@@ -36,7 +36,8 @@ src_prepare() {
 
 src_install() {
        # docs
-       dodoc usr/share/${MY_PN}/{CHANGELOG,HACKING} || die
+       dodoc "${FILESDIR}"/README.gentoo \
+               usr/share/${MY_PN}/{CHANGELOG,HACKING} || die
        rm usr/share/${MY_PN}/{CHANGELOG,HACKING} || die
 
        # data files