Re: Assembly coding guidelines

Article View: bit.listserv.asm370

Article #329

Back to bit.listserv.asm370 Previous Next

#329

From: Paul Hanrahan
Date: Tue, 06 Sep 2005 11:41

29 lines
3000 bytes

I always tried to line things up with the previous lines contents when I
went to a second line.  Flower boxes can be very helpful if the comments are
maintained as the code ages and changes.

-----Original Message-----
From: IBM Mainframe Assembler List [mailto:ASSEMBLER-LIST@LISTSERV.UGA.EDU]
On Behalf Of Gerhard Postpischil
Sent: Monday, September 05, 2005 9:20 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: Assembly coding guidelines

Robert A. Rosenberg wrote:
> I was just pointing out that continuing the comment on the next card
> is a "solution" to the stated "problem" of the lack of space on the
> line due to other required data. If your comment needs to be
> x-characters long, what is the difference between it taking up one or
> two lines (the latter due to there not being enough room on the first
> line)?

The assembler is faster to work with due to the tabular form of its input
(and output). While continuations are sometimes unavoidable, they break the
visual flow. Voluminous comments look better in a "flower box" preceding a
group of lines, than as continued comments. At best, the continuation
comment should start after column 20 so as not to interfere with the
instruction column.

Gerhard Postpischil
Bradford, VT

Technical Details

Message-ID: <001b01c5b2d7$ec9b9860$8701a8c0@DGG2YZ51>

Path:

arc1-ca.pugleaf.net!g2news1.google.com!news1.google.com!news.maxwell.syr.edu!newsfeed.news.ucla.edu!newsfeed.berkeley.edu!ucberkeley!sn-xit-02!sn-xit-06!sn-xit-14!supernews.com!149.173.6.116.MISMATCH!foggy!vm.sas.com!sbcglobal.net!p_hanrahan

Show Full Headers

Complete Article Headers

X-Google-Thread: fcdcb,b5f541d74f4633a6
X-Google-Attributes: gidfcdcb,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: arc1-ca.pugleaf.net!g2news1.google.com!news1.google.com!news.maxwell.syr.edu!newsfeed.news.ucla.edu!newsfeed.berkeley.edu!ucberkeley!sn-xit-02!sn-xit-06!sn-xit-14!supernews.com!149.173.6.116.MISMATCH!foggy!vm.sas.com!sbcglobal.net!p_hanrahan
From: Paul Hanrahan <p_hanrahan@sbcglobal.net>
Newsgroups: bit.listserv.asm370
Subject: Re: Assembly coding guidelines
Date: Tue, 6 Sep 2005 07:41:30 -0400
Organization: SAS Inc.
Lines: 29
Sender: IBM Mainframe Assembler List <ASSEMBLER-LIST@LISTSERV.UGA.EDU>
Message-ID: <001b01c5b2d7$ec9b9860$8701a8c0@DGG2YZ51>
NNTP-Posting-Host: mozart.unx.sas.com
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Trace: foggy.unx.sas.com 1126006896 24998 10.19.150.41 (6 Sep 2005 11:41:36 GMT)
X-Complaints-To: usenet@unx.sas.com
NNTP-Posting-Date: Tue, 6 Sep 2005 11:41:36 +0000 (UTC)
Comments: Gated by NETNEWS@VM.SAS.COM
Return-Path: <owner-assembler-list@LISTSERV.UGA.EDU>
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook, Build 10.0.6626
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.2180
Importance: Normal
X-MIME-Autoconverted: from quoted-printable to 8bit by listserv.cc.uga.edu id
                      j86BfWJ3020127
Approved-By: Paul Hanrahan <p_hanrahan@SBCGLOBAL.NET>
In-Reply-To: <431C4605.5050101@valley.net>
Return-Path: owner-assembler-list@LISTSERV.UGA.EDU
X-OriginalArrivalTime: 06 Sep 2005 11:41:33.0751 (UTC)
                       FILETIME=[EE692C70:01C5B2D7]
X-Mime-Autoconverted: from 8bit to 7bit by mime827
Originator: daemon@mozart.unx.sas.com