https://bugs.documentfoundation.org/show_bug.cgi?id=60237

--- Comment #17 from Peter Toye <[email protected]> ---
(In reply to Aron Budea from comment #15)

So where does this leave us? At the moment the code and documentation differ -
at least one should change.

> I don't agree that it should ultimately be considered as an issue in the API
> documentation, because the API usage is based on that documentation, and
> users expect the functions to work as described there. If someone wanted to
> use this function, they must've expected that Overwrite would be false by
> default, based on the documentation.
I agree with this, provided that changing the code to reflect the documentation
isn't going to stop existing programs from working.

> If they noticed the contradiction between the documentation and actual
> behavior, and relied on the way it worked, that's a deliberate action (and a
> serious mistake).
One has to rely on the way it works, so it's not a mistake! I could have simply
decided to remember each time I saved that it should be to a different file
(unless I really wanted to overwrite). Of course I didn't and set the Overwrite
flag to prevent overwriting.

> On the other hand there might also be code out there that relies on the
> documented default value of the Overwrite flag, and the bug simply went
> unnoticed.
...and overwrote a file (as happened to me)! 

My personal view is that the code should be changed to reflect the
documentation, which in my opinion is the desired behaviour. But I have no idea
if the LO development team feel that current behaviour should take priority
over documentation. Maybe someone from that team could comment. I'm only a user
so I don't know the correct form to get action, but it's been 8 months since
any comments on this issue.

-- 
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
Libreoffice-bugs mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

Reply via email to