OASIS Open Document Format for Office Applications (OpenDocument) TC

  • 1.  ODF CD01: Responses to editorial notes in the graphics chapter

    Posted 03-09-2009 15:37
    Patrick,
    
    please find attached a cd01 with responses to some of the editorial 
    notes from my colleagues Christian Lippka and Sven Jacobi.
    
    Best regards
    
    Michael
    
    -- 
    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] ODF CD01: Responses to editorial notes in the graphicschapter

    Posted 03-12-2009 00:22
    Michael,
    
    Thanks!
    
    I do have some follow up questions:
    
    dr3d:lighting-mode, when used with 3D objects, we now say:
    
    > The |dr3d:lighting-mode| attribute specifies the lighting algorithm 
    > used to render a 3D object.
    >
    > The value of this attribute can be |standard| or |double-sided|. If 
    > the value is |double-sided|, the reverse sides of the object are also 
    > lighted.
    >
    My note and the response:
    
    > Ed. Note We should define “standard” in some meaningful way.
    >
    > CL: “standard” should have named “single-sided” as it is the oposite 
    > of “double-sided”, meaning that only front faces will be lit. Readers 
    > with 3D knowledge will know what a front face is, others will not care 
    > much...
    >
    Actually there is a more difficult problem than standard vs. double-sided.
    
    Note first sentence says that the attribute "specifies the lighting 
    algorithm...."
    
    We then say: "this attribute can be standard or double-sided."
    
    And those are in fact the only values for this attribute.
    
    I suppose one could argue that "specifies" means to choose between 
    algorithms that illuminate the face of an object versus both sides 
    rather than naming an algorithm but that sounds weak to me.
    
    Suggest:
    
    *****
    The dr3d:lighting mode attribute specifies the illumination of a 3D object.
    
    The dr3d:lighting-mode attribute values are:
    
    * standard - front face of an object is illuminated
    
    * double-sided - front and reverse sides of an object are illuminated
    *****
    
    **************************
    
    18.134 draw:corner-radius
    
    Now reads:
    
    > The |draw:corner-radius| attribute specifies the radius of the circle 
    > used to round off the corners of a caption |