From 635967d74f2dd728605e788267b8784f3c5a9fac Mon Sep 17 00:00:00 2001
From: Tilman Hausherr <tilman@apache.org>
Date: Wed, 30 Oct 2024 14:30:28 +0000
Subject: [PATCH] PDFBOX-5660: improve javadoc

git-svn-id: https://svn.apache.org/repos/asf/pdfbox/trunk@1921686 13f79535-47bb-0310-9956-ffa450edef68
---
 .../logicalstructure/PDStructureNode.java                 | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/documentinterchange/logicalstructure/PDStructureNode.java b/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/documentinterchange/logicalstructure/PDStructureNode.java
index f8fe61aaebc..6e2db58ec41 100644
--- a/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/documentinterchange/logicalstructure/PDStructureNode.java
+++ b/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/documentinterchange/logicalstructure/PDStructureNode.java
@@ -144,7 +144,7 @@ public void setKids(List<Object> kids)
     }
 
     /**
-     * Appends a structure element kid.
+     * Appends a structure element kid and sets the parent property (/P) to this.
      * 
      * @param structureElement the structure element
      */
@@ -270,10 +270,10 @@ protected void insertBefore(COSBase newKid, Object refKid)
     }
 
     /**
-     * Removes a structure element kid.
-     * 
+     * Removes a structure element kid and if successful also removes the parent property (/P).
+     *
      * @param structureElement the structure element
-     * @return <code>true</code> if the kid was removed, <code>false</code> otherwise
+     * @return <code>true</code> if the kid was removed, <code>false</code> otherwise.
      */
     public boolean removeKid(PDStructureElement structureElement)
     {