× 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.




On 24/12/2009, at 6:40 AM, Scott Klement wrote:

It disgusts me that IBM would post a dreadful example like this on their
web site. How many people will think this atrocity is proper code just
because IBM posted it?!

It's simply a lesson in not always looking for an example but rather using the documentation and writing it for yourself properly. The vast majority of the APIs are not difficult to use and any competent business programmer should have the skills necessary to write a program to use them from scratch. Even if you do need an example to shed some light then don't use the example as is--so many of them (and not just the IBM ones) are crappy, ugly code--but rather rewrite it. A beneficial learning experience will ensue.

I'll admit that some API documentation is obscure and some is incomplete and some is wrong but most of those things can be resolved via debug and examining the storage returned by the API. However, the documentation for the bulk of the APIs is accurate and straight-forward.

If anyone thinks the public documentation for APIs is bad then they should be grateful they don't need to use any "by permission only" APIs. Some of that documentation is truly woeful: inaccurate, incomplete, and doesn't reflect reality.

Regards,
Simon Coulter.
--------------------------------------------------------------------
FlyByNight Software OS/400, i5/OS Technical Specialists

http://www.flybynight.com.au/
Phone: +61 2 6657 8251 Mobile: +61 0411 091 400 /"\
Fax: +61 2 6657 8251 \ /
X
ASCII Ribbon campaign against HTML E-Mail / \
--------------------------------------------------------------------




As an Amazon Associate we earn from qualifying purchases.

This thread ...

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.