core.git: sw/source

[Miklos Vajna (via logerrit)]

 sw/source/core/inc/frame.hxx |    4 ++++
 1 file changed, 4 insertions(+)

New commits:
commit c4ba535eccf1e264d7c9feea48156a2b48000dd6
Author:     Miklos Vajna <vmik...@collabora.com>
AuthorDate: Mon Dec 11 20:44:28 2023 +0100
Commit:     Miklos Vajna <vmik...@collabora.com>
CommitDate: Tue Dec 12 08:23:00 2023 +0100

    sw: document SwFrame::Paste()
    
    It was clear we want to insert a frame, but which frame is to be
    inserted and if that will be before or after the non-parent frame was
    far from clear. Document this based on how it's implemented in
    SwContentFrame::Paste() and SwFrame::InsertBefore().
    
    Change-Id: I3eea471f9feecb35e20910e1869f5db1406d7c43
    Reviewed-on: https://gerrit.libreoffice.org/c/core/+/160603
    Tested-by: Jenkins
    Reviewed-by: Miklos Vajna <vmik...@collabora.com>

diff --git a/sw/source/core/inc/frame.hxx b/sw/source/core/inc/frame.hxx
index d57654f6a9e7..1c5aa331f927 100644
--- a/sw/source/core/inc/frame.hxx
+++ b/sw/source/core/inc/frame.hxx
@@ -761,6 +761,10 @@ public:
     virtual Size ChgSize( const Size& aNewSize );
 
     virtual void Cut() = 0;
+
+    /// Inserts the current frame under pParent, before pSibling.
+    ///
+    /// If pSibling is nullptr, then insert under pParent, at the end.
     virtual void Paste( SwFrame* pParent, SwFrame* pSibling = nullptr ) = 0;
 
     void ValidateLineNum() { mbValidLineNum = true; }