Talk:Documentation/BASIC Guide/StarDesktop

From Apache OpenOffice Wiki
Jump to: navigation, search

OpenOffice.org 5

"The name of the StarDesktop object dates back to OpenOffice.org 5" ?? --TJ 04:24, 5 October 2007 (CEST)

"Compression of Files" bracket stuff

Bracketed stuff in that section. --TJ 04:28, 5 October 2007 (CEST)

Parameter for new frame

In the text you say that the parameter for opening a document in a new frame is "_blank", but the example gives " blank". The API documentation agrees with the former, but I've found by experiment that both work OK (documentation bug??); "blank" works as well! Should the code be changed to match the description, or was it put in to highlight the discrepancy? In the latter case I'd suggest a note pointing this out.Ptoye (talk) 15:57, 23 January 2013 (UTC)

If you can find such an instance, of " blank" (I can't), by all means please fix it. Generally speaking, the information here, in the Basic Guide, is subordinate to the API and DevGuide documentation. The leading underscore is a common way of marking reserved words, which the user should not define, but should use exactly as given. If the code permissively allows "blank" and " blank" as well, these are implementation details. We don't document those, because someone might come along and change to a more rigorous requirement. We don't want our users to depend on things like that, which may go away without notice; we try to tell them how to do it right. --TJ (Talk) 17:51, 23 January 2013 (UTC)
I fully agree. But in your page, the first example has " blank" without the underline - I assume a typo, unless it was there to indicate that the underline is optional (which, as you say, isn't documented and really needs a comment).Ptoye (talk) 10:14, 31 January 2013 (UTC)
Personal tools