Path: utzoo!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!uunet!shelby!agate!ucbvax!INDYCMS.BITNET!IQTI400
From: IQTI400@INDYCMS.BITNET (Phil Paxton)
Newsgroups: comp.lang.asm370
Subject: Re: programming style
Message-ID: <9102271407.AA27884@ucbvax.Berkeley.EDU>
Date: 27 Feb 91 13:58:38 GMT
References: <FERZAN@TREARN>
Sender: daemon@ucbvax.BERKELEY.EDU
Reply-To: IBM 370 Assembly Programming Discussion List
              <ASM370@OHSTVMA.BITNET>
Distribution: inet
Organization: The Internet
Lines: 18

On Wed, 27 Feb 91 09:12:01 TUR O said:
>          i never understand why everybody puts their comments
>          to the right hand side of program source,
>          but, me as an experienced programmer, i always put
>          comment as a topic, above the program source. example:
>******************************************************************************
>*         start program                                                      *
>******************************************************************************
>START     EQU   *
>

If you can write comments that are short, or stagger them across several
lines, it works well because you can read the code straight through and
not have to mentally filter out the comments.  Otherwise, you are reading
interchanged comments and code.

It's all a matter of personal preference, unless it's dictated by your
workplace.