anchor.diff:  Most things in Dalesbred happen through an instance of {javadocBase}fi/evident/dalesbred/Database.html[Database].
   The easiest way to get hold of one is to specify the settings manually:
   
  -[source,java]
  -Database db = Database.forUrlAndCredentials("jdbc:example-url", "login", "password");
  +[source,java,indent=0]
  +----
  +        Database db = Database.forUrlAndCredentials("jdbc:example-url", "login", "password");
  +----
   
   Note that this performs no connection pooling and is therefore probably not
   your preferred way of configuring the system in production. In a container
   you'll probably want to use a named {jdkJavadocBase}javax/sql/DataSource.html[DataSource] lookup up from JNDI:
   
  -[source,java]
  +[source,java,indent=0]
   Database db = Database.forJndiDataSource("java:comp/env/jdbc/ExampleDb");
   
   Alternatively, you might setup a {jdkJavadocBase}javax/sql/DataSource.html[DataSource] yourself, in which case you can
   just create a {javadocBase}fi/evident/dalesbred/Database.html[Database] out of that:
   
  -[source,java]
  +[source,java,indent=0]
   Database db = Database.forDataSource(myDataSource);
   
   If you are using http://projects.spring.io/spring-framework/[Spring Framework] or
  
positive.code: 
  Nested transactions are supported if your database supports them:
  
  [source,java]
  -------------------------------------------------------------------------------------------------------
  db.withTransaction(Propagation.NESTED, new TransactionCallback<Result>() {
      ...
  });
  -------------------------------------------------------------------------------------------------------
  
  Miscellaneous features
  ----------------------
  
negative.code: you can register your own {javadocBase}fi/evident/dalesbred/instantiation/TypeConversion.html[TypeConversion]-implementations
  to {javadocBase}fi/evident/dalesbred/instantiation/TypeConversionRegistry.html[TypeConversionRegistry]:
  
  [source,java,indent=0]
  ----
          TypeConversionRegistry conversions = db.getTypeConversionRegistry();
          conversions.registerConversionFromDatabaseType(new StringToEmailAddressConversion());
          conversions.registerConversionToDatabaseType(new EmailAddressToStringConversion());
  ----
  
  Custom instantiators
  ~~~~~~~~~~~~~~~~~~~~
  