Changeset - 6235e830db2d
[Not reviewed]
default
0 5 0
Nathan Brink (binki) - 14 years ago 2011-04-16 00:04:29
ohnobinki@ohnopublishing.net
Doxygenize some of the documentation.
5 files changed with 30 insertions and 28 deletions:
0 comments (0 inline, 0 general)
inc/class.course.inc
Show inline comments
 
@@ -18,14 +18,17 @@
 
 * along with SlatePermutate.  If not, see <http://www.gnu.org/licenses/>.
 
 */
 

	
 
/**
 
 * \file
 
 *    This file represents a course (formerly class). It stores
 
 *    the section associated with the course.
 
 */
 

	
 
include_once 'class.section.php';
 

	
 
/**
 
 * \brief
 
 *   Represents a Course containing multiple Sections.
 
 *
 
 * A course is associated with a certain subject material. For each
 
 * course, a student has to choose a particular Section to
 
 * take. Courses are not associated with professors or meeting times,
 
 * those are in the realm of the Section and SectionMeeting.
 
 */
 
class Course implements IteratorAggregate
 
{
 
  private $name;	// String
inc/class.page.php
Show inline comments
 
@@ -55,13 +55,14 @@ if (file_exists($config_inc)) {
 
}
 

	
 

	
 
//**************************************************
 
// class.page.php   Author: Ethan Zonca
 
//
 
// Provides an interface for generating a styled
 
// XHTML page, supporting modular script inclusion
 
// and other various features
 
//**************************************************
 
/**
 
 * \brief
 
 *   Produces XHTML output for the user and helps with other browser
 
 *   interaction.
 
 *
 
 * Supports styled XHTML pages, modular script inclusion, and other
 
 * various features.
 
 */
 
class page
 
{
 

	
inc/class.schedule.php
Show inline comments
 
@@ -18,14 +18,6 @@
 
 * along with SlatePermutate.  If not, see <http://www.gnu.org/licenses/>.
 
 */
 

	
 
//**************************************************
 
// class.schedule.php	Author: Nathan Gelderloos
 
//
 
// Represents a schedule of a week. Stores the
 
// classes that are part of that week and calculates
 
// all the possible permutations.
 
//**************************************************
 

	
 
$incdir = dirname(__FILE__) . DIRECTORY_SEPARATOR;
 
include_once $incdir . 'class.course.inc';
 
include_once $incdir . 'class.section.php';
 
@@ -38,6 +30,14 @@ require_once $incdir . 'school.inc';
 
 */
 
require_once $incdir . 'class.classes_convert.inc';
 

	
 
/**
 
 * \brief
 
 *   Finds possible Section combinations for a user's given Courses
 
 *   and stores and displays the results.
 
 *
 
 * Represents a schedule of a week. Stores the classes that are part
 
 * of that week and calculates all the possible permutations.
 
 */
 
class Schedule
 
{
 
  /*
inc/class.section.php
Show inline comments
 
@@ -18,14 +18,12 @@
 
 * along with SlatePermutate.  If not, see <http://www.gnu.org/licenses/>.
 
 */
 

	
 
//--------------------------------------------------
 
// class.section.php  Author:Nathan Gelderloos
 
//
 
// Represents a section of a class.
 
//--------------------------------------------------
 

	
 
require_once dirname(__FILE__) . DIRECTORY_SEPARATOR . 'class.section_meeting.inc';
 
   
 
/**
 
 * \brief
 
 *   Represent a Section associated with a Course.
 
 */
 
class Section
 
{
 

	
inc/class.semester.inc
Show inline comments
 
@@ -24,7 +24,7 @@ require_once($inc_dir . 'class.section.p
 

	
 
/**
 
 * \brief
 
 *   Identifies a school semester and acts as a container for courses
 
 *   Identifies a school semester and acts as a container for Course s
 
 *   offered in a semester.
 
 */
 
class Semester
0 comments (0 inline, 0 general)