Fix some of the documentation

doc/rofi.doxy.in

@@ -2010,12 +2010,6 @@ EXTERNAL_GROUPS        = YES
 
 EXTERNAL_PAGES         = YES
 
-# The PERL_PATH should be the absolute path and name of the perl script
-# interpreter (i.e. the result of 'which perl').
-# The default file (with absolute path) is: /usr/bin/perl.
-
-PERL_PATH              = /usr/bin/perl
-
 #---------------------------------------------------------------------------
 # Configuration options related to the dot tool
 #---------------------------------------------------------------------------
@@ -2029,15 +2023,6 @@ PERL_PATH              = /usr/bin/perl
 
 CLASS_DIAGRAMS         = YES
 
-# You can define message sequence charts within doxygen comments using the \msc
-# command. Doxygen will then run the mscgen tool (see:
-# http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the
-# documentation. The MSCGEN_PATH tag allows you to specify the directory where
-# the mscgen tool resides. If left empty the tool is assumed to be found in the
-# default search path.
-
-MSCGEN_PATH            =
-
 # You can include diagrams made with dia in doxygen documentation. Doxygen will
 # then run dia to produce the diagram and insert it in the documentation. The
 # DIA_PATH tag allows you to specify the directory where the dia binary resides.

include/css-colors.h

@@ -29,5 +29,5 @@ extern const CSSColor CSSColors[];
  * Number of named colors.
  */
 extern const unsigned int num_CSSColors;
-/* @} */
+/** @} */
 #endif // ROFI_INCLUDE_CSS_COLORS_H

include/dialogs/combi.h

@@ -46,5 +46,5 @@
 /** #Mode object representing the combi dialog. */
 extern Mode combi_mode;
 
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_COMBI_H

include/dialogs/dmenu.h

@@ -47,5 +47,5 @@ int dmenu_switcher_dialog ( void );
  */
 void print_dmenu_options ( void );
 
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_DMENU_H

include/dialogs/drun.h

@@ -38,5 +38,5 @@
 /** #Mode object representing the desktop menu run dialog. */
 extern Mode drun_mode;
 #endif // ENABLE_DRUN
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_DRUN_H

include/dialogs/filebrowser.h

@@ -40,5 +40,5 @@ extern Mode file_browser_mode;
 
 Mode *create_new_file_browser (void);
 ModeMode file_browser_mode_completer ( Mode *sw, int mretv, char **input, unsigned int selected_line, char **path );
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_FILE_BROWSER_H

include/dialogs/help-keys.h

@@ -40,5 +40,5 @@
  * #Mode object representing the help key mode view
  */
 extern Mode help_keys_mode;
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_HELPKEYS_H

include/dialogs/run.h

@@ -42,5 +42,5 @@
 /** #Mode object representing the run dialog. */
 extern Mode run_mode;
 
-/*@}*/
+/**@}*/
 #endif // DIALOG_RUN_H

include/dialogs/script.h

@@ -52,5 +52,5 @@ Mode *script_switcher_parse_setup ( const char *str );
  * @returns true when valid.
  */
 gboolean script_switcher_is_valid ( const char *token );
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_SCRIPT_H

include/dialogs/ssh.h

@@ -46,5 +46,5 @@
 
 /** #Mode object representing the ssh dialog. */
 extern Mode ssh_mode;
-/*@}*/
+/**@}*/
 #endif // ROFI_DIALOG_SSH_H

include/dialogs/window.h

@@ -40,5 +40,5 @@
 extern Mode window_mode;
 extern Mode window_mode_cd;
 #endif // WINDOW_MODE
-/* @}*/
+/** @}*/
 #endif // ROFI_DIALOG_WINDOW_H

include/helper-theme.h

