[GNUnet-SVN] r29157 - gnunet-gtk/src/fs

[gnunet]

Author: grothoff
Date: 2013-09-10 13:30:48 +0200 (Tue, 10 Sep 2013)
New Revision: 29157

Modified:
   gnunet-gtk/src/fs/gnunet-fs-gtk_publish-dialog.c
Log:
stylistic fixes

Modified: gnunet-gtk/src/fs/gnunet-fs-gtk_publish-dialog.c
===================================================================
--- gnunet-gtk/src/fs/gnunet-fs-gtk_publish-dialog.c    2013-09-10 11:06:17 UTC 
(rev 29156)
+++ gnunet-gtk/src/fs/gnunet-fs-gtk_publish-dialog.c    2013-09-10 11:30:48 UTC 
(rev 29157)
@@ -82,7 +82,7 @@
     /**
      * A guint.
      */
-    PUBLISH_MC_REPLICATION_LEVEL = 7,
+    PUBLISH_MC_REPLICATION_LEVEL = 7
   };
 
 
@@ -114,7 +114,7 @@
     /**
      * A gchararray.
      */
-    IDENTIFIERS_MC_ID_MARKED_UP = 4,
+    IDENTIFIERS_MC_ID_MARKED_UP = 4
   };
 
 
@@ -424,7 +424,7 @@
  * @param tm tree model of the iterators
  * @param i1 first iterator
  * @param i2 second iterator
- * @return GNUNET_YES if they are equal
+ * @return #GNUNET_YES if they are equal
  */
 static int
 gtk_tree_iter_equals (GtkTreeModel *tm,
@@ -628,8 +628,8 @@
  * @param tm tree model for the move operation
  * @param old old position (source of the copy operation)
  * @param newpos destination of the copy operation
- * @param dsel GNUNET_YES for the top-level operation,
- *             GNUNET_NO for the recursive calls; if GNUNET_YES,
+ * @param dsel #GNUNET_YES for the top-level operation,
+ *             #GNUNET_NO for the recursive calls; if #GNUNET_YES,
  *             we ensure that the tree view is expanded to cover
  *             the element; the element is also then selected
  */
@@ -725,6 +725,7 @@
   }
 }
 
+
 /**
  * Called when global ns publication checkbox is toggled.
  * Adjusts execute/cancel button sensitivity.
@@ -739,6 +740,7 @@
   update_selectivity_execute_cancel (user_data);
 }
 
+
 /**
  * Called when private ns publication checkbox is toggled.
  * Adjusts execute/cancel button sensitivity.
@@ -753,6 +755,7 @@
   update_selectivity_execute_cancel (user_data);
 }
 
+
 /**
  * Called when updateability checkbox is toggled.
  * Adjusts execute/cancel button sensitivity.
@@ -767,6 +770,7 @@
   update_selectivity_execute_cancel (user_data);
 }
 
+
 /**
  * Generates an update id from a new id.
  *
@@ -826,6 +830,7 @@
   return result;
 }
 
+
 /**
  * Generates a new update id and fills the entry, if necessary.
  * Stores new identifier as previous_id in the context struct.
@@ -835,7 +840,7 @@
  */
 static void
 maybe_change_update_id (struct MainPublishingDialogContext *ctx,
-    const gchar *new_text)
+                       const gchar *new_text)
 {
   const gchar *existing_update_id;
   gchar *new_update_id;
@@ -854,6 +859,7 @@
   ctx->previous_id = g_strdup (new_text);
 }
 
