X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=README;h=7825aef61e6976ae9adef3c9b859008337cd5f08;hb=ebefc26c10d68ba9ced2a30c896dccc81c6c2eeb;hp=6c23712ff3c8a82c0c22f15d54e653ab231a3f41;hpb=82b65f18fa44f1f9a673f10d917b2efdf087e565;p=deb_libcec.git

diff --git a/README b/README
index 6c23712..7825aef 100644
--- a/README
+++ b/README
@@ -1,27 +1,104 @@
 This library provides support for the Pulse-Eight USB-CEC adapter.
 
-To install libCEC on Linux:
+===============================================================================
+                                === Linux ===
+===============================================================================
+
+libCEC needs the following dependencies in order to work correctly:
+* udev v151 or later
+* cdc-acm support compiled into the kernel or available as module
+* liblockdev 1.0 or later
+
+To compile libCEC on Linux, you'll need the following dependencies:
+* autoconf 2.13 or later
+* automake 1.11 or later
+* pkg-config
+* libtool
+* udev development headers v151 or later
+* gcc 4.2 or later
+* liblockdev 1.0 development headers
+
+To compile, execute the following commands:
 # autoreconf -vif
-# ./configure --prefix=/usr
+# ./configure
 # make
 # sudo make install
 
-To install libCEC on Windows:
+===============================================================================
+                                === OS-X ===
+===============================================================================
+
+To compile libCEC on OS-X, you'll need the following dependencies:
+* autoconf 2.13 or later
+* automake 1.11 or later
+* pkg-config
+* xcode 3.2.6 or later
+
+To compile, execute the following commands (TODO: please verify):
+# autoreconf -vif
+# ./configure
+# make
+# sudo make install
+
+# Note: You may need to copy pkg.m4 to your m4 sources directory
+
+===============================================================================
+                              === Windows ===
+===============================================================================
+
+To compile libCEC on Windows, you'll need Visual C++ 2010 or Visual Studio 2010
+The installer needs the Windows DDK (Driver Development Kit) and Nullsoft's
+NSIS.
+
+To compile LibCecSharp on Windows, you'll need Visual C++ 2008 or Visual Studio
+2008, because it is compiled against .NET 2.0.
+
+To compile libCEC, follow these instructions:
 * open /project/libcec.sln with Visual C++ 2010 or Visual Studio 2010.
 * build the project.
-* copy libcec.dll and pthreadVC2.dll to your desired destination.
 
 To build an installer on Windows:
-* download and install the Windows DDK.
 * download and install NSIS.
-* go to /project and execute create-installer.cmd to create the installer.
-* the installer is stored as /project/libCEC-installer.exe
+* go to /project and execute create-installer.bat to create the installer.
+* the installer is stored as /build/libCEC-installer.exe
+
+You will need both Visual Studio 2008 and Visual Studio 2010 to build the
+installer from the command line. To build with Visual C++ 2008 and 2010,
+you will need to manually build libcec with Visual C++ 2010 and then
+build LibCecSharp.sln with Visual Studio 2008. See create-installer.bat
+for the required steps.
+
+===============================================================================
+                            === Debugging / Testing ===
+===============================================================================
+
+We provide a test client, named cec-client, to debug the device.
+To check whether the device can be detected, execute the following command:
+* cec-client -l
+
+"cec-client -h" shows a list of commands and options that are available.
+
+===============================================================================
+                              === Developers ===
+===============================================================================
+
+We provide a C, C++ and .NET CLR interface to the adapter.
+
+C++ developers:
+* the API can be found in /include/cec.h
+* an example implementation can be found in /src/testclient/main.cpp
+
+C developers:
+* the API can be found in /include/cecc.h
 
-Test the device:
-* run "cec-client -h" to display the options of the test client.
+.NET developers:
+* add a reference to LibCecSharp.dll
+* an example can be found in \src\CecSharpTester\CecSharpClient.cs
 
-For developers:
-* see /include/cec.h for the C++ API and /include/cecc.h for the C version.
+===============================================================================
+                        === Developers Agreement ===
+===============================================================================
 
-If you wish to contribute to this project, you must first sign our contributors agreement
-Please see http://www.pulse-eight.net/contributors for more information
\ No newline at end of file
+If you wish to contribute to this project, you must first sign our contributors
+agreement. Please see http://www.pulse-eight.net/contributors for more
+information.