Update with current information
[asterisk/asterisk.git] / channels / h323 / README
index 0a19dcc..aa28a8d 100755 (executable)
@@ -8,13 +8,15 @@
        Developed using:        RedHat 7.2/7.3/8.0
                                Open H.323 v1.11.7              
                                PWLib      v1.4.11
-                               GCC       2.96/3.1
+                               GCC   2.96/3.1/3.2
 
        Dependancies:           openssl-0.9.6b
                                openssl-devel-0.9.6b
                                expat-1.95
                                expat-dev-1.95
 
+       Warning: Older versions than listed will NOT work. 
+
 We have implemented this driver using Asterisk's RTP stack insted of trying
 to implement a pseudo sound card driver. 
 
@@ -23,13 +25,22 @@ of Open H.323 and PWLib. In fact you should check to make sure
 your distro didn't install them for you without your knowledge.
 Check everything out of CVS. If you dont know how to deal with cvs, learn. 
 Also, if you are not using the listed versions of Open H.323 or PWlib 
-you are on your own, sorry. Older versions will NOT work, but newer 
-versions ~should~ work.
+you are on your own, sorry. 
+
+
+
+To compile this code:
+You first need the latest release versions of PWLib and Open H.323 from
+http://www.openh323.org/. Make sure you follow the build instructions EXCPLICTLY.
+
+Once PWLib and Open H.323 have been compiled, issue a make in the asterisk/channels/h323 
+directory, then go back to the Asterisk source top level directory and issue a make install.
+
 
 
 Most common compile error:  
 
-If you receive anything that says 'undefined symbol' you are experiencing
+If you receive ANYTHING that says 'undefined symbol' you are experiencing
 typical version skew.  For example:
 
 libh323_linux_x86_r.so.1: undefined symbol: GetNumberValueAt__C14PAbstractArrayi
@@ -44,10 +55,12 @@ cd /path/to/pwlib
 make clean opt
 cd /path/to/openh323
 make clean opt 
-cd asterisk/channels/h323
-make clean install   
+cd /path/to/asterisk/channels/h323
+make  
+cd /path/to/asterisk
+make install 
 
-(Note: Open H.323 or PWLib never get a 'make install')
+(Note: Open H.323 or PWLib never get a 'make install' so don't do it)
  
 
 Most common run-time error:
@@ -72,11 +85,11 @@ want to recompile.
 
 
 If you still have trouble please contact 'JerJer' in #Asterisk on 
-irc.freenode.net or send and email to jj@indie.org
+irc.freenode.net or send and email to jj@nufone.net
 
 If you happen to be lucky enough to segfault this code please run a 
 backtrace  and send me the gory details. Segmentation faults are not
- tolerated!
+tolerated, no matter what Distro you run!
 
 bt example:
 
@@ -89,7 +102,7 @@ Segmentation Fault (core dumped)
 core.1976
 
 # gdb /usr/sbin/asterisk core.1976
-...
+...lots of useless garbage here..
 (gdb) bt
 
 Send whatever shows up right after the 'bt'
@@ -97,8 +110,9 @@ Send whatever shows up right after the 'bt'
 
 Also, a full debug screen output is almost needed. Make sure you are 
 in the full console mode (-c) and turn on 'h.323  debug'. A nice way 
-to capture everything is to use the utility called 'script' (man script) 
+to capture everything is with script (man script) 
+
 
 
-Jeremy McNamara, President
+Jeremy McNamara
 The NuFone Network