diff --git a/artifacts/scripting/functions.yml b/artifacts/scripting/functions.yml
index 61dc5a51..8c37ec8e 100644
--- a/artifacts/scripting/functions.yml
+++ b/artifacts/scripting/functions.yml
@@ -906,7 +906,10 @@
     opcode: 0x8177
   - name: set_pipboy_available
     detail: void set_pipboy_available(int available)
-    doc: Sets the availability of the pipboy in the game. Use 0 to disable the pipboy, and 1 or 2 to enable it (value 2 does not mark the `VSUIT_MOVIE` movie as "played").
+    doc: |
+      Sets the availability of the pipboy in the game. Use 0 to disable the pipboy, and 1 or 2 to enable it (value 2 does not change the player's default appearance).
+      - The availability state will be reset each time the player reloads the game.
+      - __NOTE:__ starting from sfall 4.4.6/3.8.46, value 1 no longer marks the `VSUIT_MOVIE` movie as "played". Use `mark_movie_played(VSUIT_MOVIE)` instead if you want the old behavior.
     opcode: 0x818b
   - name: get_kill_counter
     detail: int get_kill_counter(int critterType)