~rogpeppe/+junk/mgo-tagged-log-messages

« back to all changes in this revision

Viewing changes to doc.go

  • Committer: Roger Peppe
  • Date: 2014-03-14 18:11:33 UTC
  • mfrom: (263.1.8 master)
  • Revision ID: roger.peppe@canonical.com-20140314181133-107ag3xpitk9682u
merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
// The mgo ("mango") rich MongoDB driver for Go.
 
1
// Package mgo offers a rich MongoDB driver for Go.
2
2
//
3
 
// The mgo project (pronounced as "mango") is a rich MongoDB driver for
4
 
// the Go language.  High-level details about the project may be found
5
 
// at its web page:
 
3
// Details about the mgo project (pronounced as "mango") are found
 
4
// in its web page:
6
5
//
7
6
//     http://labix.org/mgo
8
7
//
19
18
//     c := session.DB(database).C(collection)
20
19
//     err := c.Find(query).One(&result)
21
20
//
22
 
// New sessions may be created by calling New, Copy, or Clone on an
23
 
// initial session.  These spawned sessions will share the same cluster
24
 
// information and connection cache, and may be easily handed into other
25
 
// methods and functions for organizing logic.  Every session created
26
 
// must have its Close method called at the end of its use.
 
21
// New sessions are typically created by calling session.Copy on the
 
22
// initial session obtained at dial time. These new sessions will share
 
23
// the same cluster information and connection cache, and may be easily
 
24
// handed into other methods and functions for organizing logic.
 
25
// Every session created must have its Close method called at the end
 
26
// of its life time, so its resources may be put back in the pool or
 
27
// collected, depending on the case.
27
28
//
28
29
// For more details, see the documentation for the types and methods.
29
30
//