From d36a72aff45949124da4bb94faee244a75dfe4a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Sun, 21 Mar 2004 12:34:16 +0000
Subject: [PATCH] document krb5_copy_host_realm

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@13592 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_set_default_realm.3 | 26 +++++++++++++++++++++-----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/lib/krb5/krb5_set_default_realm.3 b/lib/krb5/krb5_set_default_realm.3
index fe28d8616..6ce6e413c 100644
--- a/lib/krb5/krb5_set_default_realm.3
+++ b/lib/krb5/krb5_set_default_realm.3
@@ -31,14 +31,15 @@
 .\"
 .\" $Id$
 .\"
-.Dd March 16, 2003
+.Dd March 21, 2004
 .Dt KRB5_SET_DEFAULT_REALM 3
 .Os HEIMDAL
 .Sh NAME
-.Nm krb5_free_host_realm
-.Nm krb5_get_default_realm
-.Nm krb5_get_default_realms
-.Nm krb5_get_host_realm
+.Nm krb5_copy_host_realm ,
+.Nm krb5_free_host_realm ,
+.Nm krb5_get_default_realm ,
+.Nm krb5_get_default_realms ,
+.Nm krb5_get_host_realm ,
 .Nm krb5_set_default_realm
 .Nd default and host realm read and manipulation routines
 .Sh LIBRARY
@@ -46,6 +47,12 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Sh SYNOPSIS
 .In krb5.h
 .Ft krb5_error_code
+.Fo krb5_copy_host_realm
+.Fa "krb5_context context"
+.Fa "const krb5_realm *from"
+.Fa "krb5_realm **to"
+.Fc
+.Ft krb5_error_code
 .Fo krb5_free_host_realm
 .Fa "krb5_context context"
 .Fa "krb5_realm *realmlist"
@@ -72,6 +79,15 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "const char *realm"
 .Fc
 .Sh DESCRIPTION
+.Fn krb5_copy_host_realm
+copies the list of realms from
+.Fa from
+to
+.Fa to .
+.Fa to
+should be freed by the caller using
+.Fa krb5_free_host_realm .
+.Pp
 .Fn krb5_free_host_realm
 frees all memory allocated by
 .Fa realmlist .