From 0544ad5b05e86d9f5c9fd6d55ff6cc1f2cb233c0 Mon Sep 17 00:00:00 2001 From: "Alex A. Naanou" Date: Thu, 20 Mar 2014 01:22:24 +0400 Subject: [PATCH] minor doc tweaks... Signed-off-by: Alex A. Naanou --- ui/data4.js | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/ui/data4.js b/ui/data4.js index 649779a7..fb77ae2a 100755 --- a/ui/data4.js +++ b/ui/data4.js @@ -4,11 +4,7 @@ * **********************************************************************/ -//var DEBUG = DEBUG != null ? DEBUG : true - - -/*********************************************************************/ -// Format version... +// General format info... // // version format: // . @@ -33,10 +29,10 @@ // - has no explicit version set, // - not used for real data. // 2.0 - Gen3 data format, still experimental, -// - completely and incompatibly new structure, +// - completely new and incompatible structure, // - use convertDataGen1(..) to convert Gen1 to 2.0 -// - auto-convert form gen1 on load... // - used for my archive, not public, +// - auto-convert form gen1 on load... // 2.1 - Minor update to format spec, // - MARKED now maintained sorted, live, // - will auto-sort marks on load of 2.0 data and change @@ -55,16 +51,16 @@ // conversion of 2.0 data. // NOTE: TAGS gid sets are still compact lists, thus are // actively maintained sorted. -// ...still thinking of whether making them sparse will -// take up too much memory, and is it worth the work... -// 3.0 - Gen4 format, introduced several backwards incompatible cahnges: +// ...still thinking of whether making them sparse is +// worth the work... +// 3.0 - Gen4 DATA format, introduced several backwards incompatible +// cahnges: // - added ribbon GIDs, .ribbons now is a gid indexed object // - added .ribbon_order // - added base ribbon // - ribbons are now sparse in memory but can be compact when // serialized. -// NOTE: these changes apply only to the DATA structure and -// serialization. +// - auto-convert from gen1 (no version) and gen3 (2.*) on load // // // NOTE: Gen1 and Gen3 refer to code generations rather than data format @@ -72,6 +68,12 @@ // (PortableMag) started on the same code base as ImageGrid.Viewer // generation 1 and advanced from there... + + +/*********************************************************************/ + +// Data class methods and API... +// var DataClassPrototype = { // NOTE: we consider the input list sorted... fromList: function(list){ @@ -90,6 +92,9 @@ var DataClassPrototype = { } + +// Data object methods and API... +// var DataPrototype = { // DATA structure: // .current @@ -863,6 +868,9 @@ var DataPrototype = { } + +// Main Data object... +// function Data(json){ if(this.constructor.name != 'Data'){ obj = new Data