[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [sca-j] Java CI spec - up to date issues applied
Dave, The example code in chapter 5 of the PDF (lines 290-336) has a lot of text underlined that should not be underlined. This problem also occurs in line 343. I checked back a few versions and this problem goes back at least to WD10. Simon David Booz wrote: > Thanks very much for figuring out Word. From the doc you posted, I was > able to run it through pdfmaker to produce the attached, with links that > work! > > /(See attached file: sca-javaci-1.1-spec-wd10-fixed_withLinks.pdf)/ > > Dave Booz > STSM, BPM and SCA Architecture > Co-Chair OASIS SCA-Policy TC and SCA-J TC > "Distributed objects first, then world hunger" > Poughkeepsie, NY (845)-435-6093 or 8-295-6093 > e-mail:booz@us.ibm.com > > Inactive hide details for Simon Nash ---05/02/2009 05:38:17 PM---Dave, > Anish, I think I have fixed the formatting and printing Simon Nash > ---05/02/2009 05:38:17 PM---Dave, Anish, I think I have fixed the > formatting and printing problems. In the > > > From: > Simon Nash <oasis@cjnash.com> > > To: > Anish Karmarkar <Anish.Karmarkar@oracle.com> > > Cc: > David Booz/Poughkeepsie/IBM@IBMUS, sca-j@lists.oasis-open.org > > Date: > 05/02/2009 05:38 PM > > Subject: > Re: [sca-j] Java CI spec - up to date issues applied > > ------------------------------------------------------------------------ > > > > Dave, Anish, > I think I have fixed the formatting and printing problems. In the > process of doing this, I learned more about Word formatting and > indentation than I ever wanted to know, so I went on to put my > newly-acquired knowledge to good use by formatting all the code, > bulleted lists, and numbered lists using consistent indentation > and style. > > I also fixed some problems with the Javadoc comments in section 5 > and section 8.4 (should use "*" as continuation character when > the comment is longer than one line). > > The Word and PDF files are attached. These match each other in > formatting and line numbering. > > Simon > > Anish Karmarkar wrote: > > For whatever reason I don't see the problem that you mention in PDF > > generation. And my line numbers match between PDF and word. Either what > > I'm seeing in my version of Word does not match with what you see in > > your version of Word (wrt indentation) OR I'm seeing the right > > indentation in Word and therefore generating the correct PDF. > > > > The PDF is attached; can someone verify for me if this has the right > > indentation, please. If my PDF is correct then we can solve this problem > > by having me generate the PDF. If not then we'll have to start from a > > new OASIS word template and start cut-and-pasting as suggested. > > > > -Anish > > -- > > > > David Booz wrote: > >> That's right, but what also happens is that the bulleted lists in the > >> section 5 conformance statements have incorrect indentation. That's > >> what I don't know how to fix. > >> > >> I'm afraid the only way to fix this is going to be to cut/paste-text > >> -only into a new OASIS Word template. I don't have the time to attempt > >> something like that right now. > >> > >> Dave Booz > >> STSM, BPM and SCA Architecture > >> Co-Chair OASIS SCA-Policy TC and SCA-J TC > >> "Distributed objects first, then world hunger" > >> Poughkeepsie, NY (845)-435-6093 or 8-295-6093 > >> e-mail:booz@us.ibm.com > >> > >> Inactive hide details for Simon Nash ---04/30/2009 04:05:32 PM---David > >> Booz wrote: > There seem to be some indentation/formattiSimon Nash > >> ---04/30/2009 04:05:32 PM---David Booz wrote: > There seem to be some > >> indentation/formatting differences between the > >> > >> > >> From: > >> Simon Nash <oasis@cjnash.com> > >> > >> To: > >> sca-j@lists.oasis-open.org > >> > >> Date: > >> 04/30/2009 04:05 PM > >> > >> Subject: > >> Re: [sca-j] Java CI spec - up to date issues applied > >> > >> ------------------------------------------------------------------------ > >> > >> > >> > >> David Booz wrote: > >> > There seem to be some indentation/formatting differences between the > >> > word and pdf formats and some strange interactions between pdfmaker > >> and > >> > print to pdf. Believe it or not, when I run pdfmaker over this > >> document, > >> > it just dies right at the end and doesn't produce a pdf file. When > >> I try > >> > to print to pdf, the word file is actually modified (which screws > >> up the > >> > formatting) making the word and pdfs different (but only in > >> formatting, > >> > not in content). I'm frustrated and am giving up for now on the > >> > formatting situation as I don't know how to resolve it. If someone > >> else > >> > can look at this, I'd appreciate it. > >> > > >> I tried all kinds of combinations and I saw exactly what you are > >> seeing every time. It was impossible to print the document to PDF > >> without it being reformatted and the line numbers changing. > >> > >> The only way I found to get the numbers to match was to save the > >> reformatted document after printing. If I then reopen this saved > >> Word doc, the numbers in the Word doc will match the numbers in > >> the PDF. > >> > >> Simon > >> > >> > Now as for the comments: > >> > - I could not figure out how to (reliably) indent all text under the > >> > major headings, so instead I un-indented everything to match chaps > >> 8-11. > >> > In trying to make Chap 8 indented like the rest of the document, all > >> > kinds of strange formatting problems cropped up, so that's why I > >> decided > >> > to un-indent everything. This had the effect of changing line numbers > >> > all over the place. > >> > > >> > For the remaining comments, using the line numbers from your email, > >> this > >> > leaves: > >> > -779, 827 which I fixed > >> > - 65, 96 are the only ones that need the package definition so I only > >> > added those two. > >> > - 234, fixed > >> > - 295, 306 fixed > >> > - 908 fixed > >> > > >> > I left change tracking on for wd10 and did NOT accept wd09 > updates, so > >> > marked changes include those made in wd09. > >> > > >> > > >> > http://www.oasis-open.org/committees/download.php/32340/sca-javaci-1.1-spec-wd10.doc > >> > >> > > >> > I did not produce a pdf as a result of the aforementioned formatting > >> > problems. > >> > > >> > > >> > Dave Booz > >> > STSM, BPM and SCA Architecture > >> > Co-Chair OASIS SCA-Policy TC and SCA-J TC > >> > "Distributed objects first, then world hunger" > >> > Poughkeepsie, NY (845)-435-6093 or 8-295-6093 > >> > e-mail:booz@us.ibm.com > >> > > >> > Inactive hide details for "Mark Combellack" ---04/30/2009 08:21:17 > >> > AM---Hi Dave,"Mark Combellack" ---04/30/2009 08:21:17 AM---Hi Dave, > >> > > >> > > >> > From: > >> > "Mark Combellack" <mcombellack@avaya.com> > >> > > >> > To: > >> > David Booz/Poughkeepsie/IBM@IBMUS, <sca-j@lists.oasis-open.org> > >> > > >> > Date: > >> > 04/30/2009 08:21 AM > >> > > >> > Subject: > >> > RE: [sca-j] Java CI spec - up to date issues applied > >> > > >> > > >> ------------------------------------------------------------------------ > >> > > >> > > >> > > >> > Hi Dave, > >> > > >> > I have reviewed the updated WD09 of the C&I specification and > have the > >> > following review comments: > >> > > >> > *Editorial Comments* > >> > > >> > o Inconsistent indentation on the following lines: > >> > · Lines 2 – 11 > >> > · Lines 13 – 15 > >> > · Line 45 > >> > · Lines 267 – 271 > >> > · Lines 281 – 283 > >> > · Lines 373 – 650 – i.e. whole of chapter 8 > >> > · Lines 676 – 803 – i.e. whole of chapter 10 > >> > · Lines 779 – 791 – Consider indenting this list > >> > further than the paragraphs that surround it > >> > · Lines 827 – 841 - Consider indenting this list > >> > further than the paragraphs that surround it > >> > o Lines 65, 71, 96 & 121: Add “package services.hello;” > >> since > >> > composite XML in lines 83 – 90 has a package name > >> > o Line 234: Change method name to setMaxRetries to > match the > >> > variable name. Not strictly required but do we really > need > >> > to introduce an example at this point that shows > different > >> > method names/field names? > >> > o Split the code comments on the following lines onto > >> multiple > >> > lines as it splits in an untidy way: > >> > · Lines 295 – 296 > >> > · Lines 306 – 307 > >> > o Line 908 – Consider making the Conformance ID column > >> > narrower since there is a lot of unused whitespace in > >> the table > >> > > >> > > >> > Thanks, > >> > > >> > Mark > >> > Mark Combellack| Software Developer| Avaya | Eastern Business Park > >> | St. > >> > Mellons | Cardiff | CF3 5EA | Voice: +44 (0) 29 2081 7624 | > >> > _mcombellack@avaya.com_ <mailto:%7Cmcombellack@avaya.com> > >> > > >> ------------------------------------------------------------------------ > >> > *From:* David Booz [mailto:booz@us.ibm.com] * > >> > Sent:* 29 April 2009 16:21* > >> > To:* sca-j@lists.oasis-open.org* > >> > Subject:* Re: [sca-j] Java CI spec - up to date issues applied > >> > > >> > Simon, > >> > > >> > Thanks for the thorough review. I've made all the updates (and a few > >> > more that I spotted along the way) and published new documents. If > >> > anyone else has comments on WD08, no worries, I will fold them in > >> on top > >> > of this new WD09 draft and produce another set of documents. If you > >> > haven't started reviewing yet, WD09 is as good a place to start as > >> any. > >> > _ > >> > > >> > __http://www.oasis-open.org/committees/download.php/32313/sca-javaci-1.1-spec-wd09.doc__ > > >> > >> > > >> > __http://www.oasis-open.org/committees/download.php/32312/sca-javaci-1.1-spec-wd09.pdf_ > > >> > >> > > >> > > >> > Dave Booz > >> > STSM, BPM and SCA Architecture > >> > Co-Chair OASIS SCA-Policy TC and SCA-J TC > >> > "Distributed objects first, then world hunger" > >> > Poughkeepsie, NY (845)-435-6093 or 8-295-6093 > >> > e-mail:booz@us.ibm.com > >> > > >> > Inactive hide details for Simon Nash ---04/29/2009 05:22:04 > >> AM---Dave, I > >> > have reviewed this and I have a number of editorial coSimon Nash > >> > ---04/29/2009 05:22:04 AM---Dave, I have reviewed this and I have a > >> > number of editorial comments. I have > >> > > >> > > >> > From: > >> > Simon Nash <oasis@cjnash.com> > >> > > >> > To: > >> > sca-j@lists.oasis-open.org > >> > > >> > Date: > >> > 04/29/2009 05:22 AM > >> > > >> > Subject: > >> > Re: [sca-j] Java CI spec - up to date issues applied > >> > > >> > > >> ------------------------------------------------------------------------ > >> > > >> > > >> > > >> > > >> > Dave, > >> > I have reviewed this and I have a number of editorial comments. I > have > >> > recorded these as inline Word comments in the attached .doc file. > >> > > >> > Simon > >> > > >> > David Booz wrote: > >> > > Here are the links to a current Java CI spec. We have never > >> published a > >> > > CD of this spec, so please review it and all predecessors > >> carefully as > >> > > this is the basis for CD01 and PRD. The sooner you can review and > >> > > provide comments, the sooner I can fold in the changes and > >> re-publish. > >> > > > >> > > > >> > > >> > _http://www.oasis-open.org/committees/download.php/32270/sca-javaci-1.1-spec-wd08.doc_ > > >> > >> > > > >> > > > >> > > >> > _http://www.oasis-open.org/committees/download.php/32269/sca-javaci-1.1-spec-wd08.pdf_ > > >> > >> > > > >> > > > >> > > Dave Booz > >> > > STSM, BPM and SCA Architecture > >> > > Co-Chair OASIS SCA-Policy TC and SCA-J TC > >> > > "Distributed objects first, then world hunger" > >> > > Poughkeepsie, NY (845)-435-6093 or 8-295-6093 > >> > > e-mail:booz@us.ibm.com > >> > > > >> > > >> > [attachment "sca-javaci-1.1-spec-wd08+simon.doc" deleted by David > >> > Booz/Poughkeepsie/IBM] > >> > --------------------------------------------------------------------- > >> > To unsubscribe from this mail list, you must leave the OASIS TC that > >> > generates this mail. Follow this link to all your TCs in OASIS at:_ > >> > > >> > __https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php_ > >> > > >> > >> > >> > >> --------------------------------------------------------------------- > >> To unsubscribe from this mail list, you must leave the OASIS TC that > >> generates this mail. Follow this link to all your TCs in OASIS at: > >> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php > >> > >> > > > > ------------------------------------------------------------------------ > > > > --------------------------------------------------------------------- > > To unsubscribe from this mail list, you must leave the OASIS TC that > > generates this mail. Follow this link to all your TCs in OASIS at: > > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php > > [attachment "sca-javaci-1.1-spec-wd10-fixed.doc" deleted by David > Booz/Poughkeepsie/IBM] [attachment "sca-javaci-1.1-spec-wd10-fixed.pdf" > deleted by David Booz/Poughkeepsie/IBM] > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php > > > ------------------------------------------------------------------------ > > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]