From 1c4a91858b528746c602df434c96754f26a55598 Mon Sep 17 00:00:00 2001
From: "Ian Eborn (Thaumaturge)"
 <36933600+ArsThaumaturgis@users.noreply.github.com>
Date: Tue, 14 Nov 2023 14:34:28 +0200
Subject: [PATCH] grutil: Change docstring for MeshDrawer link_segment method

In short, this adds notes regarding the manner in which the method makes use of the "frame" and "color" parameters.

Fixes #1560
Closes #1569
---
 panda/src/grutil/meshDrawer.cxx | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/panda/src/grutil/meshDrawer.cxx b/panda/src/grutil/meshDrawer.cxx
index b87380d3b8..b52a1249cd 100644
--- a/panda/src/grutil/meshDrawer.cxx
+++ b/panda/src/grutil/meshDrawer.cxx
@@ -416,6 +416,11 @@ void MeshDrawer::geometry(NodePath draw_node) {
 /**
  * Stars or continues linked segment.  Control position, frame, thickness and
  * color with parameters.  Frame contains u,v,u-size,v-size quadruple.
+ * Note that for the first two calls to this method, the "frame" parameter is
+ * ignored; it first takes effect as of the third call.
+ * Similarly, note that in the second call to this method, the "color" parameter
+ * is ignored; it only has effect in the first call and calls from the third
+ * onwards.
  */
 void MeshDrawer::
 link_segment(const LVector3 &pos, const LVector4 &frame,