Cumulated minor spelling fixes in comments

and other non-code texts
This commit is contained in:
Geert Janssens 2015-09-22 18:58:39 +02:00
parent 24773aa293
commit bd59bab28f
4 changed files with 21 additions and 21 deletions

View File

@ -825,7 +825,7 @@ xaccAccountCommitEdit checks the flag and finding it true:
Again checking that the book isn't shutting down: Again checking that the book isn't shutting down:
run destroy_pending_splits_for_account run destroy_pending_splits_for_account
destroy all of the lots in the lots list (again, destroy, not unref or even dispose) destroy all of the lots in the lots list (again, destroy, not unref or even dispose)
free the lot list (regardless of whether the book is shuttin down) and NULL the pointer free the lot list (regardless of whether the book is shutting down) and NULL the pointer
set the instance dirty set the instance dirty
unconditionally calls qof_commit_edit_part2 with acc_free unconditionally calls qof_commit_edit_part2 with acc_free
qof_commit_edit_part2: qof_commit_edit_part2:

View File

@ -172,7 +172,7 @@ static time64 parse_date_with_year (const char* date_str, int format)
date_segment[mem_length] = '\0'; date_segment[mem_length] = '\0';
/* Set the appropriate member of retvalue. Save the original /* Set the appropriate member of retvalue. Save the original
* values so that we can check if the change when we use gnc_mktime * values so that we can check if they change when we use gnc_mktime
* below. */ * below. */
switch (segment_type) switch (segment_type)
{ {
@ -284,7 +284,7 @@ static time64 parse_date_without_year (const char* date_str, int format)
date_segment[mem_length] = '\0'; date_segment[mem_length] = '\0';
/* Set the appropriate member of retvalue. Save the original /* Set the appropriate member of retvalue. Save the original
* values so that we can check if the change when we use gnc_mktime * values so that we can check if they change when we use gnc_mktime
* below. */ * below. */
switch (segment_type) switch (segment_type)
{ {

View File

@ -38,7 +38,7 @@
stores and use UNIVERSAL TIME internally. Universal time is the stores and use UNIVERSAL TIME internally. Universal time is the
'one true time' that is independent of one's location on planet 'one true time' that is independent of one's location on planet
Earth. It is measured in seconds from midnight January 1, 1970 Earth. It is measured in seconds from midnight January 1, 1970
in localtime-Grenwich (GMT). If one wants to display the local in localtime-Greenwich (GMT). If one wants to display the local
time, then the display-print routine should make all final time, then the display-print routine should make all final
tweaks to print the local time. The local time *must not* be tweaks to print the local time. The local time *must not* be
kept as a numeric value anywhere in the program. If one wants kept as a numeric value anywhere in the program. If one wants
@ -104,10 +104,10 @@ extern const char *gnc_default_strftime_date_format;
/** Constants *******************************************************/ /** Constants *******************************************************/
/** \brief UTC date format string. /** \brief UTC date format string.
Timezone independent, date and time inclusive, as used in the QSF backend. Time zone independent, date and time inclusive, as used in the QSF backend.
The T and Z characters are from xsd:dateTime format in coordinated universal time, UTC. The T and Z characters are from xsd:dateTime format in coordinated universal time, UTC.
You can reproduce the string from the GNU/Linux command line using the date utility: You can reproduce the string from the GNU/Linux command line using the date utility:
date -u +%Y-%m-%dT%H:M:SZ = 2004-12-12T23:39:11Z The datestring must be timezone independent date -u +%Y-%m-%dT%H:M:SZ = 2004-12-12T23:39:11Z The datestring must be time zone independent
and include all specified fields. Remember to use gmtime() NOT localtime()! and include all specified fields. Remember to use gmtime() NOT localtime()!
*/ */
@ -216,7 +216,7 @@ gchar* gnc_ctime (const time64 *secs);
*/ */
time64 gnc_time (time64 *tbuf); time64 gnc_time (time64 *tbuf);
/** \brief get the current utc time /** \brief get the current UTC time
* \param A time64* which, if not NULL, will be filled in with the same * \param A time64* which, if not NULL, will be filled in with the same
* value as is returned. * value as is returned.
* \return Seconds since 00:00:01 UTC 01 January 1970 (negative values * \return Seconds since 00:00:01 UTC 01 January 1970 (negative values
@ -235,7 +235,7 @@ time64 gnc_time_utc (time64 *tbuf);
gdouble gnc_difftime (const time64 secs1, const time64 secs2); gdouble gnc_difftime (const time64 secs1, const time64 secs2);
/** Wrapper for g_date_time_new_from_unix_local() that takes special care on /** Wrapper for g_date_time_new_from_unix_local() that takes special care on
* windows to take the local timezone into account. On unix, it just calles the * windows to take the local time zone into account. On unix, it just calls the
* g_date function. */ * g_date function. */
GDateTime* GDateTime*
gnc_g_date_time_new_from_unix_local (time64 time); gnc_g_date_time_new_from_unix_local (time64 time);
@ -311,12 +311,12 @@ gboolean timespec_equal(const Timespec *ta, const Timespec *tb);
/** comparison: if (ta < tb) -1; else if (ta > tb) 1; else 0; */ /** comparison: if (ta < tb) -1; else if (ta > tb) 1; else 0; */
gint timespec_cmp(const Timespec *ta, const Timespec *tb); gint timespec_cmp(const Timespec *ta, const Timespec *tb);
/** difference between ta and tb, results are normalised /** difference between ta and tb, results are normalized
* ie tv_sec and tv_nsec of the result have the same size * ie tv_sec and tv_nsec of the result have the same size
* abs(result.tv_nsec) <= 1000000000 */ * abs(result.tv_nsec) <= 1000000000 */
Timespec timespec_diff(const Timespec *ta, const Timespec *tb); Timespec timespec_diff(const Timespec *ta, const Timespec *tb);
/** absolute value, also normalised */ /** absolute value, also normalized */
Timespec timespec_abs(const Timespec *t); Timespec timespec_abs(const Timespec *t);
/** convert a timepair on a certain day (localtime) to /** convert a timepair on a certain day (localtime) to
@ -354,15 +354,15 @@ Timespec gnc_dmy2timespec_end (gint day, gint month, gint year);
/** The gnc_iso8601_to_timespec_gmt() routine converts an ISO-8601 style /** The gnc_iso8601_to_timespec_gmt() routine converts an ISO-8601 style
* date/time string to Timespec. Please note that ISO-8601 strings * date/time string to Timespec. Please note that ISO-8601 strings
* are a representation of Universal Time (UTC), and as such, they * are a representation of Universal Time (UTC), and as such, they
* 'store' UTC. To make them human readable, they show timezone * 'store' UTC. To make them human readable, they show time zone
* information along with a local-time string. But fundamentally, * information along with a local-time string. But fundamentally,
* they *are* UTC. Thus, thir routine takes a UTC input, and * they *are* UTC. Thus, this routine takes a UTC input, and
* returns a UTC output. * returns a UTC output.
* *
* For example: 1998-07-17 11:00:00.68-0500 * For example: 1998-07-17 11:00:00.68-0500
* is 680 milliseconds after 11 o'clock, central daylight time * is 680 milliseconds after 11 o'clock, central daylight time
* It is also 680 millisecs after 16:00:00 hours UTC. * It is also 680 milliseconds after 16:00:00 hours UTC.
* \return The universl time. * \return The universal time.
* *
* XXX Caution: this routine does not handle strings that specify * XXX Caution: this routine does not handle strings that specify
* times before January 1 1970. * times before January 1 1970.
@ -378,12 +378,12 @@ Timespec gnc_iso8601_to_timespec_gmt(const gchar *);
* *
* Please note that ISO-8601 strings are a representation of * Please note that ISO-8601 strings are a representation of
* Universal Time (UTC), and as such, they 'store' UTC. To make them * Universal Time (UTC), and as such, they 'store' UTC. To make them
* human readable, they show timezone information along with a * human readable, they show time zone information along with a
* local-time string. But fundamentally, they *are* UTC. Thus, * local-time string. But fundamentally, they *are* UTC. Thus,
* this routine takes a UTC input, and returns a UTC output. * this routine takes a UTC input, and returns a UTC output.
* *
* The string generated by this routine uses the local timezone * The string generated by this routine uses the local time zone
* on the machine on which it is executing to create the timestring. * on the machine on which it is executing to create the time string.
*/ */
gchar * gnc_timespec_to_iso8601_buff (Timespec ts, gchar * buff); gchar * gnc_timespec_to_iso8601_buff (Timespec ts, gchar * buff);
@ -403,8 +403,8 @@ void gnc_timespec2dmy (Timespec ts, gint *day, gint *month, gint *year);
* by mktime. This is a strange function! It requires that localtime * by mktime. This is a strange function! It requires that localtime
* or mktime be called before use. Subsequent calls to localtime or * or mktime be called before use. Subsequent calls to localtime or
* mktime *may* invalidate the result! The actual contents of tm *may* * mktime *may* invalidate the result! The actual contents of tm *may*
* be used for both timezone offset and daylight savings time, or only * be used for both time zone offset and daylight savings time, or only
* daylight savings time! Timezone stuff under unix is not * daylight savings time! time zone stuff under unix is not
* standardized and is a big mess. * standardized and is a big mess.
*/ */
glong gnc_timezone (const struct tm *tm); glong gnc_timezone (const struct tm *tm);
@ -414,7 +414,7 @@ glong gnc_timezone (const struct tm *tm);
/** \name QofDateFormat functions */ /** \name QofDateFormat functions */
// @{ // @{
/** The qof_date_format_get routine returns the date format that /** The qof_date_format_get routine returns the date format that
* the date printing will use when printing a date, and the scaning * the date printing will use when printing a date, and the scanning
* routines will assume when parsing a date. * routines will assume when parsing a date.
* @returns: the one of the enumerated date formats. * @returns: the one of the enumerated date formats.
*/ */

View File

@ -278,7 +278,7 @@ make_testfile "Author Name <author@email.addr>" path/to/input [path/to/output]
Creates template unit test files from C source files. The default Creates template unit test files from C source files. The default
output file is utest-filename in a subdirectory named "test". For output file is utest-filename in a subdirectory named "test". For
example, if the input file is src/engine/Account.c, the default output example, if the input file is src/engine/Account.c, the default output
file will be src/engine/test/test-Account.c. file will be src/engine/test/utest-Account.c.
The program scans the input file to find function signatures. Each The program scans the input file to find function signatures. Each
function signature will generate a comment with the function's function signature will generate a comment with the function's