offapi/com/sun/star/accessibility/AccessibleTableModelChangeType.idl | 26 +-- offapi/com/sun/star/drawing/GenericDrawPage.idl | 10 - offapi/com/sun/star/drawing/LayerManager.idl | 4 offapi/com/sun/star/sdbc/ResultSet.idl | 26 +-- offapi/com/sun/star/sdbc/XPooledConnection.idl | 2 offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl | 8 - offapi/com/sun/star/text/BaseFrame.idl | 4 offapi/com/sun/star/text/Bookmarks.idl | 4 offapi/com/sun/star/text/HoriOrientation.idl | 8 - offapi/com/sun/star/text/NumberingLevel.idl | 66 +++++----- offapi/com/sun/star/text/NumberingRules.idl | 6 offapi/com/sun/star/text/Paragraph.idl | 10 - offapi/com/sun/star/text/XTextContentAppend.idl | 6 offapi/com/sun/star/text/XTextPortionAppend.idl | 8 - offapi/com/sun/star/view/PrintOptions.idl | 2 udkapi/com/sun/star/beans/PropertyAttribute.idl | 2 udkapi/com/sun/star/script/XDebugging.idl | 8 - udkapi/com/sun/star/script/XInvocation.idl | 18 +- 18 files changed, 109 insertions(+), 109 deletions(-)
New commits: commit 50c63a74977b30d141b2b6770d05d23383a231e6 Author: Neil Roberts <[email protected]> AuthorDate: Fri Mar 6 13:26:17 2026 +0100 Commit: Neil Roberts <[email protected]> CommitDate: Sat Mar 7 10:25:33 2026 +0100 Fix some accidental preformatted paragraphs in the IDL docs A bunch of places in the documentation in the IDL files were starting a new paragraph with a <p> tag and a line that is more indented than the previous one. This ends up making a preformatted code section in a monospace font in the generated HTML docs and the <p> tag is visible. This patch just moves the lines to the left to have the same indentation as the previous one. These were found by running the following Python script on the generated HTML files: from bs4 import BeautifulSoup import sys for filename in sys.argv[1:]: with open(filename) as fp: soup = BeautifulSoup(fp, 'html.parser') for pre in soup.find_all("pre", class_="fragment"): if pre.string.find("<p>") != -1: print(f"{filename}:{pre.sourceline}:" f"{str(pre).split(' ')[0]}") Change-Id: If351a5be24b21b24a4d7892a9185353e8691feb1 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/201134 Tested-by: Jenkins Reviewed-by: Neil Roberts <[email protected]> diff --git a/offapi/com/sun/star/accessibility/AccessibleTableModelChangeType.idl b/offapi/com/sun/star/accessibility/AccessibleTableModelChangeType.idl index 23e549f397d9..ccec875b11af 100644 --- a/offapi/com/sun/star/accessibility/AccessibleTableModelChangeType.idl +++ b/offapi/com/sun/star/accessibility/AccessibleTableModelChangeType.idl @@ -21,19 +21,19 @@ module com { module sun { module star { module accessibility { /** Type of a change made to a table model. - <p>The value of this constants group are used by the - AccessibleTableModelChange structure to specify the - type of change that has been made to a table model.</p> - - <p>Four of the constants, - AccessibleTableModelChangeType::ROWS_INSERTED, - AccessibleTableModelChangeType::COLUMNS_INSERTED, - AccessibleTableModelChangeType::ROWS_REMOVED and - AccessibleTableModelChangeType::COLUMNS_REMOVED describe - changes to the table's geometry. One or more rows or columns have - been inserted or removed. In contrast, the remaining constant - AccessibleTabelModelChangeType::UPDATE specifies a - change of the table's content.</p> + <p>The value of this constants group are used by the + AccessibleTableModelChange structure to specify the + type of change that has been made to a table model.</p> + + <p>Four of the constants, + AccessibleTableModelChangeType::ROWS_INSERTED, + AccessibleTableModelChangeType::COLUMNS_INSERTED, + AccessibleTableModelChangeType::ROWS_REMOVED and + AccessibleTableModelChangeType::COLUMNS_REMOVED describe + changes to the table's geometry. One or more rows or columns have + been inserted or removed. In contrast, the remaining constant + AccessibleTabelModelChangeType::UPDATE specifies a + change of the table's content.</p> @since OOo 1.1.2 */ diff --git a/offapi/com/sun/star/drawing/GenericDrawPage.idl b/offapi/com/sun/star/drawing/GenericDrawPage.idl index ee46bd26cdbd..c94d2a3beecf 100644 --- a/offapi/com/sun/star/drawing/GenericDrawPage.idl +++ b/offapi/com/sun/star/drawing/GenericDrawPage.idl @@ -42,11 +42,11 @@ published service GenericDrawPage /** manages the Shapes of this page. - <p>It also lets you add new Shapes. The program currently - requires that these Shapes be created by the factory of - the document. + <p>It also lets you add new Shapes. The program currently + requires that these Shapes be created by the factory of + the document. - @see DrawingDocument + @see DrawingDocument */ interface com::sun::star::drawing::XShapes; @@ -67,7 +67,7 @@ published service GenericDrawPage /** Gets or sets the name of this page. - <p>Duplicated page names inside a document are not allowed. + <p>Duplicated page names inside a document are not allowed. */ [optional] interface com::sun::star::container::XNamed; diff --git a/offapi/com/sun/star/drawing/LayerManager.idl b/offapi/com/sun/star/drawing/LayerManager.idl index e984ac8361a7..652163076fdd 100644 --- a/offapi/com/sun/star/drawing/LayerManager.idl +++ b/offapi/com/sun/star/drawing/LayerManager.idl @@ -39,8 +39,8 @@ published service LayerManager /** gives access to the existing Layers by name. - <p>The contents of the collection all support Layer - returned by XLayer. + <p>The contents of the collection all support Layer + returned by XLayer. */ interface com::sun::star::container::XNameAccess; diff --git a/offapi/com/sun/star/sdbc/ResultSet.idl b/offapi/com/sun/star/sdbc/ResultSet.idl index 26771a1a1bed..99ca95ff3078 100644 --- a/offapi/com/sun/star/sdbc/ResultSet.idl +++ b/offapi/com/sun/star/sdbc/ResultSet.idl @@ -86,14 +86,14 @@ published service ResultSet /** freeing all resources of a result set. - <p> - The creating statement will still be open after disposing. - </p> + <p> + The creating statement will still be open after disposing. + </p> - <p> - This interface is mandatory only for JDBC conformance, - otherwise it is optional. - </p> + <p> + This interface is mandatory only for JDBC conformance, + otherwise it is optional. + </p> */ [optional] interface XCloseable; @@ -127,9 +127,9 @@ published service ResultSet /** is the interface for updating row data to the database. - <p> - The implementation is optional. - </p> + <p> + The implementation is optional. + </p> */ [optional] interface XResultSetUpdate; @@ -146,9 +146,9 @@ published service ResultSet /** is the interface for updating the data of the current row. - <p> - The implementation is optional. - </p> + <p> + The implementation is optional. + </p> */ [optional] interface XRowUpdate; diff --git a/offapi/com/sun/star/sdbc/XPooledConnection.idl b/offapi/com/sun/star/sdbc/XPooledConnection.idl index 13ec1e26bc8e..4bbc35746da3 100644 --- a/offapi/com/sun/star/sdbc/XPooledConnection.idl +++ b/offapi/com/sun/star/sdbc/XPooledConnection.idl @@ -23,7 +23,7 @@ /** defines a pooled connection which can share an unused connection. -<!-- JRH: unclear meaning --> + <!-- JRH: unclear meaning --> <p> PoolConnections are handled by the connection pool. diff --git a/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl b/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl index 2e46ad388045..f2dabc3d7899 100644 --- a/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl +++ b/offapi/com/sun/star/sheet/SpreadsheetDrawPage.idl @@ -46,11 +46,11 @@ published service SpreadsheetDrawPage /** manages the com::sun::star::drawing::Shapes of this page. - <p>It also lets you add new com::sun::star::drawing::Shapes. The program currently - requires that these com::sun::star::drawing::Shapes be created by the factory of - the document. + <p>It also lets you add new com::sun::star::drawing::Shapes. The program currently + requires that these com::sun::star::drawing::Shapes be created by the factory of + the document. - @see SpreadsheetDocument + @see SpreadsheetDocument */ interface com::sun::star::drawing::XDrawPage; diff --git a/offapi/com/sun/star/text/BaseFrame.idl b/offapi/com/sun/star/text/BaseFrame.idl index 25bab7a36da5..c59b45dc3ad3 100644 --- a/offapi/com/sun/star/text/BaseFrame.idl +++ b/offapi/com/sun/star/text/BaseFrame.idl @@ -53,8 +53,8 @@ published service BaseFrame interface com::sun::star::beans::XPropertySet; /** This interface specifies the name of this text frame. - <p>The name may be set automatically by the container if it is not - set when inserted. In this case a random, unique name is assigned. + <p>The name may be set automatically by the container if it is not + set when inserted. In this case a random, unique name is assigned. */ interface com::sun::star::container::XNamed; /** contains the name of the frame style that is applied to this object. diff --git a/offapi/com/sun/star/text/Bookmarks.idl b/offapi/com/sun/star/text/Bookmarks.idl index 1f4f99bdbba3..29030ffd80a0 100644 --- a/offapi/com/sun/star/text/Bookmarks.idl +++ b/offapi/com/sun/star/text/Bookmarks.idl @@ -28,12 +28,12 @@ published service Bookmarks /** makes it possible to access the bookmarks by their names. - <p>All contents support the service Bookmark. + <p>All contents support the service Bookmark. */ interface com::sun::star::container::XNameAccess; /** makes it possible to access the bookmarks by their index. - <p>All contents support the service Bookmark. + <p>All contents support the service Bookmark. */ interface com::sun::star::container::XIndexAccess; diff --git a/offapi/com/sun/star/text/HoriOrientation.idl b/offapi/com/sun/star/text/HoriOrientation.idl index 85d1206c4ecc..14a13642d3d1 100644 --- a/offapi/com/sun/star/text/HoriOrientation.idl +++ b/offapi/com/sun/star/text/HoriOrientation.idl @@ -27,11 +27,11 @@ published constants HoriOrientation { /** no hard alignment is applied. - <p>For text tables this means that the tables position is - defined by the left and right margins. + <p>For text tables this means that the tables position is + defined by the left and right margins. - <p>For frame objects (text frames, graphics,...) this means - that the position is defined by a left offset. + <p>For frame objects (text frames, graphics,...) this means + that the position is defined by a left offset. */ const short NONE = 0; diff --git a/offapi/com/sun/star/text/NumberingLevel.idl b/offapi/com/sun/star/text/NumberingLevel.idl index 25e5c4f39e41..68ace48d36ab 100644 --- a/offapi/com/sun/star/text/NumberingLevel.idl +++ b/offapi/com/sun/star/text/NumberingLevel.idl @@ -167,63 +167,63 @@ published service NumberingLevel /** position and space mode - <p> - Specifies the position and space mode of the numbering level. - For valid values see com::sun::star::text::PositionAndSpaceMode. - If it equals LABEL_WIDTH_AND_POSITION, properties Adjust, - LeftMargin, SymbolTextDistance and FirstLineOffset are used. - If it equals LABEL_ALIGNMENT, properties Adjust, LabelFollowedBy, - ListtabStopPosition, FirstLineIndent, IndentAt are used. - </p> - - @since OOo 3.0 + <p> + Specifies the position and space mode of the numbering level. + For valid values see com::sun::star::text::PositionAndSpaceMode. + If it equals LABEL_WIDTH_AND_POSITION, properties Adjust, + LeftMargin, SymbolTextDistance and FirstLineOffset are used. + If it equals LABEL_ALIGNMENT, properties Adjust, LabelFollowedBy, + ListtabStopPosition, FirstLineIndent, IndentAt are used. + </p> + + @since OOo 3.0 */ [optional, property] short PositionAndSpaceMode; /** character following the list label - <p> - Specifies the character following the list label. - For valid values see com::sun::star::text::LabelFollow. - Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. - </p> + <p> + Specifies the character following the list label. + For valid values see com::sun::star::text::LabelFollow. + Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. + </p> - @since OOo 3.0 + @since OOo 3.0 */ [optional, property] short LabelFollowedBy; /** list tab position - <p> - Specifies the position of the list tab stop - only non-negative - values are allowed. - Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT - and LabelFollowedBy equal LABELFOLLOW_LISTTAB - </p> + <p> + Specifies the position of the list tab stop - only non-negative + values are allowed. + Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT + and LabelFollowedBy equal LABELFOLLOW_LISTTAB + </p> - @since OOo 3.0 + @since OOo 3.0 */ [optional, property] long ListtabStopPosition; /** additional line indent for the first text line - <p> - Specifies the first line indent. - Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. - </p> + <p> + Specifies the first line indent. + Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. + </p> - @since OOo 3.0 + @since OOo 3.0 */ [optional, property] long FirstLineIndent; /** indentation of the text lines - <p> - Specifies the indent of the text lines - Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. - </p> + <p> + Specifies the indent of the text lines + Only of relevance, if PositionAndSpaceMode equals LABEL_ALIGNMENT. + </p> - @since OOo 3.0 + @since OOo 3.0 */ [optional, property] long IndentAt; }; diff --git a/offapi/com/sun/star/text/NumberingRules.idl b/offapi/com/sun/star/text/NumberingRules.idl index 9b12477f8f95..c99ff22e90f1 100644 --- a/offapi/com/sun/star/text/NumberingRules.idl +++ b/offapi/com/sun/star/text/NumberingRules.idl @@ -29,9 +29,9 @@ published service NumberingRules { /** provides access to the levels of the numbering rule. - <p>The numbering rules are levels of property values. Each - level contains equal properties.</p> - @see NumberingLevel + <p>The numbering rules are levels of property values. Each + level contains equal properties.</p> + @see NumberingLevel */ interface com::sun::star::container::XIndexReplace; diff --git a/offapi/com/sun/star/text/Paragraph.idl b/offapi/com/sun/star/text/Paragraph.idl index b7d5b8d9945e..b3170fc2d72c 100644 --- a/offapi/com/sun/star/text/Paragraph.idl +++ b/offapi/com/sun/star/text/Paragraph.idl @@ -65,13 +65,13 @@ published service Paragraph /** This interface enumerates the text portions of this paragraph. - <p>A text portion is defined as the largest possible TextRange - within a paragraph with the same property values and the same bound objects. + <p>A text portion is defined as the largest possible TextRange + within a paragraph with the same property values and the same bound objects. - <p>In general this interface is used for exporting into file - formats. + <p>In general this interface is used for exporting into file + formats. - @see com::sun::star::text::TextRange@see com::sun::star::text::TextRange + @see com::sun::star::text::TextRange@see com::sun::star::text::TextRange */ interface com::sun::star::container::XEnumerationAccess; diff --git a/offapi/com/sun/star/text/XTextContentAppend.idl b/offapi/com/sun/star/text/XTextContentAppend.idl index 76743fe9da18..7dd581a8b845 100644 --- a/offapi/com/sun/star/text/XTextContentAppend.idl +++ b/offapi/com/sun/star/text/XTextContentAppend.idl @@ -28,9 +28,9 @@ interface XTextContentAppend : com::sun::star::uno::XInterface /** appends a text content at the end of the text. - <p> The sequence can contain all the properties defined by the service - Paragraph. - </p> + <p> The sequence can contain all the properties defined by the service + Paragraph. + </p> @param TextContent contains the object to be inserted. diff --git a/offapi/com/sun/star/text/XTextPortionAppend.idl b/offapi/com/sun/star/text/XTextPortionAppend.idl index 1f0c0da63ab3..fcad3bca24c7 100644 --- a/offapi/com/sun/star/text/XTextPortionAppend.idl +++ b/offapi/com/sun/star/text/XTextPortionAppend.idl @@ -28,8 +28,8 @@ interface XTextPortionAppend : com::sun::star::uno::XInterface /** appends a new text portion to the paragraph at the end of the text. - <p> The sequence can contain all the properties defined by the service TextPortion. - </p> + <p> The sequence can contain all the properties defined by the service TextPortion. + </p> @param Text contains the text to be appended. @@ -47,8 +47,8 @@ interface XTextPortionAppend : com::sun::star::uno::XInterface /** inserts a new text portion to the paragraph at a given position. - <p> The sequence can contain all the properties defined by the service TextPortion. - </p> + <p> The sequence can contain all the properties defined by the service TextPortion. + </p> @param Text contains the text to be inserted. diff --git a/offapi/com/sun/star/view/PrintOptions.idl b/offapi/com/sun/star/view/PrintOptions.idl index 3941b6e5dd62..386ee297ddf3 100644 --- a/offapi/com/sun/star/view/PrintOptions.idl +++ b/offapi/com/sun/star/view/PrintOptions.idl @@ -58,7 +58,7 @@ published service PrintOptions /** if set to TRUE, the corresponding XPrintable.print() request will be executed synchronous. - <p>Default is the asynchronous print mode.</p> + <p>Default is the asynchronous print mode.</p> @attention Using of this property with TRUE as value is highly recommended. Otherwise following actions (as e.g. closing the corresponding model) can fail. diff --git a/udkapi/com/sun/star/beans/PropertyAttribute.idl b/udkapi/com/sun/star/beans/PropertyAttribute.idl index bddfd1cd251c..960fde981450 100644 --- a/udkapi/com/sun/star/beans/PropertyAttribute.idl +++ b/udkapi/com/sun/star/beans/PropertyAttribute.idl @@ -44,7 +44,7 @@ published constants PropertyAttribute to all registered XVetoableChangeListeners whenever the value of this property is about to change. - <p>This always implies that the property is <em>bound</em>, too. </p> + <p>This always implies that the property is <em>bound</em>, too. </p> */ const short CONSTRAINED = 4; diff --git a/udkapi/com/sun/star/script/XDebugging.idl b/udkapi/com/sun/star/script/XDebugging.idl index d76b1b784918..37c3c8610798 100644 --- a/udkapi/com/sun/star/script/XDebugging.idl +++ b/udkapi/com/sun/star/script/XDebugging.idl @@ -28,10 +28,10 @@ published interface XDebugging: com::sun::star::uno::XInterface { /** returns the source code line where the breakpoint was set. - <p>The value can differ from the parameter - <var>nSourceCodeLine</var> when this is not a valid line to - place it. -1 indicates that the breakpoint cannot be set at - this position. + <p>The value can differ from the parameter + <var>nSourceCodeLine</var> when this is not a valid line to + place it. -1 indicates that the breakpoint cannot be set at + this position. */ long setBreakPoint( [in] string aModuleName, [in] long nSourceCodeLine, diff --git a/udkapi/com/sun/star/script/XInvocation.idl b/udkapi/com/sun/star/script/XInvocation.idl index 081d57c113ed..162a39beb2fe 100644 --- a/udkapi/com/sun/star/script/XInvocation.idl +++ b/udkapi/com/sun/star/script/XInvocation.idl @@ -88,22 +88,22 @@ published interface XInvocation: com::sun::star::uno::XInterface ( XInvocation::hasMethod(), XInvocation::invoke() )!</p> - @param aName - specifies the name of the method. + @param aName + specifies the name of the method. */ boolean hasMethod( [in] string aName ); /** returns `TRUE` if the property with the specified name exists, else `FALSE`. - <p>This optimizes the calling sequence - ( XInvocation::hasProperty(), - XInvocation::getValue() ) or + <p>This optimizes the calling sequence + ( XInvocation::hasProperty(), + XInvocation::getValue() ) or - ( XInvocation::hasProperty(), - XInvocation::setValue() )! + ( XInvocation::hasProperty(), + XInvocation::setValue() )! - @param aName - specifies the name of the property. + @param aName + specifies the name of the property. */ boolean hasProperty( [in] string aName );
