Click above to get retro games delivered to your door ever month!

           Commenting Style


     If you have looked at the source code for  the  class  libraries,
     you may have noticed that the style used to comment the  files is
     different from the style with which you are  familiar.   Although
     the  style  may  seem  confusing  at first, it has an  underlying
     structure and organization which makes the job of documenting and
     maintaining of  large programs easier.  In addition, the comments
     help  the  reader  who is unfamiliar with the capabilities of the
     library make sense of the overwhelming amount of code available.

     The following paragraphs outline the  structure  of  each  of the
     major divisions which make up a source file.  You  are encouraged
     to  examine  the  source  code  to learn how these divisions  fit
     together in a source file.