[prev in list] [next in list] [prev in thread] [next in thread] 

List:       koffice-devel
Subject:    Re: koffice/kword/plugins/scripting
From:       Sebastian Sauer <mail () dipe ! org>
Date:       2009-04-18 12:15:39
Message-ID: 20090418121552.A6F045802DA9 () smtp-out ! kontent ! com
[Download RAW message or body]

Thomas Zander wrote:

> On Friday 17. April 2009 09:34:29 Cyrille Berger wrote:
>> On Friday 17 April 2009, Thomas Zander wrote:
>> > The "previous commits" are probably the coding style being applied. I
>> > think thats something that I can decide myself, thanks. :)
>> > The dox extract just fine for me and will show up on the koffice
>> > website as soon as the weekly doc run goes through.
>> > Hmm, I should probably not extract docs from the examples, though. Will
>> > fix that later.
>>
>> Isn't techbase a better fit for that kind of information ? The koffice
>> website is a bit obscure for scripts writters. And I was under the
>> impression thhat techbase was meant especially for that ? But maybe we
>> can work on a solution that will work for both techbase (for scripts
>> writters), and koffice api (for koffice developers).
> 
> I agree Techbase is the place for script writers to go, and I think we
> already have a lot of docs there none of them wrong all of a sudden due to
> any changes I made recently.
> 
> I'm not entirely sure what Sebastian was thinking about with his complaint
> as the API docs themselves are not on techbase and never have been.

http://techbase.kde.org/Development/Tutorials/KWord_Scripting#Scripting_Handbook

Your commit;
SVN commit 953357 by zander:
Remove non-functioning bits
 D             importdoxyxml.py  
 D             importdoxyxmloptions.ui  
 D             importdoxyxmlstyle.ui  
 D             onlinehelp.py  
 D             sample_allshapes.py  
 D             sample_cursor.rb  
 D             sample_insertshape.py  
 D             sample_lists_cursor.py  
 D             sample_lists_html.py  
 D             sample_tables.py  
 D             sample_text.py  
 D             sample_variables.py  
 D             variable_readfile.py  

removes scripts that are working fine (I just did test while you did clearly 
not).

SVN commit 953393 by zander:
Fixes: The silly situation that the only place we documented this was on a 
3rd part website.
Details: Figure my emberrasement that I didn't know we actually have 
documentation.  All the
    more reason to use standard API documentation techniques and thus make 
these docs
    show up together with all the other KOffice API docs.
 A             Mainpage.dox  
 D             docs/kwordscripting.doxyfile  
 D             scripting.dox

You miss that scripting dox are different from any other dox created in KDE 
cause of there nature (signals, slots, properties only, no methods or 
variables, no diff between private/protected/public, no const/ref/pointer, 
etc). One look into the doxyfile *or* at techbase *or* into any other file 
you removed would have point you into that direction

etc, etc for all other commits...

I will not spend any more time on this. Either you revert the commits or I 
will. Please stop wasting our time, Zander. Thanks.

_______________________________________________
koffice-devel mailing list
koffice-devel@kde.org
https://mail.kde.org/mailman/listinfo/koffice-devel

[prev in list] [next in list] [prev in thread] [next in thread]