Re: [sca-bindings] Comments on CD02-rev5 binding.jms

[David Booz <booz@us.ibm.com>]

I agree, we could have just removed the entire line and it wouldn't harm the example. The fact that it was an example may lead someone to copy/paste it and then later get surprised by the encoding as they modify it. If the line is there, I think it's a better practice to make it portable.

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

Anish Karmarkar <Anish.Karmarkar@oracle.com> wrote on 06/24/2009 05:30:16 PM:

> [image removed]
>
> Re: [sca-bindings] Comments on CD02-rev5 binding.jms
>
> Anish Karmarkar
>
> to:
>
> sca-bindings
>
> 06/24/2009 05:30 PM
>
> David Booz wrote:
> > Hi Simon,
> >
> > 1) Was bindings-74 fully applied? I think the folllowing is missing:
> > Change sentence: MUST comply with all the applicable requirements
> > specified in this specification." to -> "MUST comply with all statements
> > in Appendix B: Conformance Items related to elements and attributes in
> > an SCA JMS Binding XML document, notably all "MUST" statements have to
> > be implemented"
> >
> > 2) Section 3.1 links to Appendix A are broken "Error! Reference source
> > not found."
> >
> > 3) The examples have the following line "<?xml version=”1.0”
> > encoding=”ASCII”?>", it should be encoding="UTF-8"
> >
>
> Not sure why this change is needed. The examples don't contain any
> non-ASCII characters (maybe I missed it?) and ASCII is a subset of UTF-8.
> But of more important, as a general rule, I don't think we should
> include encoding in inlined text examples in any of our specs. It
> doesn't make a lot of sense.
> XML files without encoding attribute on the XML declaration is valid and
> usually not necessary especially when BOM takes care of it.
>
> I'm not advocating any change at this stage. Just ranting.
>
> -Anish
> --
>
> > 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_holdsworth---06/24/2009 05:58:28
> > AM---The document named sca-jmsbinding-1.1-spec-cd02-rev5.pdf
> > simon_holdsworth---06/24/2009 05:58:28 AM---The document named
> > sca-jmsbinding-1.1-spec-cd02-rev5.pdf has been submitted by Mr. Simon
> > Holdsworth
> >
> >
> > From:  
> > simon_holdsworth@uk.ibm.com
> >
> > To:  
> > sca-bindings@lists.oasis-open.org
> >
> > Date:  
> > 06/24/2009 05:58 AM
> >
> > Subject:  
> > [sca-bindings] Groups - sca-jmsbinding-1.1-spec-cd02-rev5.pdf uploaded
> >
> > ------------------------------------------------------------------------
> >
> >
> >
> > The document named sca-jmsbinding-1.1-spec-cd02-rev5.pdf has been submitted
> > by Mr. Simon Holdsworth to the OASIS Service Component Architecture /
> > Bindings (SCA-Bindings) TC document repository.
> >
> > Document Description:
> >
> >
> > View Document Details:
> > http://www.oasis-open.org/committees/document.php?document_id=33066
> >
> > Download Document:  
> > http://www.oasis-open.org/committees/download.php/33066/sca-
> jmsbinding-1.1-spec-cd02-rev5.pdf
> >
> >
> > PLEASE NOTE:  If the above links do not work for you, your email application
> > may be breaking the link into two pieces.  You may be able to copyand paste
> > the entire link address into the address field of your web browser.
> >
> > -OASIS Open Administration
> >
> >
>
> ---------------------------------------------------------------------
> 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
>