Fix Doxygen 1.5.4 undocumented parameter warnings.

Improve dox for sciwrappers.c.
Correct sci_grap_focus() misspelling.
(Merged from split-window-plugin branch).


git-svn-id: https://geany.svn.sourceforge.net/svnroot/geany/trunk@2951 ea778897-0a13-0410-b9d1-a72fbfd435f5

ChangeLog

+2008-09-16  Nick Treleaven  <nick(dot)treleaven(at)btinternet(dot)com>
+
+ * src/keybindings.c, src/sciwrappers.c, src/sciwrappers.h,
+   src/filetypes.c:
+   Fix Doxygen 1.5.4 undocumented parameter warnings.
+   Improve dox for sciwrappers.c.
+   Correct sci_grap_focus() misspelling.
+   (Merged from split-window-plugin branch).
+
+
 2008-09-15  Nick Treleaven  <nick(dot)treleaven(at)btinternet(dot)com>
 
  * src/editor.c:

src/filetypes.c

@@ -1133,7 +1133,9 @@ gboolean filetype_has_tags(GeanyFiletype *ft)
 }
 
 
-/** Find a filetype pointer from its @c name field. */
+/** Find a filetype pointer from its @c name field.
+ * @param name Filetype name.
+ * @return The filetype found, or @c NULL. */
 GeanyFiletype *filetypes_lookup_by_name(const gchar *name)
 {
 	GeanyFiletype *ft;

src/keybindings.c

@@ -97,7 +97,15 @@ static void apply_kb_accel(GeanyKeyGroup *group, GeanyKeyBinding *kb, gpointer u
 /* This is used to set default keybindings on startup but at this point we don't want to
  * assign the keybinding to the menu_item (apply_kb_accel) otherwise it can't be overridden
  * by user keybindings anymore */
-/** Simple convenience function to fill a GeanyKeyBinding struct item. */
+/** Simple convenience function to fill a GeanyKeyBinding struct item.
+ * @param group
+ * @param key_id
+ * @param callback
+ * @param key
+ * @param mod
+ * @param name
+ * @param label
+ * @param menu_item */
 void keybindings_set_item(GeanyKeyGroup *group, gsize key_id,
 		GeanyKeyCallback callback, guint key, GdkModifierType mod,
 		gchar *name, gchar *label, GtkWidget *menu_item)

src/sciwrappers.h

@@ -141,7 +141,7 @@ void				sci_get_text_range			(ScintillaObject * sci, gint start, gint end, gchar
 void				sci_selection_duplicate		(ScintillaObject * sci);
 void				sci_line_duplicate			(ScintillaObject * sci);
 void				sci_insert_text				(ScintillaObject * sci, gint pos, const gchar *text);
-void				sci_grap_focus				(ScintillaObject * sci);
+void				sci_grab_focus				(ScintillaObject * sci);
 void				sci_set_cursor				(ScintillaObject * sci, gint cursor);
 void				sci_target_from_selection	(ScintillaObject * sci);
 void				sci_target_start			(ScintillaObject * sci, gint start);