X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~yarrgweb/git?a=blobdiff_plain;f=yarrg%2FCommods.pm;fp=yarrg%2FCommods.pm;h=f74571ddd39c6c5093902c51aae03969cb780532;hb=7135d15a2b4db9ac5caedd4730ccbf29fa55d15d;hp=372fe16f51544081e9378d68563a91a5b38868df;hpb=5d0464f2c9179b24f3caa06cd0ac2132dfd8175f;p=ypp-sc-tools.db-test.git

diff --git a/yarrg/Commods.pm b/yarrg/Commods.pm
index 372fe16..f74571d 100644
--- a/yarrg/Commods.pm
+++ b/yarrg/Commods.pm
@@ -51,7 +51,33 @@ BEGIN {
     @EXPORT_OK   = qw();
 }
 
-our $masterinfoversion= 2; # version we understand
+our $masterinfoversion= 2; # version we understand.
+#
+# To extend the source-info.txt format:
+#
+#    * Commods.pm:parse_info1
+#       add code to parse new version
+#
+#    * source-info.txt
+#       add new information
+#
+# If new data should NOT be in master-info.txt too:
+#
+#    * update-master-info:process_some_info
+#       check that code for converting source-info to master-info
+#       removes the extra info; add code to remove it if necessary
+#
+#    * db-idempotent-populate
+#       if database schema is extended, add code to copy data
+#
+# If new data DOES need to be in master-info.txt too:
+#
+#    * Commods.pm:$masterinfoversion
+#       increment
+#
+#    * update-master-info:process_some_info
+#       add code to convert new version to old, by removing
+#       extra info conditionally depending on version
 
 our %oceans; # eg $oceans{'Midnight'}{'Ruby'}{'Eta Island'}= $sources;
 our %clients; # eg $clients{'ypp-sc-tools'}= [ qw(last-page) ];