home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / postquel / createversion < prev    next >
Encoding:
Text File  |  1992-08-27  |  1.7 KB  |  79 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/postquel/RCS/createversion,v 1.8 1992/07/14 06:05:40 ptong Exp $
  3. .SP "CREATE VERSION" COMMANDS 6/14/90
  4. .XA 2 "Create Version"
  5. .uh NAME
  6. .lp
  7. create version \*- construct a version class 
  8. .uh SYNOPSIS
  9. .lp
  10. .(l
  11. \fBcreate version\fR classname1 \fBfrom\fR classname2 [ \fB[\fR abstime \fB]\fR ]
  12. .)l
  13. .uh DESCRIPTION
  14. .lp
  15. This command creates a version class
  16. .i classname1
  17. which is related
  18. to its parent class,
  19. .i classname2 .
  20. Initially,
  21. .i classname1
  22. has the same contents as
  23. .i classname2.
  24. As updates to 
  25. .i classname1 
  26. occur, however,
  27. the contents of
  28. .i classname1
  29. diverges from
  30. .i classname2.
  31. On the other hand, any updates to
  32. .i classname2
  33. show transparently through
  34. to
  35. .i classname1 ,
  36. unless the instance in question has already been updated
  37. in
  38. .i classname1 .  
  39. .lp
  40. If the optional
  41. .i abstime
  42. clause is specified, then the version is
  43. constructed relative to a 
  44. .b snapshot
  45. of
  46. .i classname2
  47. as of the time specified.
  48. .lp
  49. \*(PP uses the query rewrite rule system to ensure that 
  50. .i classname1
  51. is differentially encoded relative
  52. to 
  53. .i classname2.  
  54. Moreover, 
  55. .i classname1
  56. is automatically constructed
  57. to have the same indexes as
  58. .i classname2 .
  59. It is legal to cascade versions
  60. arbitrarily, so a tree of versions can ultimately result.
  61. The algorithms that control versions are explained in [ONG90].
  62. .uh EXAMPLE
  63. .lp
  64. .ft C
  65. .nf
  66. /* create a version foobar from a snapshot of */
  67. /* barfoo as of January 17, 1990              */
  68.  
  69. create version foobar from barfoo [ "Jan 17 1990" ]
  70. .ft
  71. .uh "SEE ALSO"
  72. .lp
  73. merge(commands), define view(commands), postquel(commands).
  74. .lp
  75. .uh "BUGS"
  76. .lp
  77. Snapshots (i.e. the optional abstime specifications) have not yet been
  78. implemented.
  79.