× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.



This issue is one reason I want source in the IFS to work better. Most other languages have solved this problem in two ways. First, by structuring their source projects in a hierarchical file system to keep like pieces together and with files named for their classes or functions. The second piece of this is a documentation tool that retrieves documentation from the source. In Java this is JDoc. I have not used RPGDoc, but I suspect it is similar. Continuous integration tools are used with other languages to ensure that, among other things, the docs are generated every time code is promoted. this is something that is generally missing in the RPG world.

Mark Murphy
Atlas Data Systems
mmurphy@xxxxxxxxxxxxxxx


-----Booth Martin <booth@xxxxxxxxxxxx> wrote: -----
To: Midrange Systems Technical Discussion <midrange-l@xxxxxxxxxxxx>
From: Booth Martin <booth@xxxxxxxxxxxx>
Date: 05/16/2017 01:45PM
Subject: Re: Service programs: navigation


This leads to another point that has bothered me. How is the inventory
of Service Program functions documented? How does a programmer
navigate through the dozens of service programs and find the one that is
exactly right? Or, not finding one exactly right, does s/he write a new
one, modify an existing one, or copy and change an existing one? In
early days that would seem like not much of a task, but after 8 years
and 15 different programmers involved, it must become a bird's nest?


On 5/16/2017 9:17 AM, Bradley Stone wrote:
Or this to really confuse some;)
useLargeTrailer = (ibeamWeight(material: length: width: height:
webThickness:flangeThickness) > smallTrailerWeightLimit);

I prefer this but it can make debugging a little hard (even with your
example) since you won't ever see the value ibeamWeight() returns.

Bradley V. Stone
www.bvstools.com
Native IBM i e-Mail solutions for Microsoft Office 365, Gmail, or any
Cloud Provider!


As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow-Ups:
Replies:

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2024 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.