openoffice-doc mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John D'Orazio" <john.dora...@cappellaniauniroma3.org>
Subject available to help
Date Wed, 19 Aug 2015 21:34:32 GMT
I just signed up today to the documentation mailing list, I've been signed
up to the dev mailing list for about a year now. Introducing myself, I made
a plugin for Open Office Writer in Java using the Netbeans plugin, and
since it was basically a trial and error experience considering that there
are no code examples in the documentation, and sometimes the documentation
is incomplete or has even an inconsistency here and there, I thought I
would volunteer to help maintain / contribute to the developer
documentation.

And so I would like to request an account for the Wiki, username can be
"johnrdorazio" and email "john.dorazio@cappellaniauniroma3.org".

One example of what seems to me to be an inconsistency, but correct if I am
wrong: on the page
https://wiki.openoffice.org/wiki/Documentation/DevGuide/Text/Formatting in
the table [ Properties of com.sun.star.style.CharacterProperties
<http://api.openoffice.org/docs/common/ref/com/sun/star/style/CharacterProperties.html>
],
at the property [ CharEscapementHeight
<http://api.openoffice.org/docs/common/ref/com/sun/star/style/CharacterProperties.html#CharEscapementHeight>
]
it says:

 "[optional] byte - This is the additional height used for subscript or
superscript characters in units of percent. For subscript characters the
value is negative and for superscript characters positive."

I believe this is incorrect, isn't it the CharEscapement property that
should have negative or positive value for superscript / subscript, whereas
CharEscapementHeight will always be positive?

Also, there is no documentation for "Escapement.Auto" which I have no idea
how to use, I see it if I register a macro and I see an "Auto" checkbox in
the OpenOffice Writer Character -> Position tab as regards superscript /
subscript placement. However this property is not documented and there are
no code examples anywhere.

Alas, there aren't any code examples anywhere in the wiki, just a very dry
presentation that doesn't even deal with the different scripting languages.
I think it would be very useful, and I could contribute somewhat to this,
to include code examples for every single method and property in the wiki,
with examples for every scripting language. There can be a scripting
example for each method / property page in a tabbed interface where each
scripting language and relative example could be in a different tab.

If others find this to a be a useful / helpful proposal, we could work on
this together...

-- 
John R. D'Orazio
Cappellano Coordinatore
________________________________________

Servizio di Cappellania - Università degli Studi Roma Tre
Piazzale San Paolo 1/d - 00120 Città del Vaticano

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message