diff --git a/functions.rst b/functions.rst
index 94a6405..a0e17b6 100644
--- a/functions.rst
+++ b/functions.rst
@@ -506,6 +506,8 @@ Adds a weapon to a client.
 * **ammoclip** is the number of ammo clip to add.
 * **setcurrent** sets the weapon as current weapon if 1, or does not select it if 0.
 
+.. note:: Adding a weapon does not automatically add its associated alternate weapon.
+
 
 et.RemoveWeaponFromPlayer( clientNum, weapon )
 ----------------------------------------------
@@ -515,6 +517,8 @@ Removes a weapon from a client.
 * **clientNum** is the slot number of the client.
 * **weapon** is the weapon to add. See `et.WP_* constants <constants.html#wp-constants>`__ for possible values.
 
+.. note:: Removing a weapon also removes its associated alternate weapon.
+
 
 Entities
 ========
diff --git a/misc.rst b/misc.rst
index bd4b7c7..370e0e5 100644
--- a/misc.rst
+++ b/misc.rst
@@ -230,6 +230,8 @@ Replace any texture::
 * **NewShader** is the new shader.
 * **#** is the Timeoffset, which currently should be left as 0.
 
+.. note:: Use `et.G_ShaderRemap() <functions.html#et-g-shaderremap-oldshader-newshader>`__ instead.
+
 
 Damage bitflags
 ===============