Re: Simulation Analysis in the User's guide - review needed

[Adrian Custer <acuster gmail com>]

Hey,

Again, thanks for all your work. 


The powers that be will have to think about your example spreadsheet.
I'm not sure how we could handle that: download from the web or
elsewhere.


I just downloaded your xml and ran it through xmllint which generates
lots of errors. It doesn't seem to follow the 4.3 dtd of docbook. 
        No declaration for element mathphrase 
        Element equation content does not follow the DTD
        Element listitem content does not follow the DTD
        Element inlineequation content does not follow the DTD
Those seem to be the bulk of the errors. Do you need a more recent
version of the docbook dtd for your chapter? If so, we will need to
check with gnome-docs what version they allow us to use these days. I
need the doc to pass xmllint cleanly to keep the manual manageable given
its size so we need to clean up your code even if we need to sacrifice
readability/elegance. I use:
        xmllint \
          --valid /usr/share/xml/docbook/schema/dtd/4.3/docbookx.dtd \
          --noout gnumeric.xml
which happens to be where the 4.3 dtd is on my machine.

Also, if you can set your tab space to 2, your document would conform to
the rest of the manual. XML becomes unmanageable with bigger indents. It
seems that you have not indented some of the lists but I haven't looked
at that in detail yet.

That's all at first glance. I hope I have commit access again to the svn
now so I can bring in your doc when I get it to validate. 

cheers,

--adrian



On Fri, 2008-08-22 at 07:21 -0700, Louis Luangkesorn wrote:
> I have the simulation chapter for the online help just about done
> (comments received, compile in dblatex, xmlto, yelp)
> <http://bugzilla.gnome.org/show_bug.cgi?id=540406>  
>
> Question:  I have a sample file that goes with the help chapter (it is
> the working example)
>     1.  Can I have this added to the 'samples' directory?'
>     2.  It is appropriate to refer to the sample file in the chapter?
>
> Louis
>
> "Do one thing every day that scares you." – Eleanor Roosevelt
>
>
>
> _______________________________________________
> gnumeric-list mailing list
> gnumeric-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnumeric-list