\name{org.Hs.goa_dbconn}
\alias{org.Hs.goa_dbconn}
\alias{org.Hs.goa_dbfile}
\alias{org.Hs.goa_dbschema}
\alias{org.Hs.goa_dbInfo}
\title{Collect information about the package annotation DB}
\description{  
  Some convenience functions for getting a connection object to (or collecting 
  information about) the package annotation DB. 
}
\usage{
  org.Hs.goa_dbconn()
  org.Hs.goa_dbfile()
  org.Hs.goa_dbschema(file="", show.indices=FALSE)
  org.Hs.goa_dbInfo()
}
\arguments{ 
  \item{file}{A connection, or a character string naming the file to print to 
    (see the file argument of the cat function for the details). }
  \item{show.indices}{The CREATE INDEX statements are not shown by default. Use 
    show.indices=TRUE to get them. }
}
\details{
  \code{org.Hs.goa_dbconn} returns a connection object to the package annotation DB. 
  IMPORTANT: Don't call \code{\link[DBI]{dbDisconnect}} on the connection object 
  returned by \code{org.Hs.goa_dbconn} or you will break all the 
  \code{\link[AnnotationDbi]{AnnDbObj}} objects defined in this package! 

  \code{org.Hs.goa_dbfile} returns the path (character string) to the package
  annotation DB (this is an SQLite file). 

  \code{org.Hs.goa_dbschema} prints the schema definition of the package annotation
  DB. 

  \code{org.Hs.goa_dbInfo} prints other information about the package annotation
  DB.  
}
\examples{
  ## Show the first three rows.
  dbGetQuery(org.Hs.goa_dbconn(), "select * from go limit 3")

  ## The connection object returned by org.Hs.goa_dbconn() was created with:
  dbConnect(SQLite(), dbname=org.Hs.goa_dbfile(), cache_size=64000, synchronous=0)

  org.Hs.goa_dbschema()

  org.Hs.goa_dbInfo()
}