+
 /**
  * Called when identifier entry contents are changed by anything.
  * Generates a new update id and fills the entry, if necessary.
@@ -1145,7 +1151,7 @@
 {
   GtkTreeRowReference *row = *client_info;
 
-  if (row == NULL)
+  if (NULL == row)
   {
     GNUNET_break (0);
     return GNUNET_OK;
@@ -1872,9 +1878,9 @@
 
 /**
  * Update tree view based on the information from the
- * GNUNET_FS_FileInformation publish-structure.
+ * `struct GNUNET_FS_FileInformation` for publishing.
  *
- * @param cls closure, a 'struct EditPublishContext *'
+ * @param cls closure, a `struct EditPublishContext *`
  * @param fi the entry in the publish-structure
  * @param length length of the file or directory
  * @param meta metadata for the file or directory (can be modified)
@@ -1882,8 +1888,8 @@
  * @param bo block options (can be modified)
  * @param do_index should we index (can be modified)
  * @param client_info pointer to client context set upon creation (can be 
modified)
- * @return GNUNET_OK to continue, GNUNET_NO to remove
- *         this entry from the directory, GNUNET_SYSERR
+ * @return #GNUNET_OK to continue, #GNUNET_NO to remove
+ *         this entry from the directory, #GNUNET_SYSERR
  *         to abort the iteration
  */
 static int
@@ -1967,11 +1973,9 @@
 }
 
 
-
 /* ******************** master edit dialog shutdown *********************** */
 
 
-
 /**
  * Get the file information struct corresponding to the
  * given iter in the publish dialog tree model.  Recursively
@@ -2039,7 +2043,7 @@
  * memory and the window itself.
  *
  * @param ctx master dialog context
- * @return GNUNET_NO if we cannot clean up right now (sub-windows are still 
open)
+ * @return #GNUNET_NO if we cannot clean up right now (sub-windows are still 
open)
  */
 static int
 close_master_publish_dialog (struct MainPublishingDialogContext *ctx)
@@ -2083,8 +2087,8 @@
  * @param bo block options (can be modified)
  * @param do_index should we index (can be modified)
  * @param client_info pointer to client context set upon creation (can be 
modified)
- * @return GNUNET_OK to continue, GNUNET_NO to remove
- *         this entry from the directory, GNUNET_SYSERR
+ * @return #GNUNET_OK to continue, #GNUNET_NO to remove
+ *         this entry from the directory, #GNUNET_SYSERR
  *         to abort the iteration
  */
 static int
@@ -2221,7 +2225,7 @@
 
 
 /**
- * Function called on entries in a GNUNET_FS_FileInformation publish-structure.
+ * Function called on entries in a `struct GNUNET_FS_FileInformation` for 
publishing.
  *
  * @param cls closure, unused
  * @param fi the entry in the publish-structure
@@ -2231,7 +2235,7 @@
  * @param bo block options (can be modified)
  * @param do_index should we index (can be modified)
  * @param client_info pointer to client context set upon creation (can be 
modified)
- * @return GNUNET_OK (to continue)
+ * @return #GNUNET_OK (to continue)
  */
 static int
 clear_keywords_in_file_information (void *cls,
@@ -2353,6 +2357,7 @@
   return FALSE;
 }
 
+
 /**
  * Called when expander changes its state (expanded/hidden).
  * Hides the widget, adjusts the paned position to compensate,
@@ -2586,12 +2591,12 @@
 
 /**
  * Called by a hashmap iterator.
- * Frees its argument with GNUNET_free ().
+ * Frees its argument with GNUNET_free_non_null().
  *
  * @param cls closure
  * @param key key from the map
  * @param value value from the map
- * @return GNUNET_YES, always.
+ * @return #GNUNET_YES, always.
  */
 static int
 free_seen_paths (void *cls, 
@@ -2608,7 +2613,7 @@
  * and if so, update the rest of the dialog accordingly.
  *
  * @param combo the namespace selection combo box
- * @param user_data the 'struct MainPublishingDialogContext'
+ * @param user_data the `struct MainPublishingDialogContext`
  */
 void
 GNUNET_GTK_master_publish_dialog_ego_combobox_changed_cb (GtkComboBox *combo,
@@ -2673,7 +2678,7 @@
  * Add all updateable entries of the current namespace to the
  * tree store.
  *
- * @param cls our 'struct MainPublishingDialogContext'
+ * @param cls our `struct MainPublishingDialogContext`
  * @param ego identity of the namespace to add
  * @param ego_ctx where to store context data 
  * @param name name of the namespace to add