Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
It's no longer true that all joins must be pre-declared.  You can use the
dot-syntax for ad-hoc joins
  • Loading branch information
brummett committed Oct 28, 2011
1 parent 57c1735 commit eb30e9c
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 8 deletions.
3 changes: 1 addition & 2 deletions gmt-web/content/documentation.html
Original file line number Diff line number Diff line change
Expand Up @@ -120,15 +120,14 @@ <h2><a name="benefits">Benefits</a></h2>
<ul>
<li>database queries don't repeat themselves again and again</li>
<li>you never write insert/update/delete statements, or work out constraint order yourself</li>
<li>allows you to write methods which address an object individually, with some ways to avoid tons of individual database queries</li>
<li>allows you to write methods which address an object individually, with ways to avoid many individual database queries</li>
<li>explicitly clearing the cache is less complex than explicitly managing the caching of data</li>
</ul>

<h2><a name="issues">Issues</a></h2>
<ul>
<li>the cache grows until you explicitly clear it, or allow the Context to prune the cache by setting object count limits explicitly</li>
<li>there is CPU overhead checking the cache if you really are always going directly to the database</li>
<li>Joins must be pre-declared through the class definition system</li>
</ul>

<hr />
Expand Down
8 changes: 2 additions & 6 deletions lib/UR/Manual/Overview.pod
Original file line number Diff line number Diff line change
Expand Up @@ -174,8 +174,8 @@ order yourself

=item *

allows you to write methods which address an object individually, with some
ways to avoid tons of individual database queries
allows you to write methods which address an object individually, with
ways to avoid many individual database queries

=item *

Expand All @@ -198,10 +198,6 @@ the cache by setting object count limits explicitly
there is CPU overhead checking the cache if you really are always going
directly to the database

=item *

Joins must be pre-declared through the class definition system

=back

=head1 Class Definitions
Expand Down

0 comments on commit eb30e9c

Please sign in to comment.