------------------------------------------
PTMDB MODULE - db_get_databases() FUNCTION
------------------------------------------

  ------------
  USAGE FORMAT
  ------------

    Where @databases is a returned list of database names:

    @databases = &db_get_databases($db_object);

  -----------
  DESCRIPTION
  -----------

    Retreives a list of the database names from the server. Returns an array
    containing database names in the order in which they were returned from
    the server. ONLY databases accessible by the logged in user will be
    returned.

  ---------
  ARGUMENTS
  ---------

    $db_object

      REQUIRED

      A database handler object. This object stores connection information and
      is returned from a db_connect() function call. This object is of the same
      type as is returned by a DBI->connect function call.

  -------
  RETURNS
  -------

    An array containing the accessible database names from the server.

  --------------
  USAGE EXAMPLES
  --------------

    ------------------------------------------------------
    Example 1: Display the Database Names, Comma Separated
    ------------------------------------------------------

      <?= join(', ', &db_get_databases($dbobj)) =?>