From: Christian Grothoff <christian@grothoff.org>
Date: Wed, 13 Jun 2012 16:00:14 +0000 (+0000)
Subject: -document error possibilities better (#2416)
X-Git-Tag: initial-import-from-subversion-38251~13085
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=b658d1469d6bdaf5930867151130903d221fae37;p=oweals%2Fgnunet.git

-document error possibilities better (#2416)
---

diff --git a/src/fs/fs_namespace.c b/src/fs/fs_namespace.c
index c88dbb591..0c7b445ad 100644
--- a/src/fs/fs_namespace.c
+++ b/src/fs/fs_namespace.c
@@ -232,7 +232,7 @@ END:
  *
  * @param h handle to the file sharing subsystem
  * @param name name to use for the namespace
- * @return handle to the namespace, NULL on error
+ * @return handle to the namespace, NULL on error (i.e. invalid filename)
  */
 struct GNUNET_FS_Namespace *
 GNUNET_FS_namespace_create (struct GNUNET_FS_Handle *h, const char *name)
diff --git a/src/fs/gnunet-publish.c b/src/fs/gnunet-publish.c
index 24e49d369..4b13a16bd 100644
--- a/src/fs/gnunet-publish.c
+++ b/src/fs/gnunet-publish.c
@@ -355,7 +355,7 @@ uri_ksk_continuation (void *cls, const struct GNUNET_FS_Uri *ksk_uri,
     ns = GNUNET_FS_namespace_create (ctx, pseudonym);
     if (ns == NULL)
     {
-      FPRINTF (stderr, _("Failed to create namespace `%s'\n"), pseudonym);
+      FPRINTF (stderr, _("Failed to create namespace `%s' (illegal filename?)\n"), pseudonym);
       ret = 1;
     }
     else
@@ -609,7 +609,7 @@ run (void *cls, char *const *args, const char *cfgfile,
     namespace = GNUNET_FS_namespace_create (ctx, pseudonym);
     if (NULL == namespace)
     {
-      FPRINTF (stderr, _("Could not create namespace `%s'\n"), pseudonym);
+      FPRINTF (stderr, _("Failed to create namespace `%s' (illegal filename?)\n"), pseudonym);
       GNUNET_FS_stop (ctx);
       ret = 1;
       return;
diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h
index eaff18320..086fec5eb 100644
--- a/src/include/gnunet_fs_service.h
+++ b/src/include/gnunet_fs_service.h
@@ -2211,7 +2211,7 @@ GNUNET_FS_namespace_advertise_cancel (struct GNUNET_FS_AdvertisementContext *ac)
  *
  * @param h handle to the file sharing subsystem
  * @param name name to use for the namespace
- * @return handle to the namespace, NULL on error
+ * @return handle to the namespace, NULL on error (i.e. invalid filename)
  */
 struct GNUNET_FS_Namespace *
 GNUNET_FS_namespace_create (struct GNUNET_FS_Handle *h, const char *name);