RE: list function from FTPAPI_H

[Terrence Enger <tenger@xxxxxxxxxxxxxxxx>]

On Mon, 2009-11-02 at 22:44 -0600, Mike Krebs wrote:
> I think this is a great function. Scott, please consider including Terry's code 

Harrumph!  The "code" is just three CL commands.  And two of these deal with 
source colorization.  So, This is worth at most a paragraph in (README).

> and changes in the API. 

Scott,

How much store do you put in the format of comments in FTPAPI_H?  In particular, 
(*) The plus-sign boxing comments end at column 70, although other comments
    extend further.  Going further to the right would leave a few fewer line
    in FTPAPI_H and the listing.
(*) APIs FTP_url_get_raw, FTP_url_get, and FTP_Login have parentheses suffixed
    in the short summaries.  Is this significant?
(*) Do you value source colourization?  It adds a couple of lines to the work
    of listing the short summaries.

Cheers,
Terry.


> 
> Mike Krebs
> 
> > -----Original Message-----
> > From: ftpapi-bounces@xxxxxxxxxxxxxxxxxxxxxx [mailto:ftpapi-
> > bounces@xxxxxxxxxxxxxxxxxxxxxx] On Behalf Of Terrence Enger
> > Sent: Saturday, October 31, 2009 2:37 PM
> > To: ftpapi@xxxxxxxxxxxxxxxxxxxxxx
> > Subject: list function from FTPAPI_H
> > 
> > Greetings,
> > 
> > One of the first things I wanted when I started to look at ftpapi
> > is a list of available functions.  Having screwed up a couple of
> > attempts to extract the one- or two-line function summaries by
> > hand from QRPGLESRC(FTPAPI_H), I regularized those summaries and
> > then extracted them with a cpyf.  Is the result of any interest
> > to the project?
> > 
> > If I have overlooked existing documentation, this work is of
> > course useless.  The result is at best crude and ugly; output
> > attached.  Should it discourage a better solution, it would be
> > clearly detrimental.
> > 
> > Advice welcome.
> > 
> > Cheers,
> > Terry.
> > 
> 
> -----------------------------------------------------------------------
> This is the FTPAPI mailing list.  To unsubscribe, please go to:
> http://www.scottklement.com/mailman/listinfo/ftpapi
> -----------------------------------------------------------------------

-----------------------------------------------------------------------
This is the FTPAPI mailing list.  To unsubscribe, please go to:
http://www.scottklement.com/mailman/listinfo/ftpapi
-----------------------------------------------------------------------