diff options
author | Michael Stahl <mstahl@redhat.com> | 2013-04-30 00:15:22 +0200 |
---|---|---|
committer | Michael Stahl <mstahl@redhat.com> | 2013-06-04 12:01:06 +0200 |
commit | 73d568408a150875b5c6046680f38e6db287c8fa (patch) | |
tree | 3c6d87ae03cc8193ef1d418d7a1ff7272bbbae53 /offapi | |
parent | b84bffc86a913383bb3fa7f9f3d963d32681f778 (diff) |
*api: convert <listing> and @example
<listing> is called @code / @endcode in doxygen.
@example requires a file name in doxygen.
Also adapt various silly examples that use tools String in C++ or manual
syntax highlighting in Java etc.
Change-Id: I23cff1b688001f438526a6a1364cc5f754b504f7
Diffstat (limited to 'offapi')
24 files changed, 95 insertions, 107 deletions
diff --git a/offapi/com/sun/star/document/FilterFactory.idl b/offapi/com/sun/star/document/FilterFactory.idl index bd49e078bf11..240ff08304b4 100644 --- a/offapi/com/sun/star/document/FilterFactory.idl +++ b/offapi/com/sun/star/document/FilterFactory.idl @@ -55,7 +55,7 @@ published service FilterFactory reached by using createInstanceWithArguments() with an optional property "FilterName" only. See the following example: - <listing> + @code{.java} private com.sun.star.uno.XInterface createFilterDirect( com.sun.star.lang.XMultiServiceFactory xFilterFactory , java.lang.String sInternalFilterName ) { @@ -69,7 +69,7 @@ published service FilterFactory java.lang.Object aFilter = xFilterFactory.createInstanceWithArguments("", lProps); return (com.sun.star.uno.XInterface)UnoRuntime.queryInterface(com.sun.star.uno.XInterface.class, aFilter); } - </listing> + @endcode </p> <p> diff --git a/offapi/com/sun/star/drawing/GenericDrawPage.idl b/offapi/com/sun/star/drawing/GenericDrawPage.idl index 8183cff457ec..fcd6db5713a7 100644 --- a/offapi/com/sun/star/drawing/GenericDrawPage.idl +++ b/offapi/com/sun/star/drawing/GenericDrawPage.idl @@ -41,11 +41,9 @@ /** This abstract service is implemented by every page of a DrawingDocument. + Example to create and insert a couple of LineShapes: - - @example create and insert a couple of LineShapes: - - <listing> + @code{.bas} xPage = xDoc.DrawPages(0) for x% = 0 to 200 xShape = xProv.createInstance( "com::sun::star::drawing::LineShape" ) @@ -55,7 +53,7 @@ xShape.Size = Size( 300-x%, 20 ) xPage.add( xShape ) next x% - </listing> + @endcode */ published service GenericDrawPage { diff --git a/offapi/com/sun/star/form/PropertyBrowserController.idl b/offapi/com/sun/star/form/PropertyBrowserController.idl index 56de59e46313..28d175f87ca8 100644 --- a/offapi/com/sun/star/form/PropertyBrowserController.idl +++ b/offapi/com/sun/star/form/PropertyBrowserController.idl @@ -43,8 +43,7 @@ </ul> </p> - @example Java - <listing> + @code{.java} XFrame xFrame = getNewEmptyFrame(); XMultiServiceFactory xORB = getORB(); XPropertySet xControlModel = getMyControlModel(); @@ -62,7 +61,7 @@ XPropertySet.class, xController ); xControllerProps.setPropertyValue( "IntrospectedObject", xControlModel ); - </listing> + @endcode @see com::sun::star::frame::XController diff --git a/offapi/com/sun/star/form/XFormsSupplier.idl b/offapi/com/sun/star/form/XFormsSupplier.idl index 23572d528383..11ba114f53a7 100644 --- a/offapi/com/sun/star/form/XFormsSupplier.idl +++ b/offapi/com/sun/star/form/XFormsSupplier.idl @@ -35,8 +35,7 @@ published interface XFormsSupplier: com::sun::star::uno::XInterface /** accesses the forms. - @example StarBASIC - <listing> + @code{.bas} REM ***** BASIC ***** Sub createColorSelectionBox @@ -71,7 +70,7 @@ published interface XFormsSupplier: com::sun::star::uno::XInterface thisComponent.DrawPage.Forms.getByIndex(0).insertByIndex( 0, xControlModel ) thisComponent.DrawPage.add( xShape ) End Sub - </listing> + @endcode @returns the container of all the top-level forms belonging to the component. diff --git a/offapi/com/sun/star/frame/XDispatch.idl b/offapi/com/sun/star/frame/XDispatch.idl index 84a614c7804e..6b4ca0a4993e 100644 --- a/offapi/com/sun/star/frame/XDispatch.idl +++ b/offapi/com/sun/star/frame/XDispatch.idl @@ -67,27 +67,29 @@ published interface XDispatch: com::sun::star::uno::XInterface optional arguments for this request. They depend on the real implementation of the dispatch object. - @example - <listing> - <i><font COLOR="#949494">// some code for a click-handler (Java)</font></i> - void <strong>myOnClick</strong>(<em>String</em> sURL,<em>String</em> sTargetFrame,<em>com.sun.star.beans.PropertyValue[]</em> lArguments) + <i>some code for a click-handler (Java)</i> + @code{.java} + void myOnClick(String sURL,String sTargetFrame, + com.sun.star.beans.PropertyValue[] lArguments) { - com.sun.star.util.URL[] aURL = new com.sun.star.util.URL[1]; - aURL[0] = new com.sun.star.util.URL(); - aURL[0].Complete = sURL; + com.sun.star.util.URL[] aURL = new com.sun.star.util.URL[1]; + aURL[0] = new com.sun.star.util.URL(); + aURL[0].Complete = sURL; - com.sun.star.util.XURLTransformer xParser = (com.sun.star.util.XURLTransformer)UnoRuntime.queryInterface( - com.sun.star.util.XURLTransformer.class, - mxServiceManager.createInstance("com.sun.star.util.URLTransformer")); + com.sun.star.util.XURLTransformer xParser = + (com.sun.star.util.XURLTransformer)UnoRuntime.queryInterface( + com.sun.star.util.XURLTransformer.class, + mxServiceManager.createInstance("com.sun.star.util.URLTransformer")); - xParser.parseStrict(aURL); + xParser.parseStrict(aURL); - com.sun.star.frame.XDispatch xDispatcher = mxFrame.queryDispatch(aURL[0], sTargetFrame, com.sun.star.frame.FrameSearchFlag.GLOBAL); + com.sun.star.frame.XDispatch xDispatcher = + mxFrame.queryDispatch(aURL[0], sTargetFrame, com.sun.star.frame.FrameSearchFlag.GLOBAL); - if(xDispatcher!=null) - xDispatcher.dispatch(aURL[0], lArguments); + if(xDispatcher!=null) + xDispatcher.dispatch(aURL[0], lArguments); } - </listing> + @endcode */ void dispatch( [in] com::sun::star::util::URL URL, diff --git a/offapi/com/sun/star/frame/XRecordableDispatch.idl b/offapi/com/sun/star/frame/XRecordableDispatch.idl index 364f5836a954..211dacf63229 100644 --- a/offapi/com/sun/star/frame/XRecordableDispatch.idl +++ b/offapi/com/sun/star/frame/XRecordableDispatch.idl @@ -45,22 +45,22 @@ is used transparently there. </p> - @example - <listing> - <i>XDispatch</i> xDispatcher = xFrame.queryDispatch(aURL,"",0); - <i>XRecordableDispatch</i> xRecordable = (<i>XRecordableDispatch</i>)UnoRuntime.queryInterface( - XRecordableDispatch.class, - xDispatcher); + @code{.java} + XDispatch xDispatcher = xFrame.queryDispatch(aURL,"",0); + XRecordableDispatch xRecordable = + (XRecordableDispatch)UnoRuntime.queryInterface( + XRecordableDispatch.class, + xDispatcher); xDispatcher.addStatusListener(this,aURL); - <b>if</b> (xRecordable!=<b>null</b>) - xRecordable.dispatchAndRecord(aURL,lArguments,xRecorder); + if (xRecordable != null) + xRecordable.dispatchAndRecord(aURL,lArguments,xRecorder); else - xDispatcher.dispatch(aURL,lArguments); + xDispatcher.dispatch(aURL,lArguments); ... xDispatcher.removeStatusListener(this,aURL); - </listing> + @endcode @see XDispatchRecorderSupplier @see XDispatch diff --git a/offapi/com/sun/star/i18n/XCharacterClassification.idl b/offapi/com/sun/star/i18n/XCharacterClassification.idl index 731152bfb343..c209bcfe05e8 100644 --- a/offapi/com/sun/star/i18n/XCharacterClassification.idl +++ b/offapi/com/sun/star/i18n/XCharacterClassification.idl @@ -169,15 +169,14 @@ published interface XCharacterClassification : com::sun::star::uno::XInterface A set of additionally allowed characters a name or identifier may continue with. - @example:C++ - <listing> + @code{.cpp} using namespace ::com::sun::star::i18n; // First character of an identifier may be any alphabetic or underscore. sal_Int32 nStartFlags = KParseTokens::ANY_ALPHA | KParseTokens::ASC_UNDERSCORE; // Continuing characters may be any alphanumeric or underscore or dot. sal_Int32 nContFlags = KParseTokens::ANY_ALNUM | KParseTokens::ASC_UNDERSCORE | KParseTokens::ASC_DOT; // No further characters assumed to be contained in an identifier - String aEmptyString; + OUString aEmptyString; // Parse any token. ParseResult rRes = xCC->parseAnyToken( aText, nPos, aLocale, nStartFlags, aEmptyString, nContFlags, aEmptyString ); @@ -185,16 +184,16 @@ published interface XCharacterClassification : com::sun::star::uno::XInterface if ( rRes.TokenType & (KParseType::ASC_NUMBER | KParseType::UNI_NUMBER) ) fValue = rRes.Value; if ( rRes.TokenType & KParseType::IDENTNAME ) - aName = aText.Copy( nPos, rRes.EndPos - nPos ); + aName = aText.copy( nPos, rRes.EndPos - nPos ); else if ( rRes.TokenType & KParseType::SINGLE_QUOTE_NAME ) aName = rRes.DequotedNameOrString; else if ( rRes.TokenType & KParseType::DOUBLE_QUOTE_STRING ) aString = rRes.DequotedNameOrString; else if ( rRes.TokenType & KParseType::BOOLEAN ) - aSymbol = aText.Copy( nPos, rRes.EndPos - nPos ); + aSymbol = aText.copy( nPos, rRes.EndPos - nPos ); else if ( rRes.TokenType & KParseType::ONE_SINGLE_CHAR ) - aSymbol = aText.Copy( nPos, rRes.EndPos - nPos ); - </listing> + aSymbol = aText.copy( nPos, rRes.EndPos - nPos ); + @endcode */ ParseResult parseAnyToken( @@ -220,26 +219,25 @@ published interface XCharacterClassification : com::sun::star::uno::XInterface @param nTokenType One or more of the KParseType constants. - @example:C++ - <listing> + @code{.cpp} // Determine if a given name is a valid name (not quoted) and contains // only allowed characters. using namespace ::com::sun::star::i18n; // First character of an identifier may be any alphanumeric or underscore. sal_Int32 nStartFlags = KParseTokens::ANY_ALNUM | KParseTokens::ASC_UNDERSCORE; // No further characters assumed to be contained in an identifier start. - String aEmptyString; + OUString aEmptyString; // Continuing characters may be any alphanumeric or underscore. sal_Int32 nContFlags = nStartFlags; // Additionally, continuing characters may contain a blank. - String aContChars( RTL_CONSTASCII_USTRINGPARAM(" ") ); + OUString aContChars( RTL_CONSTASCII_USTRINGPARAM(" ") ); // Parse predefined (must be an IDENTNAME) token. ParseResult rRes = xCC->parsePredefinedToken( KParseType::IDENTNAME, rName, 0, aLocale, nStartFlags, aEmptyString, nContFlags, aContChars ); // Test if it is an identifier name and if it only is one // and no more else is following it. bValid = (rRes.TokenType & KParseType::IDENTNAME) && rRes.EndPos == rName.Len(); - </listing> + @endcode */ ParseResult parsePredefinedToken( diff --git a/offapi/com/sun/star/rendering/XColorSpace.idl b/offapi/com/sun/star/rendering/XColorSpace.idl index bd7363bbe6a6..3d8f3a050299 100644 --- a/offapi/com/sun/star/rendering/XColorSpace.idl +++ b/offapi/com/sun/star/rendering/XColorSpace.idl @@ -66,7 +66,7 @@ interface XColorSpace corresponds to the number of color channels for this color space.<p> - @example For the standard RGB color space, ComponentTags + @remark For the standard RGB color space, ComponentTags consists of three elements, containing RGB_RED, RGB_GREEN and RGB_BLUE tags, respectively */ diff --git a/offapi/com/sun/star/rendering/XIntegerBitmapColorSpace.idl b/offapi/com/sun/star/rendering/XIntegerBitmapColorSpace.idl index 32f966c82c24..b700faf1d14f 100644 --- a/offapi/com/sun/star/rendering/XIntegerBitmapColorSpace.idl +++ b/offapi/com/sun/star/rendering/XIntegerBitmapColorSpace.idl @@ -59,7 +59,7 @@ interface XIntegerBitmapColorSpace : XColorSpace order defined here, with the first element starting from the least significant bits of the pixel, etc.<p> - @example For the typical 32 bit RGBA color data, the four + @remark For the typical 32 bit RGBA color data, the four values would all contain the value eight. For a 16 bit 1555 ARGB format, with mask values 0x8000 for alpha, 0x7C for red, 0x3E for green and 0x1F for blue, the values would be 5, 5, 5, @@ -77,7 +77,7 @@ interface XIntegerBitmapColorSpace : XColorSpace actual color data bytes might need to get swapped, for the bits to align properly.<p> - @example with a 16 bit 565 RGB format, written on a big endian + @remark with a 16 bit 565 RGB format, written on a big endian architecture, a destination machine using little endian CPU will need to swap the bytes, in order to keep the green channel bits together. diff --git a/offapi/com/sun/star/resource/XLocale.idl b/offapi/com/sun/star/resource/XLocale.idl index 8efe7c50ded4..ed4c9870d808 100644 --- a/offapi/com/sun/star/resource/XLocale.idl +++ b/offapi/com/sun/star/resource/XLocale.idl @@ -123,9 +123,6 @@ published interface XLocale: com::sun::star::uno::XInterface @param inLocale specifies the desired user language. - - @example - "English (UK)", "Deutch", "Germany" */ string getDisplayLanguage( [in] com::sun::star::lang::Locale locale, [in] com::sun::star::lang::Locale inLocale ); diff --git a/offapi/com/sun/star/resource/XResourceBundle.idl b/offapi/com/sun/star/resource/XResourceBundle.idl index af48e782c4d9..09f6649bfd5e 100644 --- a/offapi/com/sun/star/resource/XResourceBundle.idl +++ b/offapi/com/sun/star/resource/XResourceBundle.idl @@ -82,9 +82,9 @@ module com { module sun { module star { module resource { the <code>XResourceBundle</code> implementation using the XResourceBundleLoader service: - <listing> + @code{.java} XResourceBundle myResources = xLoader.getBundle("MyResources", currentLocale); - </listing> + @endcode <p>The first argument specifies the family name of the resource bundle that contains the object in question. The second argument @@ -129,7 +129,7 @@ module com { module sun { module star { module resource { example of a <code>XResourceBundle</code> implementation that contains two key/value pairs: - <listing> + @code{.java} class MyResource extends com.sun.star.resource.XResourceBundle { // some queryInterface stuff @@ -141,7 +141,7 @@ module com { module sun { module star { module resource { return null; } } - </listing> + @endcode <p>Keys are always <code>String</code>s. In this example, the keys are <code>OkKey</code> and <code>CancelKey</code>. In the above @@ -153,10 +153,10 @@ module com { module sun { module star { module resource { get method. Because <code>OkKey</code> and <code>CancelKey</code> are both strings, you use <code>getByName</code> to retrieve them: - <listing> + @code{.java} button1 = new Button(myResourceBundle.getByName("OkKey").getString()); button2 = new Button(myResourceBundle.getByName("CancelKey").getString()); - </listing> + @endcode <p>The get methods all require the key as an argument and return the object if found. If the object is not found, the get methods diff --git a/offapi/com/sun/star/script/provider/XScript.idl b/offapi/com/sun/star/script/provider/XScript.idl index 6b2d60a9e0a8..b63926ec4b83 100644 --- a/offapi/com/sun/star/script/provider/XScript.idl +++ b/offapi/com/sun/star/script/provider/XScript.idl @@ -51,10 +51,10 @@ interface XScript : ::com::sun::star::uno::XInterface { <br> the call would look like<br> <code>bar.invoke( {"foo", "foo2", "this-is-ignored" }, aOutParamIndex, aOutParam);</code> <br> and after the call the out sequences would contain<br> - <listing> + @code{.py} aOutParamIndex={0,2}; aOutParam={"string from a", "string from c"}; - </listing> + @endcode @returns the value returned from the function being invoked diff --git a/offapi/com/sun/star/sdb/ErrorCondition.idl b/offapi/com/sun/star/sdb/ErrorCondition.idl index e03f8fca7c60..1f9f9a223fe5 100644 --- a/offapi/com/sun/star/sdb/ErrorCondition.idl +++ b/offapi/com/sun/star/sdb/ErrorCondition.idl @@ -46,15 +46,14 @@ module com { module sun { module star { module sdb { <p>The list of defined error conditions, by nature, is expected to permanently grow, so never assume it being finalized.</p> - @example Java - <listing> + @code{.java} catch ( SQLException e ) { - if ( e.Message.startsWith( "[OOoBase]" ) ) - if ( e.ErrorCode + ErrorCondition.SOME_ERROR_CONDITION == 0 ) - handleSomeErrorCondition(); + if (e.Message.startsWith( "[OOoBase]" )) + if (e.ErrorCode + ErrorCondition.SOME_ERROR_CONDITION == 0) + handleSomeErrorCondition(); } - </listing> + @endcode */ constants ErrorCondition { diff --git a/offapi/com/sun/star/sdbc/PreparedStatement.idl b/offapi/com/sun/star/sdbc/PreparedStatement.idl index d35d0bbfedd0..ae841c50bee5 100644 --- a/offapi/com/sun/star/sdbc/PreparedStatement.idl +++ b/offapi/com/sun/star/sdbc/PreparedStatement.idl @@ -62,12 +62,11 @@ </p> <p> Example of setting a parameter; <code>con</code> is an active connection. - @example:StarBASIC - <listing> + @code{.bas} pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ? WHERE ID = ?") pstmt.setDouble(1, 153833.00) pstmt.setLong(2, 110592) - </listing> + @endcode </p> <P> Only one diff --git a/offapi/com/sun/star/sdbc/XParameters.idl b/offapi/com/sun/star/sdbc/XParameters.idl index 6347f511e4a0..6f1beca0a8c4 100644 --- a/offapi/com/sun/star/sdbc/XParameters.idl +++ b/offapi/com/sun/star/sdbc/XParameters.idl @@ -65,10 +65,13 @@ is an active connection. </p> - @example <listing>pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ? WHERE ID = ?") + @code{.bas} + pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ? WHERE ID = ?") pstmt.setDouble(1, 153833.00) pstmt.setLong(2, 110592) - </listing>@see com::sun::star::sdbc::XPreparedStatement + @endcode + + @see com::sun::star::sdbc::XPreparedStatement */ published interface XParameters: com::sun::star::uno::XInterface { diff --git a/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl b/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl index ccaf4ddfc862..01fb918e373b 100644 --- a/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl +++ b/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl @@ -29,9 +29,9 @@ /** This abstract service is implemented by every page of a SpreadsheetDocument. - @example create and insert a couple of com::sun::star::drawing::LineShapes: + Example: create and insert a couple of com::sun::star::drawing::LineShapes: - <listing> + @code{.bas} xPage = xDoc.DrawPages(0) for x% = 0 to 200 xShape = xProv.createInstance( "com.sun.star.drawing.LineShape" ) @@ -41,7 +41,7 @@ xShape.Size = Size( 300-x%, 20 ) xPage.add( xShape ) next x% - </listing> + @endcode @since OOo 1.1.2 */ diff --git a/offapi/com/sun/star/text/TextFrame.idl b/offapi/com/sun/star/text/TextFrame.idl index a78a8ec7e3e4..676703d2b67d 100644 --- a/offapi/com/sun/star/text/TextFrame.idl +++ b/offapi/com/sun/star/text/TextFrame.idl @@ -31,20 +31,18 @@ @see Text - @example StarBasic - <p>This example shows how to create a TextFrame and insert it at the very beginning of Text component. The macro is ready to run, if it is a script within a text document. </p> - <listing> + @code{.bas} Sub Main oFrame = ThisComponent.createInstance( "com.sun.star.text.TextFrame" ) oFrame.Width = 6000 ThisComponent.Text.insertTextContent( ThisComponent.Text.Start, oFrame, false ) oFrame.Text.String = "Hello, this text is within the frame." End Sub - </listing> + @endcode */ published service TextFrame { diff --git a/offapi/com/sun/star/text/TextTable.idl b/offapi/com/sun/star/text/TextTable.idl index e807efd28e95..c637fe02d402 100644 --- a/offapi/com/sun/star/text/TextTable.idl +++ b/offapi/com/sun/star/text/TextTable.idl @@ -53,18 +53,16 @@ tables should be insertable via XText::insertTextContent() and that interface uses a parameter of that type.</p> - @example + <p>Example: Create and insert a TextTable:</p> - <p>Create and insert a TextTable:</p> - - <listing> + @code{.bas} xTable = xTextDoc.createInstance( "com.sun.star.text.TextTable" ) xTable.initialize(5, 8) xTable.HoriOrient = 0 'com::sun::star::text::HoriOrientation::NONE xTable.LeftMargin = 2000 xTable.RightMargin = 1500 xTextDoc.getText.insertTextContent( xTextRange, xTable, false ) - </listing> + @endcode @see com::sun::star::text::Cell @see com::sun::star::text::CellRange diff --git a/offapi/com/sun/star/text/XDependentTextField.idl b/offapi/com/sun/star/text/XDependentTextField.idl index 77e49a9cf04a..6386d6b499e2 100644 --- a/offapi/com/sun/star/text/XDependentTextField.idl +++ b/offapi/com/sun/star/text/XDependentTextField.idl @@ -41,10 +41,9 @@ published interface XDependentTextField: com::sun::star::text::XTextField <p>A TextFieldMaster can only be assigned once. </p> - @example Create and insert a user field (with a - <code>UserField</code>): + Example: Create and insert a user field (with a <code>UserField</code>): - <listing> + @code{.java} // Create a fieldmaster for our newly created User Text field, and access it's // XPropertySet interface XPropertySet xMasterPropSet = (XPropertySet) UnoRuntime.queryInterface( @@ -62,7 +61,7 @@ published interface XDependentTextField: com::sun::star::text::XTextField mxDocCursor, ControlCharacter.PARAGRAPH_BREAK, false); // Insert the user field at the end of the document mxDocText.insertTextContent(mxDocText.getEnd(), xUserField, false); - </listing> + @endcode */ void attachTextFieldMaster( [in] com::sun::star::beans::XPropertySet xFieldMaster ) raises( com::sun::star::lang::IllegalArgumentException ); diff --git a/offapi/com/sun/star/text/XSimpleText.idl b/offapi/com/sun/star/text/XSimpleText.idl index a7f842259bcf..f9333918015c 100644 --- a/offapi/com/sun/star/text/XSimpleText.idl +++ b/offapi/com/sun/star/text/XSimpleText.idl @@ -95,15 +95,14 @@ published interface XSimpleText: com::sun::star::text::XTextRange be replaced by <var>aString</var>, otherwise <var>aString</var> will be inserted at the beginning of <var>xRange</var>. - @example - <listing> - xText.insertString( xTextCursor, "Hello " + aName$ + ",", false ) + @code{.java} + xText.insertString( xTextCursor, "Hello " + aName + ",", false ) xText.insertControlCharacter( xTextCursor, - ControlCharacter_PARAGRAPH_BREAK, false ); + ControlCharacter.PARAGRAPH_BREAK, false ); xText.insertString( xTextCursor, "more text ...", false ) - </listing> + @endcode */ void insertString( [in] com::sun::star::text::XTextRange xRange, [in] string aString, diff --git a/offapi/com/sun/star/text/XText.idl b/offapi/com/sun/star/text/XText.idl index 8a865690989b..2e4a629a42a9 100644 --- a/offapi/com/sun/star/text/XText.idl +++ b/offapi/com/sun/star/text/XText.idl @@ -68,8 +68,8 @@ published interface XText: com::sun::star::text::XSimpleText /** removes the specified content from the text object. - - @example xDoc.removeTextContent( xDoc.TextTables.MyOwnTableName ) + @param xContent + the content that is to be removed. */ void removeTextContent( [in] com::sun::star::text::XTextContent xContent ) raises( com::sun::star::container::NoSuchElementException ); diff --git a/offapi/com/sun/star/ucb/ContentResultSet.idl b/offapi/com/sun/star/ucb/ContentResultSet.idl index 542a485d80e8..513b254582b7 100644 --- a/offapi/com/sun/star/ucb/ContentResultSet.idl +++ b/offapi/com/sun/star/ucb/ContentResultSet.idl @@ -118,7 +118,7 @@ published service ContentResultSet <p>The following pseudo-code illustrates the usage of a non-blocking cursor: - <p><pre> + @code{.java} bProcessedAllRows = false while ( !bProcessedAllRows ) { @@ -148,7 +148,7 @@ published service ContentResultSet bProcessedAllRows = ... } - </pre> + @endcode <p> If this property is not supported, the implementation needs to provide diff --git a/offapi/com/sun/star/util/XReplaceable.idl b/offapi/com/sun/star/util/XReplaceable.idl index 8eea70eaa646..4a3d008417d7 100644 --- a/offapi/com/sun/star/util/XReplaceable.idl +++ b/offapi/com/sun/star/util/XReplaceable.idl @@ -33,14 +33,14 @@ module com { module sun { module star { module util { /** makes it possible to replace strings in a text described by a SearchDescriptor. - @example - <listing> - replace all bold words "search for" by "look for" + Example: replace all bold words "search for" by "look for" + + @code{.py} xReplaceDescr = xDocument.createReplaceDescriptor() xReplaceDescr.SearchString = "search for" xReplaceDescr.ReplaceString = "look for" xFound = xDocument.replaceAll( xReplaceDescr ) - </listing> + @endcode */ published interface XReplaceable: com::sun::star::util::XSearchable { diff --git a/offapi/com/sun/star/util/XSearchable.idl b/offapi/com/sun/star/util/XSearchable.idl index 28e84d464d96..9420e2abb853 100644 --- a/offapi/com/sun/star/util/XSearchable.idl +++ b/offapi/com/sun/star/util/XSearchable.idl @@ -33,11 +33,11 @@ module com { module sun { module star { module util { /** enables the object to look for specified contents of the object (in particular, for a text range which contains a specific string pattern). - @example + Example: in a com::sun::star::text::TextDocument: set all "search for" to bold using findFirst()/findNext(): - <listing> + @code{.bas} xSearchDescr = xDocument.createSearchDescriptor() xSearchDescr.SearchString = "search for" xSearchDescr.SearchCaseSensitive = `TRUE` @@ -47,7 +47,7 @@ module com { module sun { module star { module util { xFound.CharWeight = com.sun.star.awt.FontWeight.BOLD xFound = xDocument.findNext( xFound.End, xSearchDescr ) loop - </listing> + @endcode */ published interface XSearchable: com::sun::star::uno::XInterface |