Update readme for the client side

fml/install/README.txt

@@ -1,24 +1,89 @@
 This is Forge Mod Loader, or FML for short, by cpw.
 
-It is a clean reimplementation of a mod loading system for server side use,
-incorporating API implementations of client side ModLoader by Risugami.
+More information can be found at https://github.com/cpw/FML/wiki
+
+It is a clean reimplementation of a mod loading system for client, server and
+bukkit use, incorporating API implementations of client side ModLoader by
+Risugami.
 
 It can be installed on its own, or as part of Minecraft Forge.
 
-If you have downloaded the server zip file you can install it as follows:
+----------------------
+About Forge Mod Loader
+----------------------
+
+Environments and compatibility
+==============================
+FML covers the three main environments: client, server and bukkit. All
+environments share the main mod loading code base, with additional varying hooks
+based on the specific environment. Compatibility is almost 100% with all 
+ModLoader based mods- any mod with any difficulty (unless noted below) should
+be reported as a ticket to the github, please.
+
+Client side mods should be 100% compatible with ModLoader. The only exception is
+Optifine, however new versions of optifine are compatible. There are some very
+visible changes to the client when FML is installed.
+
+Server side mods are mostly compatible with previous MLMP based incarnations,
+however, this compatibility is not guaranteed. Most mods have adapted to FML 
+and MLMP is not assured and will cause errors. Ask your mod author to update
+to FML.
+
+Bukkit side modding is an adaptation of the server side mod code to the bukkit
+environment. Mods need to be recompiled against the bukkit decompilation to work
+however there are guides and tools in development to make this process easier.
+Consult mcportcentral.co.za for more information.
+
+Minecraft Forge in all cases bundles FML as it's modloading technology of choice
+because FML is open source, freely distributable, and can be easily updated by
+contributors through github.
+
+Notable integrations
+====================
+Optifine, with the Cx series have started performing the actions necessary for 
+FML compatibility. This means optifine will work well alongside an FML or 
+Minecraft Forge installation. FML will detect and ensure the good operation of
+Optifine (you can see it in your client as an additional data line on the 
+bottom left).
+
+Client notes
+============
+FML does provide a standard pattern for mods to provide HD textures. This is why
+optifine needed integration code. FML supports very very basic HD texture packs
+up to 128x resolution (some 256x resolution packs work but not all). For full
+featured HD optifine is recommended.
+
+Mod information
+===============
+FML exposes the mod information through a mod list visible on the main screen as
+well as some small branding enhancements. For full data mods need to provide an
+information file. This file is a standard format so hopefully tools providing
+launch capabilities can also leverage this content.
+
+-------------------------------
+Binary installation information
+-------------------------------
+If you have downloaded a binary zip file you can install it as follows (client
+or server):
 
 Installation
 ============
-To install this on it's own into a minecraft server, simply copy the contents
-of the fml server zip file into the minecraft_server.jar file.
+To install this on it's own into a minecraft environment, simply copy the
+contents of the fml zip file into the minecraft jar file, using your preferred
+zip management tool (I recommend 7 zip on windows).
+
+For servers: the minecraft jar file is minecraft_server.jar.
+For clients: the minecraft jar file is minecraft.jar. You will additionally need
+to delete the "META-INF" folder in the minecraft.jar file.
+For bukkit: the mcportcentral custom builds of craftbukkit contain all you need
+already. Please refer to mcportcentral.co.za for more information.
 
 Forge Installation
 ==================
 This code also ships as a part of Minecraft Forge. You do not need to install it
-separately from your Minecraft Forge installation.
-
-NOTE: there is no companion client side installation. This is, at present, a
-server-side only installation.
+separately from your Minecraft Forge installation. Minecraft Forge contains the
+exact same code as this. Generally, you should not install FML if you are also
+installing Minecraft Forge.
 
 -------------------------------------------
 Source installation information for modders
@@ -45,13 +110,13 @@ into an mcp installation containing vanilla jars only. It should create a new
 folder "fml" inside that installation.
 
 Once extracted, run the install.sh or install.bat script provided from the fml
-directory. It should decompile and patch your MCP source code for the server.
+directory. It should decompile and patch your MCP source code for the client
+and server.
 
 Forge source installation
 =========================
-MinecraftForge should ship with this code and install it as part of the forge
-installation process, no further action should be required on your part.
-
+MinecraftForge ships with this code and installs it as part of the forge
+installation process, no further action is required on your part.
 
 For reference this is version @MAJOR@.@MINOR@.@REV@.@BUILD@ of FML
 for Minecraft version @MCVERSION@.