Re: AW: Bug in docs...
Locked
 
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1 On Wed, 19 Feb 2003 20:10:53 +0100, [hidden email] wrote: Hallo Thomas, hello Mike, I second that. We have four employees learning NetRexx at the moment, so while going through with them it wouldn't be too much effort to correct and clearify things a bit... How did you write the current docs? Sat Srivastava has made a Windows .chm and a JavaHelp version of the docs; I would love to have these output options, still; it's a nice online help version with index search and such... Patric >Hello Mike, > is the source of those doc's available online so that we can update it to >the current state of the art ?? > I've found some other small points as well, but did simply 'circumvent' >them to get my stuff running.... > >But NOW there might be a good time to update doc's ( I still have heavy >usage on www.Rexxx2Nrx.com after you did announce it's free on your REXX >home page) >Crazy, why do all people only use software which is free nowadays? ???. >The good news are that Mr. Chip Davis, President of the REXX language >association, gave >Rexx2Nrx a whirl (as he is presenting Rexx2Nrx and Rony's BSF4REXX on the >IBM SHARE symposium 26.2.2003 (wow!!)) and was the FIRST one who DID >actually ask questions & provided info from testcases..... >Hence Rexx2Nrx release 4.02 will be released this weekend.... >Kind regards from dark Vienna, Tom. >> -----Ursprüngliche Nachricht----- >> Von: Mike Cowlishaw [SMTP:[hidden email]] >> Gesendet am: Mittwoch, 19. Februar 2003 17:26 >> An: Patric Bechtel >> Cc: [hidden email] >> Betreff: Re: Bug in docs... >> >> >> > just found a (small) bug in the documentation of NetRexx: >> > in the section "Exception and error handling" in the >> > quick start, the following code is shown: >> >> Quite right -- apologies. The 'quick start' was written before NetRexx >> did strict exception checking, and as I always expected to rewrite that >> document its examples never made it into the test suite. >> >> Amazing that no one else has reported this -- it's at least 5 years old... >> :-( >> >> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - >> Mike Cowlishaw, IBM Fellow >> IBM UK (MP5), PO Box 31, Birmingham Road, Warwick, CV34 5JL >> mailto:[hidden email] -- http://www2.hursley.ibm.com/decimal >> >> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >> ~~~ >> To unsubscribe from this mailing list ( ibm-netrexx ), please send a note >> to >> [hidden email] >> with the following message in the body of the note >> unsubscribe ibm-netrexx <e-mail address> >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to >[hidden email] >with the following message in the body of the note >unsubscribe ibm-netrexx <e-mail address> PGP Public Key Fingerprint: 2636 F26E F523 7D62 4377 D206 7C68 06BB -----BEGIN PGP SIGNATURE----- Version: PGPsdk version 1.7.1 (C) 1997-1999 Network Associates, Inc. and its affiliated companies. iQA/AwUBPlSnSHxoBrvMu8qQEQJpswCeKun3l/nrJXoHyKY8B0myWA0MzV4AmwWR b+rVwPW2llOhoFwH1SgGTqMT =pffK -----END PGP SIGNATURE----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to [hidden email] with the following message in the body of the note unsubscribe ibm-netrexx <e-mail address> |
|
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1 On Thu, 20 Feb 2003 11:22:32 +0000, Mike Cowlishaw wrote: Hello Mike, the docs are split into several parts, which is a bit confusing for beginners. Regarding the possibilities of the select clause eg, makes it complicated to estimate it's usage fully. Same for the if-comma- syntax, which can be confusing. The next thing is the options clause and visibility attributes for classes, interfaces and such. Putting this quite (for a beginner) complicated topic in several places is a bit hard. So it would be nice incorporate the supplement into the core docs; if I (or we, Thomas?) can help, tell us. Most of us work with one or more flavours of *ML... it would be nice it Sat could keep his Versions synced or even give the tools to generate them to you. BTW: How much work would it be to get the loop over functionality working on Collections? Are you still advancing the interpreter engine to make it more usable or was it a kind of technology demonstration? Patric >Your RuntimeException problem is the only bug I've had reported on the docs >which isn't already corrected on the versions on the website. If you have >any more, please let me know! >I will regenerate that document next time I am on a fast connection (the >formatting for the PDF is done on a mainframe, so needs upload/download). >The source for the documentation is GML, with a number of purpose-built >tags (e.g., HTML-like table definitions), so would be difficult for anyone >else to process. >Mike >- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - >Mike Cowlishaw, IBM Fellow >IBM UK (MP5), PO Box 31, Birmingham Road, Warwick, CV34 5JL >mailto:[hidden email] -- http://www2.hursley.ibm.com/decimal >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to >[hidden email] >with the following message in the body of the note >unsubscribe ibm-netrexx <e-mail address> PGP Public Key Fingerprint: 2636 F26E F523 7D62 4377 D206 7C68 06BB -----BEGIN PGP SIGNATURE----- Version: PGPsdk version 1.7.1 (C) 1997-1999 Network Associates, Inc. and its affiliated companies. iQA/AwUBPlTAsHxoBrvMu8qQEQI4tQCfeWcknnXjhZf3M/6V4WvrGnNrqbUAnjId 4tkn2V6BmSKxC27zUjIzymkc =WEYJ -----END PGP SIGNATURE----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to [hidden email] with the following message in the body of the note unsubscribe ibm-netrexx <e-mail address> |
|
|
In reply to this post by Patric Bechtel
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1 On Thu, 20 Feb 2003 14:30:10 +0000, Mike Cowlishaw wrote: Hello Mike, gulp. Does that man that Sat's nice JavaHelp version isn't allowed to be distributed? As it is a "used in another form"? I bought the book (and gifted it around :-)), btw, at least one thing to do to give SOME of the credits to whom it belongs... What about making an update, incorporating some more examples and publishing an update of the book? Others do that, too. Hm. Time constraints... you know my position on that topic. You still do not like lawyers, do you? Me too, btw :-) Patric >> So it would be nice incorporate the supplement into the core docs. >I agree, but the core doc is precisely the reference section from >the Prentice-Hall book. I don't have permission to use it in any >other form at the moment. Also some people have indicated that they >like to be able to see the enhancements from the book, but they mostly >just use what's in the book. >On updates .. something I definitely want to get back to, but at >the moment the decimal work is consuming rather more than my available >bandwidth.... >- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - >Mike Cowlishaw, IBM Fellow >IBM UK (MP5), PO Box 31, Birmingham Road, Warwick, CV34 5JL >mailto:[hidden email] -- http://www2.hursley.ibm.com/decimal PGP Public Key Fingerprint: 2636 F26E F523 7D62 4377 D206 7C68 06BB -----BEGIN PGP SIGNATURE----- Version: PGPsdk version 1.7.1 (C) 1997-1999 Network Associates, Inc. and its affiliated companies. iQA/AwUBPlTc5XxoBrvMu8qQEQKlfACdH1fV6GNEaho4l8HFI7s/STMMCz4AoIAM xZtiP5267DhQuz998/qtJ3Z8 =CyET -----END PGP SIGNATURE----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to [hidden email] with the following message in the body of the note unsubscribe ibm-netrexx <e-mail address> |
|
|
In reply to this post by Patric Bechtel
Hi,
Except for the free help compiler from Microsoft and Sun I am not using any
other tools
Syncing up the help files wouldn't be a big deal.
I will do so whenever the docs are updated.
Thanks
Sat
>>> "Patric Bechtel" <[hidden email]> 02/20/03 06:49AM >>> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Thu, 20 Feb 2003 11:22:32 +0000, Mike Cowlishaw wrote: Hello Mike, the docs are split into several parts, which is a bit confusing for beginners. Regarding the possibilities of the select clause eg, makes it complicated to estimate it's usage fully. Same for the if-comma- syntax, which can be confusing. The next thing is the options clause and visibility attributes for classes, interfaces and such. Putting this quite (for a beginner) complicated topic in several places is a bit hard. So it would be nice incorporate the supplement into the core docs; if I (or we, Thomas?) can help, tell us. Most of us work with one or more flavours of *ML... it would be nice it Sat could keep his Versions synced or even give the tools to generate them to you. BTW: How much work would it be to get the loop over functionality working on Collections? Are you still advancing the interpreter engine to make it more usable or was it a kind of technology demonstration? Patric >Your RuntimeException problem is the only bug I've had reported on the docs >which isn't already corrected on the versions on the website. If you have >any more, please let me know! >I will regenerate that document next time I am on a fast connection (the >formatting for the PDF is done on a mainframe, so needs upload/download). >The source for the documentation is GML, with a number of purpose-built >tags (e.g., HTML-like table definitions), so would be difficult for anyone >else to process. >Mike >- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - >Mike Cowlishaw, IBM Fellow >IBM UK (MP5), PO Box 31, Birmingham Road, Warwick, CV34 5JL >[hidden email] -- http://www2.hursley.ibm.com/decimal >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to >[hidden email] >with the following message in the body of the note >unsubscribe ibm-netrexx <e-mail address> PGP Public Key Fingerprint: 2636 F26E F523 7D62 4377 D206 7C68 06BB -----BEGIN PGP SIGNATURE----- Version: PGPsdk version 1.7.1 (C) 1997-1999 Network Associates, Inc. and its affiliated companies. iQA/AwUBPlTAsHxoBrvMu8qQEQI4tQCfeWcknnXjhZf3M/6V4WvrGnNrqbUAnjId 4tkn2V6BmSKxC27zUjIzymkc =WEYJ -----END PGP SIGNATURE----- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to [hidden email] with the following message in the body of the note unsubscribe ibm-netrexx <e-mail address> |
|
|
In reply to this post by Patric Bechtel
Hi,
Apart from the free help compiler from Microsoft and Sun I am not using any tool. Keeping the docs in sync shouldnot be a big deal. I would do this whenever the docs are updated. Thanks Sat ----- Original Message ----- From: "Patric Bechtel" <[hidden email]> To: "Mike Cowlishaw" <[hidden email]> Cc: <[hidden email]> Sent: Thursday, February 20, 2003 6:49 AM Subject: Re: AW: Bug in docs... > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > On Thu, 20 Feb 2003 11:22:32 +0000, Mike Cowlishaw wrote: > > Hello Mike, > > the docs are split into several parts, which is a bit confusing for > beginners. Regarding the possibilities of the select clause eg, makes > it complicated to estimate it's usage fully. Same for the if-comma- > syntax, which can be confusing. > The next thing is the options clause and visibility attributes for > classes, interfaces and such. Putting this quite (for a beginner) > complicated topic in several places is a bit hard. > So it would be nice incorporate the supplement into the core docs; > if I (or we, Thomas?) can help, tell us. Most of us work with one > or more flavours of *ML... it would be nice it Sat could keep his > Versions synced or even give the tools to generate them to you. > > BTW: How much work would it be to get the loop over functionality > working on Collections? > Are you still advancing the interpreter engine to make it more usable > or was it a kind of technology demonstration? > > Patric > > > >Your RuntimeException problem is the only bug I've had reported on the > >which isn't already corrected on the versions on the website. If you have > >any more, please let me know! > > >I will regenerate that document next time I am on a fast connection (the > >formatting for the PDF is done on a mainframe, so needs upload/download). > > >The source for the documentation is GML, with a number of purpose-built > >tags (e.g., HTML-like table definitions), so would be difficult for anyone > >else to process. > > >Mike > > > >- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - > >Mike Cowlishaw, IBM Fellow > >IBM UK (MP5), PO Box 31, Birmingham Road, Warwick, CV34 5JL > >mailto:[hidden email] -- http://www2.hursley.ibm.com/decimal > > >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > >To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to > >[hidden email] > >with the following message in the body of the note > >unsubscribe ibm-netrexx <e-mail address> > > > > > PGP Public Key Fingerprint: 2636 F26E F523 7D62 4377 D206 7C68 06BB > > -----BEGIN PGP SIGNATURE----- > Version: PGPsdk version 1.7.1 (C) 1997-1999 Network Associates, Inc. and > > iQA/AwUBPlTAsHxoBrvMu8qQEQI4tQCfeWcknnXjhZf3M/6V4WvrGnNrqbUAnjId > 4tkn2V6BmSKxC27zUjIzymkc > =WEYJ > -----END PGP SIGNATURE----- > > > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~ > To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to > [hidden email] > with the following message in the body of the note > unsubscribe ibm-netrexx <e-mail address> > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To unsubscribe from this mailing list ( ibm-netrexx ), please send a note to [hidden email] with the following message in the body of the note unsubscribe ibm-netrexx <e-mail address> |
«
Return to ibm-netrexx
|
1 view|%1 views
| Free forum by Nabble | Edit this page |