cvs: phpdoc /en/reference/misc/functions get-browser.xml

philip          Mon Dec 30 11:05:15 2002 EDT

  Modified files:              
    /phpdoc/en/reference/misc/functions get-browser.xml 
  Log:
  Made existence of browscap.ini a little more clear, noted when 
register_globals
  affected it which closes bug #6513, and fixed typo as this still returns an 
object.
  
  
Index: phpdoc/en/reference/misc/functions/get-browser.xml
diff -u phpdoc/en/reference/misc/functions/get-browser.xml:1.5 
phpdoc/en/reference/misc/functions/get-browser.xml:1.6
--- phpdoc/en/reference/misc/functions/get-browser.xml:1.5      Sun Dec 29 
23:57:52 2002
+++ phpdoc/en/reference/misc/functions/get-browser.xml  Mon Dec 30 11:05:14 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/misc.xml, last change in rev 1.2 -->
   <refentry id="function.get-browser">
    <refnamediv>
@@ -11,7 +11,7 @@
    <refsect1>
     <title>Description</title>
      <methodsynopsis>
-      <type>array</type><methodname>get_browser</methodname>
+      <type>object</type><methodname>get_browser</methodname>
       <methodparam 
choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam>
      </methodsynopsis>
     <simpara>
@@ -25,7 +25,7 @@
      <function>get_browser</function>.
     </simpara>
     <simpara>
-     The information is returned in an array, which will contain
+     The information is returned in an <type>object</type>, which will contain
      various data elements representing, for instance, the browser's
      major and minor version numbers and ID string; &true;/false values
      for features such as frames, JavaScript, and cookies; and so
@@ -88,9 +88,10 @@
      In order for this to work, your <link
      linkend="ini.browscap">browscap</link> configuration setting in
      &php.ini; must point to the correct location of the
-     <filename>browscap.ini</filename> file on your system.  An up-to-date
-     <filename>browscap.ini</filename> file can be located 
-     <ulink url="&url.browscap.download;">here</ulink>.  By default, this 
+     <filename>browscap.ini</filename> file on your system.  
+     <filename>browscap.ini</filename> is not bundled with PHP but you
+     may find an up-to-date <ulink url="&url.browscap.download;">
+     browscap.ini file here</ulink>.  By default, the 
      <link linkend="ini.browscap">browscap</link> directive is commented out.
     </simpara>
     <note>
@@ -100,6 +101,15 @@
       enabled the browser to accept cookies or not.  The only way to test if
       cookies are accepted is to set one with <function>setcookie</function>,
       reload, and check for the value.
+     </simpara>
+    </note>
+    <note>
+     <simpara>
+      On versions older than PHP 4.0.6, you will have to pass the
+      user agent in via the optional <parameter>user_agent</parameter>
+      parameter if the PHP directive <link linkend="ini.register-globals">
+      register_globals</link> is <literal>off</literal>.  In this case,
+      you will pass in 
<varname>$HTTP_SERVER_VARS['HTTP_USER_AGENT']</varname>. 
      </simpara>
     </note>
    </refsect1>



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php