Index: openacs-4/packages/acs-content-repository/www/doc/guide/revisions.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-content-repository/www/doc/guide/revisions.adp,v diff -u -r1.3 -r1.4 --- openacs-4/packages/acs-content-repository/www/doc/guide/revisions.adp 7 Aug 2017 23:47:47 -0000 1.3 +++ openacs-4/packages/acs-content-repository/www/doc/guide/revisions.adp 30 Apr 2018 08:15:07 -0000 1.4 @@ -25,14 +25,12 @@ content_revision.new function. The only parameters required to create the revision are a title, a content item ID, and some text:
--revision_id := content_revision.new( +revision_id := content_revision.new( title => 'A Revision', item_id => :item_id, text => 'Once upon a time Goldilocks crossed the street. Here comes a car...uh oh! The End' -); -+);
The item_id parameter is ID of the content item with which the revision is associated.
The content_item.new function accepts a number of @@ -43,8 +41,7 @@ Instead of the text parameter, this function can be called with a data parameter, in which data is a blob:
--revision_id := content_revision.new( +revision_id := content_revision.new( title => 'A Revision', description => 'A Description of a revision', mime_type => 'text/html', @@ -54,8 +51,7 @@ creation_date => sysdate, creation_user => :user_id, creation_ip => :ip_address -); -+);
Given that there is no way (AFAIK) to pass variable parameters to a PL/SQL function, there is no way to make @@ -82,43 +78,35 @@ content_type.create_attribute. The trigger makes it possible to create complete revisions with a single insert statement:
--insert into cr_revisionsx ( +insert into cr_revisionsx ( item_id, revision_id, title ) values ( 18, 19, 'All About Revisions' -); -+);
Because a special trigger is generated for each content type that includes insert statements for all inherited tables, revisions with extended attributes may be created in the same fashion:
--insert into cr_imagesx ( +insert into cr_imagesx ( item_id, revision_id, title, height, width ) values ( 18, 19, 'A Nice Drawing', 300, 400 -); -+);
The live revision of a content item can be obtained with the content_item.get_live_revision function:
--live_revision_id := content_item.get_live_revision( +live_revision_id := content_item.get_live_revision( item_id => :item_id -); -+);
The item_id identifies the content item with which the revision is associated.
Likewise, the most recent revision of a content item can be obtained with the content_item.get_latest_revision function:
--latest_revision_id := content_item.get_latest_revision( +latest_revision_id := content_item.get_latest_revision( item_id => :item_id -); -+);
Last Modified: $Id: revisions.html,v 1.1.1.1.30.1 2016/06/22 -07:40:41 gustafn Exp $
+Last Modified: $Id: revisions.html,v 1.2 2017/08/07 23:47:47 +gustafn Exp $