summaryrefslogtreecommitdiff
path: root/src/Fl_Preferences.cxx
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2008-12-13 19:40:26 +0000
committerAlbrecht Schlosser <albrechts.fltk@online.de>2008-12-13 19:40:26 +0000
commit21b8d6aa1a6c1fbf98df5d11507a6629a528ae82 (patch)
tree76258c91b97cef0f5fca87539d7b2f0c4d519eca /src/Fl_Preferences.cxx
parent6ed54124bbff402944085568bb2fa2148a2eff62 (diff)
more doxygen updates
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6583 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'src/Fl_Preferences.cxx')
-rw-r--r--src/Fl_Preferences.cxx66
1 files changed, 32 insertions, 34 deletions
diff --git a/src/Fl_Preferences.cxx b/src/Fl_Preferences.cxx
index 43f3002ff..3ee22e53f 100644
--- a/src/Fl_Preferences.cxx
+++ b/src/Fl_Preferences.cxx
@@ -103,7 +103,7 @@ Fl_Preferences::Fl_Preferences( const char *path, const char *vendor, const char
/**
- \brief Gnerate or read a new group of entries within another group.
+ \brief Generate or read a new group of entries within another group.
Use the \a group argument to name the group that you would like to access.
\a Group can also contain a path to a group further down the hierarchy by
@@ -150,8 +150,7 @@ Fl_Preferences::~Fl_Preferences()
/**
- Returns the number of groups that are contained within a
- group.
+ Returns the number of groups that are contained within a group.
\return 0 for no groups at all
*/
@@ -162,9 +161,9 @@ int Fl_Preferences::groups()
/**
- Returns the name of the Nth group. There is no guaranteed
- order of group names. The index must be within the range given
- by groups().
+ Returns the name of the Nth (\a num_group) group.
+ There is no guaranteed order of group names. The index must
+ be within the range given by groups().
\param[in] num_group number indexing the requested group
\return 'C' string pointer to the group name
@@ -193,7 +192,7 @@ char Fl_Preferences::groupExists( const char *key )
/**
Deletes a group.
- Remove a group and all keys and groups within that group
+ Removes a group and all keys and groups within that group
from the database.
\param[in] group name of the group to delete
@@ -245,10 +244,9 @@ char Fl_Preferences::entryExists( const char *key )
/**
- Delete a single name/value pair.
+ Deletes a single name/value pair.
- This function removes the entry from the
- database.
+ This function removes the entry \a key from the database.
\param[in] key name of entry to delete
\return 0 if deleting the entry failed
@@ -697,8 +695,8 @@ char Fl_Preferences::getUserdataPath( char *path, int pathlen )
}
/**
- Write all preferences to disk. This function works only with
- the base preference group. This function is rarely used as
+ Writes all preferences to disk. This function works only with
+ the base preferences group. This function is rarely used as
deleting the base preferences flushes automatically.
*/
void Fl_Preferences::flush()
@@ -712,17 +710,17 @@ void Fl_Preferences::flush()
//
/**
- * Create a group name or entry name on the fly.
- *
- * This version creates a simple unsigned integer as an entry name.
- *
- * \code
- * int n, i;
- * Fl_Preferences prev( appPrefs, "PreviousFiles" );
- * prev.get( "n", 0 );
- * for ( i=0; i<n; i++ )
- * prev.get( Fl_Preferences::Name(i), prevFile[i], "" );
- * \endcode
+ Creates a group name or entry name on the fly.
+
+ This version creates a simple unsigned integer as an entry name.
+
+ \code
+ int n, i;
+ Fl_Preferences prev( appPrefs, "PreviousFiles" );
+ prev.get( "n", 0 );
+ for ( i=0; i<n; i++ )
+ prev.get( Fl_Preferences::Name(i), prevFile[i], "" );
+ \endcode
*/
Fl_Preferences::Name::Name( unsigned int n )
{
@@ -731,17 +729,17 @@ Fl_Preferences::Name::Name( unsigned int n )
}
/**
- * Create a group name or entry name on the fly.
- *
- * This version creates entry names as in 'printf'.
- *
- * \code
- * int n, i;
- * Fl_Preferences prefs( USER, "matthiasm.com", "test" );
- * prev.get( "nFiles", 0 );
- * for ( i=0; i<n; i++ )
- * prev.get( Fl_Preferences::Name( "File%d", i ), prevFile[i], "" );
- * \endcode
+ Creates a group name or entry name on the fly.
+
+ This version creates entry names as in 'printf'.
+
+ \code
+ int n, i;
+ Fl_Preferences prefs( USER, "matthiasm.com", "test" );
+ prev.get( "nFiles", 0 );
+ for ( i=0; i<n; i++ )
+ prev.get( Fl_Preferences::Name( "File%d", i ), prevFile[i], "" );
+ \endcode
*/
Fl_Preferences::Name::Name( const char *format, ... )
{