Commit 99387c1a authored by Antenore Gatta's avatar Antenore Gatta Committed by Giovanni Panozzo

Doc and code cleaning

parent 9634da32
......@@ -1549,8 +1549,8 @@ align_with_tabs = true # false/true
# Whether to bump out to the next tab when aligning
align_on_tabstop = true # false/true
# Whether to left-align numbers
align_number_left = false # false/true
# Whether to right-align numbers
align_number_right = true # false/true
# Whether to keep whitespace not required for alignment.
align_keep_extra_space = false # false/true
......
......@@ -588,6 +588,16 @@ void remmina_file_unsave_password(RemminaFile *remminafile)
remmina_file_save(remminafile);
}
/**
* Return the string date of the last time a file has been modified.
*
* This is used to return the modification date of a file and it's used
* to return the modification date and time of a givwn remmina file.
* If it fails it will return "26/01/1976 23:30:00", that is just a date to don't
* return an empty string (challenge: what was happened that day at that time?).
* @return A date string in the form "%d/%m/%Y %H:%M:%S".
* @todo This should be moved to remmina_utils.c
*/
gchar*
remmina_file_get_datetime(RemminaFile *remminafile)
{
......@@ -631,8 +641,13 @@ remmina_file_get_datetime(RemminaFile *remminafile)
return modtime_string;
}
/* Function used to update the atime and mtime of a given remmina file, partially
* taken from suckless sbase */
/**
* Update the atime and mtime of a given filename.
* Function used to update the atime and mtime of a given remmina file, partially
* taken from suckless sbase
* @see https://git.suckless.org/sbase/tree/touch.c
* @todo This should be moved to remmina_utils.c
*/
void
remmina_file_touch(RemminaFile *remminafile)
{
......
......@@ -347,13 +347,16 @@ gboolean remmina_protocol_widget_close_connection(RemminaProtocolWidget* gp)
return retval;
}
/* Check if the plugin accepts keystrokes */
/** Check if the plugin accepts keystrokes.
*/
gboolean remmina_protocol_widget_plugin_receives_keystrokes(RemminaProtocolWidget* gp)
{
return gp->priv->plugin->send_keystrokes ? TRUE : FALSE;
}
/* Send to the plugin some keystrokes */
/**
* Send to the plugin some keystrokes.
*/
void remmina_protocol_widget_send_keystrokes(RemminaProtocolWidget* gp, GtkMenuItem *widget)
{
TRACE_CALL(__func__);
......
......@@ -32,7 +32,7 @@
*
*/
/*
/**
* General utility functions, non-GTK related.
*/
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment