OASIS Open Document Format for Office Applications (OpenDocument) TC

 View Only
  • 1.  Default values

    Posted 05-30-2008 12:37
    Dear TC members,
    
    we are currently using the a:defaultValue attribute specified by the
    Relax NG DTD Compatibility specification[1] to define the default values
    of many attributes. We recently received a comment from Murata Makoto
    that the use of a:defaultValue attributes in the ODF schema causes a
    ambiguity problem in the schema[2]. In addition, we currently do not
    explicitly state whether the ODF schema shall conform to the Relax NG
    DTD Compatibility attribute default value feature, or whether our use of
    a:defaultValue has only documentation purposes. The later I think is
    what actually was intended.
    
    However, I would like to propose that we follow the proposal that
    Murata Makoto has made in his comment. That means that we remove all 
    a:defaultValue attributes from the schema, and instead add a sentence 
    like the one below to the sections that describe the attributes:
    
    "If the attribute is not specified, conforming applications *should*
    behave as if the attribute has the value "[default value]".
    
    This sentence is only a suggestion. Alternative suggestion are welcome.
    
    I further would like to suggest that we don't change the schema and 
    specification manually, but by an XSLT stylesheet. If the TC accepts 
    this proposal, I volunteer to develop this stylesheet.
    
    If we adapt the schema as proposed, we may either explicitly state that 
    the ODF schema conforms to the attribute default value feature defined 
    by the Relax NG DTD Compatibility specification, or we may omit the 
    reference to the Relax NG DTD Compatibility specification for default 
    values (We  may however want to reference it for ID/IDREF behavior. I 
    will cover that by a different mail next week. What I want to say here 
    is that if we only look at the default value topic, both would be possible).
    
    Best regards
    
    Michael
    
    P.S.: I have written this proposal as plain mail. If the TC follows 
    Rob's suggestion for using the Wiki instead, I will move this proposal 
    to the Wiki.
    
    [1] http://www.oasis-open.org/committees/relax-ng/compatibility.html
    [2] http://lists.oasis-open.org/archives/office-comment/200805/msg00014.html
    
    
    -- 
    Michael Brauer, Technical Architect Software Engineering
    StarOffice/OpenOffice.org
    Sun Microsystems GmbH             Nagelsweg 55
    D-20097 Hamburg, Germany          michael.brauer@sun.com
    http://sun.com/staroffice         +49 40 23646 500
    http://blogs.sun.com/GullFOSS
    
    Sitz der Gesellschaft: Sun Microsystems GmbH, Sonnenallee 1,
    	   D-85551 Kirchheim-Heimstetten
    Amtsgericht Muenchen: HRB 161028
    Geschaeftsfuehrer: Thomas Schroeder, Wolfgang Engels, Dr. Roland Boemer
    Vorsitzender des Aufsichtsrates: Martin Haering
    
    


  • 2.  Re: [office] Default values

    Posted 06-02-2008 22:49

    Michael.Brauer@Sun.COM wrote on 05/30/2008 08:36:00 AM:

    > Dear TC members,
    >
    > we are currently using the a:defaultValue attribute specified by the
    > Relax NG DTD Compatibility specification[1] to define the default values
    > of many attributes. We recently received a comment from Murata Makoto
    > that the use of a:defaultValue attributes in the ODF schema causes a
    > ambiguity problem in the schema[2]. In addition, we currently do not
    > explicitly state whether the ODF schema shall conform to the Relax NG
    > DTD Compatibility attribute default value feature, or whether our use of
    > a:defaultValue has only documentation purposes. The later I think is
    > what actually was intended.
    >
    > However, I would like to propose that we follow the proposal that
    > Murata Makoto has made in his comment. That means that we remove all
    > a:defaultValue attributes from the schema, and instead add a sentence
    > like the one below to the sections that describe the attributes:
    >
    > "If the attribute is not specified, conforming applications *should*
    > behave as if the attribute has the value "[default value]".
    >
    > This sentence is only a suggestion. Alternative suggestion are welcome.
    >


    +1.

    If we do the above I'd like us also to remove any reference to Relax NG DTD Compatibility from ODF 1.2.

    > I further would like to suggest that we don't change the schema and
    > specification manually, but by an XSLT stylesheet. If the TC accepts
    > this proposal, I volunteer to develop this stylesheet.
    >


    You are the ODF/XSLT Meister.  Someday you must give a presentation on the interesting tasks you have accomplished in this way.

    > If we adapt the schema as proposed, we may either explicitly state that
    > the ODF schema conforms to the attribute default value feature defined
    > by the Relax NG DTD Compatibility specification, or we may omit the
    > reference to the Relax NG DTD Compatibility specification for default
    > values (We  may however want to reference it for ID/IDREF behavior. I
    > will cover that by a different mail next week. What I want to say here
    > is that if we only look at the default value topic, both would be possible).
    >
    > Best regards
    >
    > Michael
    >
    > P.S.: I have written this proposal as plain mail. If the TC follows
    > Rob's suggestion for using the Wiki instead, I will move this proposal
    > to the Wiki.
    >
    > [1]
    http://www.oasis-open.org/committees/relax-ng/compatibility.html
    > [2]
    http://lists.oasis-open.org/archives/office-comment/200805/msg00014.html
    >
    >
    > --
    > Michael Brauer, Technical Architect Software Engineering
    > StarOffice/OpenOffice.org
    > Sun Microsystems GmbH             Nagelsweg 55
    > D-20097 Hamburg, Germany          michael.brauer@sun.com
    >
    http://sun.com/staroffice         +49 40 23646 500
    >
    http://blogs.sun.com/GullFOSS
    >
    > Sitz der Gesellschaft: Sun Microsystems GmbH, Sonnenallee 1,
    >       D-85551 Kirchheim-Heimstetten
    > Amtsgericht Muenchen: HRB 161028
    > Geschaeftsfuehrer: Thomas Schroeder, Wolfgang Engels, Dr. Roland Boemer
    > Vorsitzender des Aufsichtsrates: Martin Haering
    >
    >
    > ---------------------------------------------------------------------
    > To unsubscribe from this mail list, you must leave the OASIS TC that
    > generates this mail.  You may a link to this group and all your TCs in OASIS
    > at:
    >
    https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
    >


  • 3.  Re: [office] Default values

    Posted 06-09-2008 13:55
    Dir TC members,
    
    I have moved the proposal to the Wiki now using the new proposal form:
    
    http://wiki.oasis-open.org/office/proposal%3Adefault-values
    
    Rob: Using the template worked well. Two suggestions:
    
    We should consider to turn the template into a Wiki template so that it 
    becomes easier to create a new page from it. My understanding is that is 
    sufficient to rename it to a name which as the suffix .template.
    
    We should provide some guidelines regarding the names of the new pages.
    
    Michael
    
    
    
    
    
    Michael Brauer - Sun Germany - ham02 - Hamburg wrote:
    > Dear TC members,
    > 
    > we are currently using the a:defaultValue attribute specified by the
    > Relax NG DTD Compatibility specification[1] to define the default values
    > of many attributes. We recently received a comment from Murata Makoto
    > that the use of a:defaultValue attributes in the ODF schema causes a
    > ambiguity problem in the schema[2]. In addition, we currently do not
    > explicitly state whether the ODF schema shall conform to the Relax NG
    > DTD Compatibility attribute default value feature, or whether our use of
    > a:defaultValue has only documentation purposes. The later I think is
    > what actually was intended.
    > 
    > However, I would like to propose that we follow the proposal that
    > Murata Makoto has made in his comment. That means that we remove all 
    > a:defaultValue attributes from the schema, and instead add a sentence 
    > like the one below to the sections that describe the attributes:
    > 
    > "If the attribute is not specified, conforming applications *should*
    > behave as if the attribute has the value "[default value]".
    > 
    > This sentence is only a suggestion. Alternative suggestion are welcome.
    > 
    > I further would like to suggest that we don't change the schema and 
    > specification manually, but by an XSLT stylesheet. If the TC accepts 
    > this proposal, I volunteer to develop this stylesheet.
    > 
    > If we adapt the schema as proposed, we may either explicitly state that 
    > the ODF schema conforms to the attribute default value feature defined 
    > by the Relax NG DTD Compatibility specification, or we may omit the 
    > reference to the Relax NG DTD Compatibility specification for default 
    > values (We  may however want to reference it for ID/IDREF behavior. I 
    > will cover that by a different mail next week. What I want to say here 
    > is that if we only look at the default value topic, both would be 
    > possible).
    > 
    > Best regards
    > 
    > Michael
    > 
    > P.S.: I have written this proposal as plain mail. If the TC follows 
    > Rob's suggestion for using the Wiki instead, I will move this proposal 
    > to the Wiki.
    > 
    > [1] http://www.oasis-open.org/committees/relax-ng/compatibility.html
    > [2] 
    > http://lists.oasis-open.org/archives/office-comment/200805/msg00014.html
    > 
    > 
    
    
    -- 
    Michael Brauer, Technical Architect Software Engineering
    StarOffice/OpenOffice.org
    Sun Microsystems GmbH             Nagelsweg 55
    D-20097 Hamburg, Germany          michael.brauer@sun.com
    http://sun.com/staroffice         +49 40 23646 500
    http://blogs.sun.com/GullFOSS
    
    Sitz der Gesellschaft: Sun Microsystems GmbH, Sonnenallee 1,
    	   D-85551 Kirchheim-Heimstetten
    Amtsgericht Muenchen: HRB 161028
    Geschaeftsfuehrer: Thomas Schroeder, Wolfgang Engels, Dr. Roland Boemer
    Vorsitzender des Aufsichtsrates: Martin Haering
    


  • 4.  Re: [office] Default values

    Posted 06-10-2008 03:13

    Michael.Brauer@Sun.COM wrote on 06/09/2008 09:55:11 AM:

    > Dir TC members,
    >
    > I have moved the proposal to the Wiki now using the new proposal form:
    >
    >
    http://wiki.oasis-open.org/office/proposal%3Adefault-values
    >
    > Rob: Using the template worked well. Two suggestions:
    >
    > We should consider to turn the template into a Wiki template so that it
    > becomes easier to create a new page from it. My understanding is that is
    > sufficient to rename it to a name which as the suffix .template.
    >
    > We should provide some guidelines regarding the names of the new pages.
    >
    > Michael
    >

    The Rename Page menu option in the Wiki is always greyed out for me -- I cannot select it.  But I did create a new version of that page and called it "ProposalTemplate" and that made it into a page template.

    -Rob