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

[Anish Karmarkar <Anish.Karmarkar@oracle.com>]

<pedantic>
I agree that encoding="ASCII" in our examples is a bad idea. But it 
should not be assumed that sticking UTF-8 necessarily solves all the 
problems of cut-paste-edit. The editor used may not recognize the XML 
encoding attribute (or is it pseudo-attribute?) and may save it in a 
non-UTF8 format. This (UTF-16) is actually not uncommon for say Japanese 
characters, where UTF-16 is preferred as it results in a smaller disk 
size for the file. If portability is a concern *and* if the XML decl is 
to be retained, we should not include the encoding pseudo-attribute at 
all. The assumption here being that in the cut-paste-edit scenario the 
editor would do the Right Thing wrt byte-order marks. I think this is a 
safer assumption.
</pedantic>

Something to be considered post-PR.

-Anish
--

David Booz wrote:
> 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
>  >
>