Improve method descriptions.

Change-Id: I25074578607dedaec9689dff9a6bb9c2fa7be56b

1 files changed, 20 insertions, 9 deletions

diff --git a/offapi/com/sun/star/chart2/XScaling.idl b/offapi/com/sun/star/chart2/XScaling.idl
index 7d65c84c385a..0daf41b0b907 100644
--- a/offapi/com/sun/star/chart2/XScaling.idl
+++ b/offapi/com/sun/star/chart2/XScaling.idl
@@ -28,16 +28,27 @@ module com {  module sun {  module star {  module chart2 {
 
 interface XScaling : ::com::sun::star::uno::XInterface
 {
-    /** needs to keep relative ordering
-    */
-    double doScaling([in] double value);
+    /**
+     * Given a numeric value, return the scaled value that conforms
+     * to a predefined scaling rule.  For instance, for linear
+     * scaling, given a x value, the method may return a y value as
+     * defined by y = Ax + B for predefined values of A and B.
+     *
+     * @param value input value from which to calculate the scaled
+     *              value.
+     *
+     * @return scaled value based on a predefined scaling rule.
+     */
+    double doScaling( [in] double value );
+
+    /**
+     * Get an interface object that conforms to a scaling rule that
+     * is the reverse of the original scaling rule.
+     *
+     * @return internface object that represents the reversed
+     *         scaling rule.
+     */
     com::sun::star::chart2::XScaling getInverseScaling();
-
-    //maybe provide correction for Min/Max
-    //double getMinimum(); ?adjust <-> min/max may not exist
-    //double getMaximum();
-
-    //... or better/additionally?: provide default values for Min&Max
 };