Mention difference between _set and _copy.

SVN-Revision: 1950

diff --git a/libarchive/archive_entry_paths.3 b/libarchive/archive_entry_paths.3
index a2f8af27038ed895435aab8f28d68aea35754c72..50114cabab6e23524a9b9a777dc728c1046d569e 100644 (file)
--- a/libarchive/archive_entry_paths.3
+++ b/libarchive/archive_entry_paths.3
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 21, 2010
+.Dd February 22, 2010
 .Dt archive_entry_paths 3
 .Os
 .Sh NAME
@@ -142,6 +142,20 @@ For that reason, it is only available as multibyte string.
 The link path is a convience function for conditionally setting
 hardlink or symlink destination.
 It doesn't have a corresponding get accessor function.
+.Pp
+The
+.Fn archive_entry_set_XXX
+functions store a reference to the given string internally.
+They require the caller to keep the string valid until the string
+is cleared either by setting it to a different location, by calling
+the corresponding copy function or by calling
+.Xr archive_entry_clear 3
+or
+.Xr archive_entry_free 3 .
+The
+.Fn archive_entry_copy_XXX
+functions do not have this restriction as they keep an internal
+copy of the argument.
 .Sh SEE ALSO
 .Xr archive 3 ,
 .Xr archive_entry 3