more documentation for code in core

git-svn-id: file:///home/shish/svn/shimmie2/trunk@629 7f39781d-f577-437e-ae19-be835c7a54ca

core/block.class.php

@@ -1,4 +1,14 @@
 <?php
+/*
+ * A basic chunk of page
+ *  $header -- the block's title
+ *  $body   -- the content
+ *  $section -- where the block should be placed. The default theme supports
+ *              "main" and "left", other themes can add their own areas
+ *  $position -- how far down the section the block should appear, higher
+ *               numbers appear lower. The scale is 0-100 by convention,
+ *               though any number or string will work.
+ */
 class Block {
 	var $header;
 	var $body;
@@ -13,6 +23,11 @@ class Block {
 	}
 }
 
+
+/*
+ * A generic navigation block with a link to the main page. Used
+ * because "new NavBlock()" is easier than "new Block('Navigation', ..."
+ */
 class NavBlock extends Block {
 	public function NavBlock() {
 		$this->header = "Navigation";