// In Order to create a good, usable program
// comments are an absolute necessity
// comments are marked off by two forward slashes
/*
   or by a forward slash, asterick
   close by an asterick, forward slash
*/

// Comments are used in order to tell another person
// or programmer what is going on inside your program
// especially if there is a tricky section
// or a variable is defined
// you must not only give the variable a good name
// but you should tell what it's going to be used for
// same with new functions
// they should be properly described before they're created

// Comments are not read by the compiler
// they are simply just skipped over
// they are only used for others to read

// Look at the following short program and notice are comments
// are properly and well used...


// Name: Justin C. Miller
// Date: 1-18-2001
// Class: Computer Science
// Title: Assignment 0
// Description: This program is showing
//				How to properly use comments

int addAandB(int, int) ;  // addition function

int main()
{
	int a = 7 ;  // variable a = 7
	int b = 10 ; // variable b = 10
	int c = addAandB(a, b) ; // c = a + b
	cout << "a = " << a << endl ;  // print a
	cout << "b = " << b << endl ;  // print b
	cout << "a + b = c = " << c << endl ;  // print c

	return 0 ;  // good bye!
}

// addAandB(int, int)
// pre - this function brings in two integers, A and B
// post - this function returns the sum of A and B
int addAandB(int A, int B)
{
	return (A + B) ;
}