Merge pull request #9952 from EOSIO/docs/2.1.x-various-fixes

[docs] 2.1.x - improve annotation for db_update_i64

libraries/chain/include/eosio/chain/webassembly/interface.hpp

@@ -792,7 +792,13 @@ namespace webassembly {
           * @param itr - iterator to the table row containing the record to update.
           * @param payer -  the account that pays for the storage costs.
           * @param buffer - new updated record.
-          *
+          * 
+          * @remark This function does not allow changing the primary key of a 
+          * table row. The serialized data that is stored in the table row of a 
+          * primary table may include a primary key and that primary key value 
+          * could be changed by the contract calling the db_update_i64 intrinsic; 
+          * but that does not change the actual primary key of the table row.
+          * 
           * @pre `itr` points to an existing table row in the table.
           * @post the record contained in the table row pointed to by `itr` is replaced with the new updated record.
           */