diff --git a/docs/web/docs/TraCI/Vehicle_Value_Retrieval.md b/docs/web/docs/TraCI/Vehicle_Value_Retrieval.md
index f9a3464874bb..b1d60325f0be 100644
--- a/docs/web/docs/TraCI/Vehicle_Value_Retrieval.md
+++ b/docs/web/docs/TraCI/Vehicle_Value_Retrieval.md
@@ -586,7 +586,7 @@ Some further messages require additional parameters.
change lane information (0x13) |
compound , see below |
int, int see below |
-Return whether the vehicle could change lanes in the specified direction (right: -1, left: 1. sublane-change within current lane: 0).
+ | Return whether the vehicle could change lanes in the specified direction in the previous step (right: -1, left: 1. sublane-change within current lane: 0).
Return the lane change state for the vehicle. |
getLaneChangeState couldChangeLane wantsAndCouldChangeLane |
diff --git a/tools/traci/_vehicle.py b/tools/traci/_vehicle.py
index 8ee81f29d02e..1e095e19d74d 100644
--- a/tools/traci/_vehicle.py
+++ b/tools/traci/_vehicle.py
@@ -940,7 +940,10 @@ def prettifyBitstring(intval):
def couldChangeLane(self, vehID, direction, state=None):
"""couldChangeLane(string, int) -> bool
- Return whether the vehicle could change lanes in the specified direction
+ Return whether the vehicle could change lanes in the specified direction.
+ This reflects the state after the last try to change lanes.
+ If you want to execute changeLane as a result of the evaluation of this function
+ it is not guaranteed to work because vehicle movements occur first.
"""
if state is None:
state, stateTraCI = self.getLaneChangeState(vehID, direction)
@@ -952,6 +955,9 @@ def couldChangeLane(self, vehID, direction, state=None):
def wantsAndCouldChangeLane(self, vehID, direction, state=None):
"""wantsAndCouldChangeLane(string, int) -> bool
Return whether the vehicle wants to and could change lanes in the specified direction
+ This reflects the state after the last try to change lanes.
+ If you want to execute changeLane as a result of the evaluation of this function
+ it is not guaranteed to work because vehicle movements occur first.
"""
if state is None:
state, stateTraCI = self.getLaneChangeState(vehID, direction)