[documentation] [Documentation bug] Doc for db_next_id should mention braces

[fgm]

Issue status update for 
http://drupal.org/node/85979
Post a follow up: 
http://drupal.org/project/comments/add/85979

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  fgm
 Updated by:   fgm
 Status:       active

For most situations, the format of the $name parameter to
db_next_id($name) should be: {sometable}_someid.


This rule is followed by all calls to db_next_id() in core, and part of
contrib. However, there are many contributed modules using the
non-prefixed form: sometable_someid instead, which can cause issues on
multisites.


This should be documented on the API page for db_next_id().




fgm