@@ -52,5 +52,5 @@ PangoAttrList *helper_token_match_get_pango_attr ( RofiHighlightColorStyle th, r
  * @returns true if font is valid.
  */
 gboolean helper_validate_font ( PangoFontDescription *pfd, const char *font );
-/* @} */
+/** @} */
 #endif // ROFI_HELPER_THEME_H

include/helper.h

@@ -228,7 +228,7 @@ char * rofi_latin_to_utf8_strdup ( const char *input, gssize length );
 /**
  * @param text the string to escape
  *
- * Escape XML markup from the string. @param text is freed.
+ * Escape XML markup from the string. text is freed.
  *
  * @return the escaped string
  */
@@ -301,7 +301,7 @@ gboolean helper_execute ( const char *wd, char **args, const char *error_precmd,
  * @param context The startup notification context, if any
  *
  * Execute command.
- * If needed members of @param context are NULL, they will be filled.
+ * If needed members of context are NULL, they will be filled.
  *
  * @returns FALSE On failure, TRUE on success
  */
@@ -330,10 +330,12 @@ cairo_surface_t *cairo_image_surface_create_from_svg ( const gchar* file, int he
 void parse_ranges ( char *input, rofi_range_pair **list, unsigned int *length );
 
 /**
- * @param format
- * @param string
- * @param selected_line
- * @param filter
+ * @param format The format string
+ * @param string The string
+ * @param selected_line selected line
+ * @param filter filter stringr
+ *
+ * Output formatted line
  */
 void rofi_output_formatted_line ( const char *format, const char *string, int selected_line, const char *filter );
 
@@ -352,4 +354,6 @@ void rofi_output_formatted_line ( const char *format, const char *string, int se
  */
 char *helper_string_replace_if_exists ( char * string, ... );
 G_END_DECLS
+
+/**@} */
 #endif // ROFI_HELPER_H

include/history.h

@@ -67,5 +67,5 @@ void history_remove ( const char *filename, const char *entry ) __attribute__( (
  */
 char ** history_get_list ( const char *filename, unsigned int * length ) __attribute__( ( nonnull ) );
 
-/*@}*/
+/**@}*/
 #endif // ROFI_HISTORY_H

include/keyb.h

@@ -184,5 +184,5 @@ gboolean parse_keys_abe ( NkBindings *bindings );
  */
 void setup_abe ( void );
 
-/*@}*/
+/**@}*/
 #endif // ROFI_KEYB_H

include/mode.h

@@ -237,6 +237,6 @@ char * mode_preprocess_input ( Mode *mode, const char *input );
  * @return a new allocated (valid pango markup) message to display (user should free).
  */
 char *mode_get_message ( const Mode *mode );
-/*@}*/
+/**@}*/
 G_END_DECLS
 #endif

include/rofi-icon-fetcher.h

@@ -45,5 +45,5 @@ uint32_t rofi_icon_fetcher_query ( const char *name, const int size );
  */
 cairo_surface_t * rofi_icon_fetcher_get ( const uint32_t uid );
 
-/* @} */
+/** @} */
 #endif // ROFI_ICON_FETCHER_H

include/rofi.h

@@ -108,5 +108,5 @@ Mode * rofi_collect_modi_search ( const char *name );
     " <i>https://github.com/davatorium/rofi/</i>"
 /** Indicates if ERROR_MSG uses pango markup */
 #define ERROR_MSG_MARKUP    TRUE
-/*@}*/
+/**@}*/
 #endif

include/timings.h

@@ -94,4 +94,4 @@ void rofi_timings_quit ( void );
 #define TICK_N( a )
 
 #endif // ROFI_TIMINGS_H
-/*@}*/
+/**@}*/

include/view.h

@@ -322,5 +322,5 @@ void rofi_view_set_window_title ( const char * title  );
  * set ellipsize mode to start.
  */
 void rofi_view_ellipsize_start ( RofiViewState *state );
-/**@}*/
+/** @}*/
 #endif

include/widgets/box.h

@@ -64,5 +64,5 @@ box * box_create ( widget *parent, const char *name, RofiOrientation type );
  * Add a widget to the box.
  */
 void box_add ( box *box, widget *child, gboolean expand );
-/*@}*/
+/**@}*/
 #endif // ROFI_HBOX_H

include/widgets/container.h

@@ -58,5 +58,5 @@ container * container_create ( widget *parent, const char *name );
  * Add a widget to the container.
  */
 void container_add ( container *container, widget *child );
-/*@}*/
+/**@}*/
 #endif // ROFI_CONTAINER_H

include/widgets/icon.h

@@ -63,5 +63,5 @@ void icon_set_size ( widget *icon, const int size );
  * @param surf The surface to display.
  */
 void icon_set_surface ( icon *icon, cairo_surface_t *surf );
-/*@}*/
+/**@}*/
 #endif // ROFI_ICON_H

include/widgets/listview.h

@@ -252,6 +252,6 @@ void listview_toggle_ellipsizing ( listview *lv );
  */
 
 void listview_set_ellipsize_start ( listview *lv );
-/* @} */
+/** @} */
 
 #endif // ROFI_LISTVIEW_H

include/widgets/scrollbar.h

@@ -91,5 +91,5 @@ void scrollbar_set_max_value ( scrollbar *sb, unsigned int max );
  */
 guint scrollbar_scroll_get_line ( const scrollbar *sb, int y );
 
-/*@}*/
+/**@}*/
 #endif // ROFI_SCROLLBAR_H

include/widgets/textbox.h

@@ -336,5 +336,5 @@ void textbox_cursor_end ( textbox *tb );
  * Set the ellipsizing mode used on the string.
  */
 void textbox_set_ellipsize ( textbox *tb, PangoEllipsizeMode mode );
-/*@}*/
+/**@}*/
 #endif //ROFI_TEXTBOX_H

include/widgets/widget.h

@@ -348,5 +348,5 @@ int widget_get_absolute_xpos ( widget *wid );
  */
 int widget_get_absolute_ypos ( widget *wid );
 
-/*@}*/
+/**@}*/
 #endif // ROFI_WIDGET_H

include/xrmoptions.h

@@ -173,5 +173,5 @@ gboolean config_parse_set_property ( const Property *p, char **error );
  * @brief Dump configuration in rasi format.
  */
 void config_parse_dump_config_rasi_format ( FILE *out, gboolean changes );
-/* @}*/
+/** @}*/
 #endif

source/dialogs/filebrowser.c

@@ -269,7 +269,7 @@ static char *_get_display_value ( const Mode *sw, unsigned int selected_line, G_
  *
  * Match the entry.
  *
- * @param returns try when a match.
+ * @returns try when a match.
  */
 static int file_browser_token_match ( const Mode *sw, rofi_int_matcher **tokens, unsigned int index )
 {

source/dialogs/run.c

@@ -424,4 +424,4 @@ Mode run_mode =
     .private_data       = NULL,
     .free               = NULL
 };
-/*@}*/
+/** @}*/

source/dialogs/ssh.c

@@ -658,4 +658,4 @@ Mode ssh_mode =
     .private_data       = NULL,
     .free               = NULL
 };
-/*@}*/
+/**@}*/

source/mode.c

@@ -179,4 +179,4 @@ char *mode_get_message ( const Mode *mode )
     }
     return NULL;
 }
-/*@}*/
+/**@}*/