Bump version

Make sure that the library is built before either of the isodate or setisodate
apps, otherwise we end up with problems compiling from scratch.

.gitignore

@@ -1,2 +1,3 @@
 obj
 html
+.*.swp

README

@@ -14,4 +14,10 @@ You might want to edit 'config' first. You might also want to set
 'INSTALL_PREFIX', which is prepended onto the destination of any
 installed file.
 
+Thanks
+------
+
+Robert Dunlop, <rjd@xyzzy.org.uk>
+ * found null terminating bug with iso8601_print()
+
 @TODO@

config

@@ -32,5 +32,7 @@
 source "scripts/paths"
 
 # Project-specific variables below.
+[ -z "${DEFAULT_LEAP_TABLE}" ] && DEFAULT_LEAP_TABLE="${SHAREDIR}/libiso8601/leap-table"
+
 [ -z "${CC}" ] && CC="gcc"
 [ -z "${CFLAGS}" ] && CFLAGS="-g -O2 -W -Wall"

make.sh

@@ -1,7 +1,7 @@
-#!/bin/sh
+#!/bin/bash
 # libiso8601/make.sh
 #
-#  (c)2006-2007, Laurence Withers, <l@lwithers.me.uk>.
+#  (c)2009, Laurence Withers, <l@lwithers.me.uk>.
 #  Released under the GNU GPLv3. See file COPYING or
 #  http://www.gnu.org/copyleft/gpl.html for details.
 #
@@ -15,19 +15,19 @@ then
     echo "Configuration file not found???"
     exit 1
 fi
-source "config" # don't fail on error, since last command in config might return false
+source "./config" # don't fail on error, since last command in config might return false
 
 
 
 # Get version information
-source version || exit 1
+source "./version" || exit 1
 VERSION="${VERMAJOR}.${VERMINOR}.${VERMICRO}"
 
 
 
 # Get standard functions
 [ -z "${VERBOSE}" ] && VERBOSE="0"
-source scripts/functions.sh || exit 1
+source "./scripts/functions.sh" || exit 1
 
 
 # List of directories which will be emptied by clean.
@@ -292,5 +292,4 @@ done
 
 exit 0
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: expandtab:ts=4:sw=4

run-test.sh

@@ -1,9 +1,9 @@
-#!/bin/sh
+#!/bin/bash
 # libiso8601/test.sh
 # 
-#  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv3. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
+#  Copyright: ©2009–2011, Güralp Systems Ltd.
+#  Author: Laurence Withers <lwithers@guralp.com>
+#  License: GPLv3
 #
 
 # Running this script on its own will display a summary of all the
@@ -21,7 +21,7 @@ run_test() {
         return 1
     fi
 
-    LD_LIBRARY_PATH="obj" ${EXE} "$@" || return 1
+    LD_LIBRARY_PATH="obj:${LD_LIBRARY_PATH}" "${EXE}" "$@" || return 1
     return 0
 }
 
@@ -33,14 +33,15 @@ print_tests() {
     echo "---------------------------------------------------------------------"
     for EXE in obj/tests/*
     do
-        [ -x ${EXE} ] || continue
-        NAME=$(echo ${EXE} | sed 's,obj/tests/,,')
+        [ -x "${EXE}" ] || continue
+        NAME="$(echo "${EXE}" | sed 's,obj/tests/,,')"
         echo -ne "${NAME}\t"
-        LD_LIBRARY_PATH="obj" ${EXE} --print-summary
+        LD_LIBRARY_PATH="obj:${LD_LIBRARY_PATH}" "${EXE}" --print-summary
     done
 }
 
 
+
 # Main script
 if [ $# -eq 0 ]
 then
@@ -48,7 +49,6 @@ then
     exit 0
 fi
 
-run_test $*
+run_test "$@"
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: expandtab:ts=4:sw=4

scripts/.gitignore

@@ -7,6 +7,7 @@ build.docs.none
 build.files.none
 build.firmware.gpasm
 build.firmware.sdcc
+build.header.c
 build.lib.c
 build.lib.c++
 build.make.none

scripts/functions.sh

@@ -1,8 +1,8 @@
 # libiso8601/scripts/functions.sh
 #
-#  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv3. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
+#  Copyright: ©2007–2011, Güralp Systems Ltd.
+#  Author: Laurence Withers, <lwithers@guralp.com>
+#  License: GPLv3
 #
 
 # Common functions
@@ -63,5 +63,4 @@ do_cmd_redir() {
     fi
 }
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: expandtab:ts=4:sw=4

scripts/paths

@@ -1,85 +1,63 @@
 # libiso8601/scripts/paths
 #
-#  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv3. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
+#  Copyright: ©2011, Güralp Systems Ltd.
+#  Author: Laurence Withers, <lwithers@guralp.com>
+#  License: GPLv3
 #
 #  Default path setup. Not meant for editing; use environment variables 
 #  to override values if needed.
 #
 
-# build proposed paths
-case "${PREFIX}" in
-/)
-    MY_BINDIR="/bin"
-    MY_SBINDIR="/sbin"
-    MY_LIBDIR="/lib"
-    MY_INCLUDEDIR="/usr/include"
-    MY_CONFIGDIR="/etc"
-    MY_VARDIR="/var"
-    MY_SHAREDIR="/usr/share/libiso8601"
-    MY_DOCSDIR="/usr/share/doc/libiso8601"
-    MY_WEBDIR="/srv/http"
-    ;;
+MY_PREFIX="${PREFIX}"
+[ "${MY_PREFIX}" == "/" ] && MY_PREFIX=""
 
-/usr)
-    MY_BINDIR="/usr/bin"
-    MY_SBINDIR="/usr/sbin"
-    MY_LIBDIR="/usr/lib"
-    MY_INCLUDEDIR="/usr/include"
-    MY_CONFIGDIR="/etc"
-    MY_VARDIR="/var"
-    MY_SHAREDIR="/usr/share/libiso8601"
-    MY_DOCSDIR="/usr/share/doc/libiso8601"
-    MY_WEBDIR="/srv/http"
-    ;;
+[ -z "${BINDIR}" ] && BINDIR="${PREFIX}/bin"
+[ -z "${SBINDIR}" ] && SBINDIR="${PREFIX}/sbin"
+[ -z "${LIBDIR}" ] && LIBDIR="${PREFIX}/lib"
 
-/usr/local)
-    MY_BINDIR="/usr/local/bin"
-    MY_SBINDIR="/usr/local/sbin"
-    MY_LIBDIR="/usr/local/lib"
-    MY_INCLUDEDIR="/usr/local/include"
-    MY_CONFIGDIR="/usr/local/etc"
-    MY_VARDIR="/var"
-    MY_SHAREDIR="/usr/local/share/libiso8601"
-    MY_DOCSDIR="/usr/local/share/doc/libiso8601"
-    MY_WEBDIR="/srv/http"
-    ;;
+if [ -z "${INCLUDEDIR}" ]
+then
+    case "${PREFIX}" in
+    /) INCLUDEDIR="/usr/include" ;;
+    *) INCLUDEDIR="${PREFIX}/include" ;;
+    esac
+fi
 
-/opt/*)
-    MY_BINDIR="${PREFIX}/bin"
-    MY_SBINDIR="${PREFIX}/sbin"
-    MY_LIBDIR="${PREFIX}/lib"
-    MY_INCLUDEDIR="${PREFIX}/include"
-    MY_CONFIGDIR="/etc${PREFIX}"
-    MY_VARDIR="/var${PREFIX}"
-    MY_SHAREDIR="/var${PREFIX}"
-    MY_DOCSDIR="${PREFIX}/doc"
-    MY_WEBDIR="${PREFIX}/http"
-    ;;
+if [ -z "${CONFIGDIR}" ]
+then
+    case "${PREFIX}" in
+    / | /usr) CONFIGDIR="/etc" ;;
+    /opt*) CONFIGDIR="/etc${PREFIX}" ;;
+    *) CONFIGDIR="${PREFIX}/etc" ;;
+    esac
+fi
 
-**)
-    MY_BINDIR="${PREFIX}/bin"
-    MY_SBINDIR="${PREFIX}/sbin"
-    MY_LIBDIR="${PREFIX}/lib"
-    MY_INCLUDEDIR="${PREFIX}/include"
-    MY_CONFIGDIR="${PREFIX}/etc"
-    MY_VARDIR="${PREFIX}/var"
-    MY_DOCSDIR="${PREFIX}/share/doc"
-    MY_WEBDIR="${PREFIX}/srv/http"
-    ;;
-esac
+if [ -z "${VARDIR}" ]
+then
+    case "${PREFIX}" in
+    / | /usr | /usr/local) VARDIR="/var" ;;
+    /opt*) VARDIR="/var${PREFIX}" ;;
+    *) VARDIR="${PREFIX}/var" ;;
+    esac
+fi
 
-# assign paths allowing user to override
-[ -z "${BINDIR}" ] && BINDIR="${MY_BINDIR}"
-[ -z "${SBINDIR}" ] && SBINDIR="${MY_SBINDIR}"
-[ -z "${LIBDIR}" ] && LIBDIR="${MY_LIBDIR}"
-[ -z "${INCLUDEDIR}" ] && INCLUDEDIR="${MY_INCLUDEDIR}"
-[ -z "${CONFIGDIR}" ] && CONFIGDIR="${MY_CONFIGDIR}"
-[ -z "${VARDIR}" ] && VARDIR="${MY_VARDIR}"
-[ -z "${DOCSDIR}" ] && DOCSDIR="${MY_DOCSDIR}"
-[ -z "${WEBDIR}" ] && WEBDIR="${MY_WEBDIR}"
+if [ -z "${SHAREDIR}" ]
+then
+    case "${PREFIX}" in
+    /) SHAREDIR="/usr/share" ;;
+    *) SHAREDIR="${PREFIX}/share" ;;
+    esac
+fi
+[ -z "${DOCSDIR}" ] && DOCSDIR="${SHAREDIR}/doc"
+
+if [ -z "${SRVDIR}" ]
+then
+    case "${PREFIX}" in
+    / | /usr | /usr/local) SRVDIR="/srv" ;;
+    *) SRVDIR="${PREFIX}/srv" ;;
+    esac
+fi
+[ -z "${WEBDIR}" ] && WEBDIR="${SRVDIR}/http"
 [ -z "${CGIDIR}" ] && CGIDIR="${WEBDIR}/cgi-bin"
  
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/docs/MainPage.dox

@@ -1,11 +1,16 @@
 /* libiso8601/src/docs/MainPage.dox
  *
- *  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
+ *  (c)2007-2010, Laurence Withers, <l@lwithers.me.uk>.
  *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
-/*! \mainpage
+/*! \mainpage Library for manipulating ISO8601-format dates and times
+
+\c libiso8601 is a library containing conversion routines for ISO8601-format
+dates and times and a set of associated date/time manipulation routines. It has
+support for leap seconds and nanosecond accuracy and is intended for use in
+e.g. physical science applications.
 
 */
 

src/docs/build.docs

@@ -39,5 +39,4 @@ then
     docs_BUILT=1
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/docs/build.install-docs

@@ -17,5 +17,4 @@ do
 done
 
 print_success "Documentation installed"
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/isodate/build.app

@@ -8,7 +8,8 @@ build_target libiso8601
 if [ -z ${isodate_BUILT} ]
 then
     isodate="obj/isodate"
-    EXTRAS="${libiso8601} ${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS}"
+    EXTRAS="-std=gnu99 -D_GNU_SOURCE -DAPP_NAME=\"isodate\" \
+        ${libiso8601} ${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS}"
 
     echo "Building application ${isodate}..."
 
@@ -39,5 +40,4 @@ then
 
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/isodate/build.install-app

@@ -8,5 +8,4 @@ echo "Installing binaries into '${BINDIR}'"
 install_file "${isodate}" "${BINDIR}" 0755 || return 1
 print_success "Done"
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/isodate/build.monolithic

@@ -14,5 +14,4 @@ then
     MONOLITHIC_DOC="${MONOLITHIC_DOC} ${SRC}"
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/libiso8601/000_TopHeader.h

@@ -1,13 +1,17 @@
 /* libiso8601/src/libiso8601/000_TopHeader.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 #ifndef HEADER_libiso8601
 #define HEADER_libiso8601
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 /* standard includes, or includes needed for type declarations */
 #include <time.h>
 #include <stdint.h>

src/libiso8601/000_TopSource.c

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/000_TopSource.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -10,9 +10,12 @@
 /* Below are all the includes used throughout the library. */
 #include <ctype.h>
 #include <errno.h>
+#include <fcntl.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <unistd.h>
+#include <sys/stat.h>
 #include <sys/time.h>
 
 /* Useful define to alleviate typos */

src/libiso8601/100_calc.c

@@ -1,25 +1,28 @@
 /* libiso8601/src/libiso8601/100_calc.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 
 
-/* CALCULATION ROUTINES
- *
- *  This file contains calculation routines used internally in the library. Our date format is the
- *  number of days elapsed since 0000-001 (so that date would be 0, -0001-365 would be -1, etc.).
- *  Time is represented as the number of seconds elapsed since midnight at the start of the day. It
- *  is a value between 0 and 86399 (or 86400 for leap seconds).
- */
+/* CALCULATION ROUTINES ********************************************************
+
+ This file contains calculation routines used internally in the library. Our
+date format is the number of days elapsed since 0000-001 (so that date would be
+0, -0001-365 would be -1, etc.).  Time is represented as the number of seconds
+elapsed since midnight at the start of the day. It is a value between 0 and
+86399 (or 86400 for leap seconds).
+
+*******************************************************************************/
 
 #define DAYS_IN_400_YEARS (146097)
 
 
 
-int iso8601_isleap(int year)
+int
+iso8601_isleap(int year)
 {
         if(year % 4) return 0;
         if(year % 100) return 1;
@@ -31,14 +34,15 @@ int iso8601_isleap(int year)
 
 /* struct monthcount, _days_in_month_common[], _days_in_month_leap[]
  *
- *  Tables of the number of days in each month, and the number of days elapsed since the start of
- *  the year for each month.
+ *  Tables of the number of days in each month, and the number of days elapsed
+ *  since the start of the year for each month.
  */
 struct monthcount {
     int elapsed, days;
 };
 
-static const struct monthcount _days_in_month_common[] = {
+static const struct monthcount
+_days_in_month_common[] = {
     { 0, 31 },
     { 31, 28 },
     { 59, 31 },
@@ -53,7 +57,8 @@ static const struct monthcount _days_in_month_common[] = {
     { 334, 31 }
 };
 
-static const struct monthcount _days_in_month_leap[] = {
+static const struct monthcount
+_days_in_month_leap[] = {
     { 0, 31 },
     { 31, 29 },
     { 60, 31 },
@@ -70,7 +75,8 @@ static const struct monthcount _days_in_month_leap[] = {
 
 
 
-static int _days_in_month(int year, int month)
+static int
+_days_in_month(int year, int month)
 {
     const struct monthcount* mc;
 
@@ -85,42 +91,45 @@ static int _days_in_month(int year, int month)
 
 
 
-static void _to_year(int* year, int* days_left, const struct iso8601_date* date)
+static void
+_to_year(int* year, int* days_left, const struct iso8601_date* date)
 {
     div_t qr;
     int ndays = date->day;
 
-    // Each 400 years have 97 leap days, giving 365*400+97 = DAYS_IN_400_YEARS days in 400 years
+    /* Each 400 years have 97 leap days, giving 365*400+97 = DAYS_IN_400_YEARS
+       days in 400 years */
     qr = div(ndays, DAYS_IN_400_YEARS);
     *year = qr.quot * 400;
     ndays = qr.rem;
 
-    // ensure that we always end up with between 0 and 146096 days remaining
+    /* ensure that we always end up with between 0 and 146096 days remaining */
     if(ndays < 0) {
         ndays += DAYS_IN_400_YEARS;
         *year -= 400;
     }
 
-    // we insert `fake' leap days for years 101, 201, 301
+    /* we insert `fake' leap days for years 101, 201, 301 */
     if(ndays >= 36890) ++ndays;
     if(ndays >= 73415) ++ndays;
     if(ndays >= 109940) ++ndays;
 
-    // each remaining 100 year block has 24 leap days, giving 365*100+24 = 36524 days
+    /* each remaining 100 year block has 24 leap days, giving 365*100+24 = 36524
+       days */
     qr = div(ndays, 36525);
     *year += qr.quot * 100;
     ndays = qr.rem;
 
-    // each 4-year block has 1 leap day, giving 365*4 + 1 = 1461 days
+    /* each 4-year block has 1 leap day, giving 365*4 + 1 = 1461 days */
     qr = div(ndays, 1461);
     *year += qr.quot * 4;
     ndays = qr.rem;
 
-    // the first year of a 4-year block has 1 leap day, 366 days
+    /* the first year of a 4-year block has 1 leap day, 366 days */
     if(ndays >= 366) {
-        --ndays; // pretend to have dealt with leap day
+        --ndays; /* pretend to have dealt with leap day */
 
-        // 365 days per remaining year
+        /* 365 days per remaining year */
         qr = div(ndays, 365);
         *year += qr.quot;
         ndays = qr.rem;
@@ -131,15 +140,16 @@ static void _to_year(int* year, int* days_left, const struct iso8601_date* date)
 
 
 
-void iso8601_to_cal(int* year, int* month, int* day, const struct iso8601_date* date)
+void
+iso8601_to_cal(int* year, int* month, int* day, const struct iso8601_date* date)
 {
     const struct monthcount* mc;
     int ndays;
 
-    // perform year calulation
+    /* perform year calulation */
     _to_year(year, &ndays, date);
 
-    // now we simply have number of days elapsed since day 001 in `year'.
+    /* now we simply have number of days elapsed since day 001 in `year'. */
     mc = iso8601_isleap(*year) ? _days_in_month_leap : _days_in_month_common;
     *month = 1;
     while(ndays >= mc->days) {
@@ -152,35 +162,38 @@ void iso8601_to_cal(int* year, int* month, int* day, const struct iso8601_date*
 
 
 
-void iso8601_to_ord(int* year, int* oday, const struct iso8601_date* date)
+void
+iso8601_to_ord(int* year, int* oday, const struct iso8601_date* date)
 {
     int ndays;
 
-    // perform year calcutation
+    /* perform year calcutation */
     _to_year(year, &ndays, date);
 
-    // now we simply have number of days elapsed since day 001 in `year'.
+    /* now we simply have number of days elapsed since day 001 in `year'. */
     *oday = ndays + 1;
 }
 
 
 
-static int _weekday_of_year(int year)
+static int
+_weekday_of_year(int year)
 {
     int w = 6;
 
     /* Algorithm notes:
-     *  - 0 = sun, 1 = mon, ..., 6 = sat
-     *  - 0000-001 is a Saturday, day 6
-     *  - every year we pass gives us one additional day (364 is divisible by 7)
-     *  - but of course every leap year we pass gives us a further day
-     *  - so for every 400 years, we add 497 (400 common years, 97 leap years); 497 % 7 = 0
+     *  • 0 = sun, 1 = mon, ..., 6 = sat
+     *  • 0000-001 is a Saturday, day 6
+     *  • every year we pass gives us one additional day (364 is divisible by 7)
+     *  • but of course every leap year we pass gives us a further day
+     *  • so for every 400 years, we add 497 (400 common years, 97 leap years);
+     *    497 % 7 = 0
      */
     year %= 400;
-    if(year < 0) year += 400; // end up with between 0-399 years left
-    w += year; // excluding leap years, we increase by 1 day a year
-    w += (year + 3) / 4; // there is one leap year for every four years
-    w -= (year - 1) / 100; // but one less for every century over 0
+    if(year < 0) year += 400; /* end up with between 0-399 years left */
+    w += year; /* excluding leap years, we increase by 1 day a year */
+    w += (year + 3) / 4; /* there is one leap year for every four years */
+    w -= (year - 1) / 100; /* but one less for every century over 0 */
     w %= 7;
 
     return w;
@@ -188,42 +201,47 @@ static int _weekday_of_year(int year)
 
 
 
-void iso8601_to_week(int* year, int* week, int* wday, const struct iso8601_date* date)
+void
+iso8601_to_week(int* year, int* week, int* wday,
+    const struct iso8601_date* date)
 {
     int ndays, w, has53 = 0;
     div_t d;
 
-    // perform year and weekday calculation
+    /* perform year and weekday calculation */
     _to_year(year, &ndays, date);
     w = _weekday_of_year(*year);
 
-    // find out what day jan 1 was; from there, we can find the ISO week and year number
+    /* find out what day jan 1 was; from there, we can find the ISO week and
+       year number */
     switch(w) {
-    case 4: // W01 starts XXXY-12-28
+    case 4: /* W01 starts XXXY-12-28 */
         w += 7;
-        has53 = 1; // years starting Thursday have 53 weeks
+        has53 = 1; /* years starting Thursday have 53 weeks */
         break;
 
-    case 5: // W01 starts XXXZ-01-03
-    case 6: // W01 starts XXXZ-01-02
+    case 5: /* W01 starts XXXZ-01-03 */
+    case 6: /* W01 starts XXXZ-01-02 */
         break;
 
-    case 0: // W01 starts XXXZ-01-01
-    case 1: // W01 starts XXXY-12-31
-    case 2: // W01 starts XXXY-12-30
-        w += 7; // for week calculation
+    case 0: /* W01 starts XXXZ-01-01 */
+    case 1: /* W01 starts XXXY-12-31 */
+    case 2: /* W01 starts XXXY-12-30 */
+        w += 7; /* for week calculation */
         break;
 
-    case 3: // W01 starts XXXY-12-29
+    case 3: /* W01 starts XXXY-12-29 */
         w += 7;
-        if(iso8601_isleap(*year)) has53 = 1; // leap years starting Wednesday have 53 weeks
+        if(iso8601_isleap(*year)) has53 = 1; /* leap years starting Wednesday
+                                                have 53 weeks */
     }
 
-    // now we simply add the number of days elapsed since the start of the year, and % 7
+    /* now we simply add the number of days elapsed since the start of the
+       year, and % 7 */
     w += ndays;
-    d = div(w, 7); // w can never be 0
+    d = div(w, 7); /* w can never be 0 */
 
-    // do Sunday correction
+    /* do Sunday correction */
     if(!d.rem) {
         d.rem = 7;
         --d.quot;
@@ -256,54 +274,57 @@ void iso8601_to_week(int* year, int* week, int* wday, const struct iso8601_date*
 
 
 
-int _from_year(struct iso8601_date* date, int year)
+static int
+_from_year(struct iso8601_date* date, int year)
 {
     div_t qr;
 
-    // check for range errors
+    /* check for range errors */
     if(year < -5879609 || year > 5879609) {
         errno = ERANGE;
         return -1;
     }
 
-    // Each 400 years have 97 leap days, giving 365*400+97 = DAYS_IN_400_YEARS days in 400 years
+    /* Each 400 years have 97 leap days, giving 365*400+97 = DAYS_IN_400_YEARS
+       days in 400 years */
     qr = div(year, 400);
     date->day = qr.quot * DAYS_IN_400_YEARS;
     year = qr.rem;
 
-    // ensure we have between 0 and 399 years
+    /* ensure we have between 0 and 399 years */
     if(year < 0) {
         date->day -= DAYS_IN_400_YEARS;
         year += 400;
     }
 
-    // excluding leap days, there are 365 days per year
+    /* excluding leap days, there are 365 days per year */
     date->day += 365 * year;
-    date->day += (year + 3) / 4; // there is one leap year for every four years
-    date->day -= (year - 1) / 100; // but one less for every century over 0
+    date->day += (year + 3) / 4; /* one leap year for every four years */
+    date->day -= (year - 1) / 100; /* but one less for every century over 0 */
     return 0;
 }
 
 
 
-int iso8601_from_cal(struct iso8601_date* date, int year, int month, int day)
+int
+iso8601_from_cal(struct iso8601_date* date, int year, int month, int day)
 {
     const struct monthcount* mc;
 
-    // check for domain errors
+    /* check for domain errors */
     mc = iso8601_isleap(year) ? _days_in_month_leap : _days_in_month_common;
     if(month < 1 || month > 12 || day < 1 || day > mc[month - 1].days) {
         errno = EDOM;
         return -1;
     }
 
-    // perform year calculation
+    /* perform year calculation */
     if(_from_year(date, year)) return -1;
 
-    // now get number of days elapsed up to start of month
+    /* now get number of days elapsed up to start of month */
     date->day += mc[month - 1].elapsed;
 
-    // and add number of days elapsed sinced start of month
+    /* and add number of days elapsed sinced start of month */
     date->day += day - 1;
 
     return 0;
@@ -311,18 +332,19 @@ int iso8601_from_cal(struct iso8601_date* date, int year, int month, int day)
 
 
 
-int iso8601_from_ord(struct iso8601_date* date, int year, int oday)
+int
+iso8601_from_ord(struct iso8601_date* date, int year, int oday)
 {
-    // check for domain errors
+    /* check for domain errors */
     if(oday < 1 || oday > (iso8601_isleap(year) ? 366 : 365)) {
         errno = EDOM;
         return -1;
     }
 
-    // perform year calculation
+    /* perform year calculation */
     if(_from_year(date, year)) return -1;
 
-    // now simply add number of days elapsed this year
+    /* now simply add number of days elapsed this year */
     date->day += oday - 1;
 
     return 0;
@@ -330,18 +352,19 @@ int iso8601_from_ord(struct iso8601_date* date, int year, int oday)
 
 
 
-int iso8601_from_week(struct iso8601_date* date, int isoyear, int week, int wday)
+int
+iso8601_from_week(struct iso8601_date* date, int isoyear, int week, int wday)
 {
     int day1off, maxwk;
 
-    // compute year part
+    /* compute year part */
     _from_year(date, isoyear);
 
-    // 400-year cycle; ensure we're between 0-400 years
+    /* 400-year cycle; ensure we're between 0-400 years */
     isoyear %= 400;
     if(isoyear < 0) isoyear += 400;
 
-    // domain check
+    /* domain check */
     maxwk = (((isoyear % 7) == 52) || ((isoyear % 28) == 24)) ? 53 : 52;
     if(wday < 1 || wday > 7 || week < 1 || week > maxwk) {
         errno = EDOM;
@@ -349,18 +372,20 @@ int iso8601_from_week(struct iso8601_date* date, int isoyear, int week, int wday
     }
 
     /* Algorithm notes:
-     *  We now compute the offset between the start day of the ISO year and the start day of the 
-     *  real year. Year 0000 starts on a Saturday, meaning the ISO year 0000 starts on 0000-003
-     *  (offset of +2 days). Each year reduces the offset by one day, and each leap year reduces it
-     *  by a further day; the offset wraps from -3 to +3.
+     *  We now compute the offset between the start day of the ISO year and
+     *  the start day of the real year. Year 0000 starts on a Saturday, meaning
+     *  the ISO year 0000 starts on 0000-003 (offset of +2 days). Each year
+     *  reduces the offset by one day, and each leap year reduces it by a
+     *  further day; the offset wraps from -3 to +3.
      */
-    day1off = 2 - isoyear; // reduce offset by 1 for each year
-    day1off += (isoyear - 1) / 100; // cancel out 1 leap year for each century past the first
-    day1off -= (isoyear + 3) / 4; // 1 leap year every 4 years
+    day1off = 2 - isoyear; /* reduce offset by 1 for each year */
+    day1off += (isoyear - 1) / 100; /* cancel out 1 leap year for each century
+                                       past the first */
+    day1off -= (isoyear + 3) / 4; /* 1 leap year every 4 years */
     day1off %= 7;
     if(day1off < -3) day1off += 7;
 
-    // now simply add in the day offset and days/weeks elapsed
+    /* now simply add in the day offset and days/weeks elapsed */
     date->day += day1off + (week - 1) * 7 + wday - 1;
 
     return 0;
@@ -368,11 +393,13 @@ int iso8601_from_week(struct iso8601_date* date, int isoyear, int week, int wday
 
 
 
-void iso8601_to_clocktime(int* hour, int* min, int* sec, const struct iso8601_date* date)
+void
+iso8601_to_clocktime(int* hour, int* min, int* sec,
+    const struct iso8601_date* date)
 {
     div_t qr;
 
-    // special case: leap second
+    /* special case: leap second */
     if(date->sec == 86400) {
         *hour = 23;
         *min = 59;
@@ -380,7 +407,7 @@ void iso8601_to_clocktime(int* hour, int* min, int* sec, const struct iso8601_da
         return;
     }
 
-    // normal case
+    /* normal case */
     qr = div(date->sec, 3600);
     *hour = qr.quot;
     qr = div(qr.rem, 60);
@@ -390,21 +417,22 @@ void iso8601_to_clocktime(int* hour, int* min, int* sec, const struct iso8601_da
 
 
 
-int iso8601_from_clocktime(struct iso8601_date* date, int hour, int min, int sec)
+int
+iso8601_from_clocktime(struct iso8601_date* date, int hour, int min, int sec)
 {
-    // special case: leap second
+    /* special case: leap second */
     if(hour == 23 && min == 59 && sec == 60) {
         date->sec = 86400;
         return 0;
     }
 
-    // domain check
+    /* domain check */
     if(hour < 0 || hour > 23 || min < 0 || min > 59 || sec < 0 || sec > 59) {
         errno = EDOM;
         return -1;
     }
     
-    // normal calculation
+    /* normal calculation */
     date->sec = hour * 3600 + min * 60 + sec;
     return 0;
 }

src/libiso8601/100_leap.c

@@ -1,59 +1,92 @@
 /* libiso8601/src/libiso8601/100_leap.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 
 
-static int leap_second_days[] = {
-    720439, // 19720630
-    720623, // 19721231
-    720988, // 19731231
-    721353, // 19741231
-    721718, // 19751231
-    722084, // 19761231
-    722449, // 19771231
-    722814, // 19781231
-    723179, // 19791231
-    723726, // 19810630
-    724091, // 19820630
-    724456, // 19830630
-    725187, // 19850630
-    726101, // 19871231
-    726832, // 19891231
-    727197, // 19901231
-    727744, // 19920630
-    728109, // 19930630
-    728474, // 19940630
-    729023, // 19951231
-    729570, // 19970630
-    730119, // 19981231
-    732676  // 20051231
+/* leap_second_days_table[]
+ *  This is a sorted array of days (in libiso8601 format) on which a positive
+ *  leap second occurred. This table is built in to the library, but may be
+ *  overridden at runtime by changing what ‘leap_second_days’ points to. There
+ *  should be no other references to this table, therefore.
+ */
+static int
+leap_second_days_table[] = {
+    720439, /* 1972-06-30 */
+    720623, /* 1972-12-31 */
+    720988, /* 1973-12-31 */
+    721353, /* 1974-12-31 */
+    721718, /* 1975-12-31 */
+    722084, /* 1976-12-31 */
+    722449, /* 1977-12-31 */
+    722814, /* 1978-12-31 */
+    723179, /* 1979-12-31 */
+    723726, /* 1981-06-30 */
+    724091, /* 1982-06-30 */
+    724456, /* 1983-06-30 */
+    725187, /* 1985-06-30 */
+    726101, /* 1987-12-31 */
+    726832, /* 1989-12-31 */
+    727197, /* 1990-12-31 */
+    727744, /* 1992-06-30 */
+    728109, /* 1993-06-30 */
+    728474, /* 1994-06-30 */
+    729023, /* 1995-12-31 */
+    729570, /* 1997-06-30 */
+    730119, /* 1998-12-31 */
+    732676, /* 2005-12-31 */
+    733772, /* 2008-12-31 */
+    735049, /* 2012-06-30 */
+    736144, /* 2015-06-30 */
 };
 
 
 
-int iso8601_seconds_leap(const struct iso8601_date* date)
-{
-    int num_ly = 0, i = 0;
+/* leap_second_days[], leap_second_days_num
+ *  Pointer to an array (and number of elements in the array) representing the
+ *  table of positive leap seconds. The array is sorted and contains libiso8601
+ *  day numbers of days with positive leap seconds.
+ */
+static int*
+leap_second_days = leap_second_days_table;
+static int
+leap_second_days_num = sizeof(leap_second_days_table) / sizeof(int);
 
-    num_ly = sizeof(leap_second_days) / sizeof(int);
-    for(i = 0; i < num_ly; ++i) if(leap_second_days[i] == date->day) return 86401;
+
+
+/* iso8601_seconds_leap()
+ *  Returns the number of seconds that elapse on a given date, which requires us
+ *  to search the table of leap seconds to see if we need to return a special
+ *  case.
+ */
+int
+iso8601_seconds_leap(const struct iso8601_date* date)
+{
+    int i;
+    for(i = 0; i < leap_second_days_num; ++i) {
+        if(leap_second_days[i] == date->day) return 86401;
+    }
     return 86400;
 }
 
 
 
-static int _leap_elapsed_day(int sday, int eday)
+/* _leap_elapsed_day()
+ *  Returns the number of leap seconds that have elapsed between ‘sday’ (start
+ *  day) and ‘eday’ (end day), both in libiso8601 format.
+ */
+static int
+_leap_elapsed_day(int sday, int eday)
 {
     int spos, epos;
 
-    for(spos = 0; (unsigned)spos < sizeof(leap_second_days) / sizeof(int); ++spos) {
+    for(spos = 0; spos < leap_second_days_num; ++spos) {
         if(sday <= leap_second_days[spos]) break;
     }
-    for(epos = 0; (unsigned)epos < sizeof(leap_second_days) / sizeof(int); ++epos) {
+    for(epos = 0; epos < leap_second_days_num; ++epos) {
         if(eday <= leap_second_days[epos]) break;
     }
 
@@ -62,13 +95,121 @@ static int _leap_elapsed_day(int sday, int eday)
 
 
 
-int iso8601_leap_elapsed(const struct iso8601_date* start, const struct iso8601_date* end)
+/* iso8601_leap_elapsed()
+ *  Wrapper around _leap_elapsed_day().
+ */
+int
+iso8601_leap_elapsed(const struct iso8601_date* start,
+    const struct iso8601_date* end)
 {
     return _leap_elapsed_day(start->day, end->day);
 }
 
 
 
+/* leap_table_free_old
+ *  If set, then when we update the leap table, we should free the old array.
+ *  Initially clear so that we don't free our static built-in table.
+ */
+static int leap_table_free_old = 0;
+
+
+
+/* iso8601_leap_table_set()
+ *  Switch to using a new table of leap seconds, possibly freeing the old one.
+ */
+void
+iso8601_leap_table_set(int* new_table, int new_size)
+{
+    if(leap_table_free_old) free(leap_second_days);
+    leap_table_free_old = 0;
+
+    leap_second_days = new_table;
+    leap_second_days_num = new_size;
+}
+
+
+
+/* leap_table_signature
+ *  The first 8 bytes of a leap second table must match this string, otherwise
+ *  the file is taken not to be of the correct format.
+ */
+static const char*
+leap_table_signature = "/O9PdPZI";
+
+
+
+/* iso8601_leap_table_load()
+ *  Loads a new table of leap seconds from disk. Ensures the signature of the
+ *  given file matches ‘leap_table_signature’, and does some basic sanity
+ *  checking (file in sorted order etc.).
+ */
+int
+iso8601_leap_table_load(const char* fname)
+{
+    struct stat st;
+    int fd, saved_errno, i, new_size, * days = 0;
+    char buf[12];
+
+    if(!fname) fname = DEFAULT_LEAP_TABLE;
+
+    if(stat(fname, &st)) return -1;
+    if(st.st_size < 12) {
+        errno = EINVAL;
+        return -1;
+    }
+
+    fd = open(fname, O_RDONLY);
+    if(fd == -1) return -1;
+
+    if(TEMP_FAILURE_RETRY( read(fd, buf, 12) ) != 12) goto outerr;
+    if(memcmp(buf, leap_table_signature, 8)) {
+        errno = EINVAL;
+        return -1;
+    }
+
+#define GET_UINT32(_from) ( \
+    ( ((uint8_t*)_from)[0] << 24 ) | \
+    ( ((uint8_t*)_from)[1] << 16 ) | \
+    ( ((uint8_t*)_from)[2] << 8 ) | \
+    ( ((uint8_t*)_from)[3] ) \
+)
+
+    new_size = GET_UINT32(buf + 8);
+    if((12 + new_size * 4) != st.st_size) {
+        errno = EINVAL;
+        goto outerr;
+    }
+
+    days = malloc(sizeof(int) * new_size);
+    if(!days) goto outerr;
+
+    for(i = 0; i < new_size; ++i) {
+        if(TEMP_FAILURE_RETRY( read(fd, buf, 4) ) != 4) goto outerr;
+        days[i] = GET_UINT32(buf);
+        if(i && days[i] <= days[i - 1]) {
+            errno = EINVAL;
+            goto outerr;
+        }
+    }
+
+    TEMP_FAILURE_RETRY( close(fd) );
+    iso8601_leap_table_set(days, new_size);
+    leap_table_free_old = 1;
+    return 0;
+
+#undef GET_UINT32
+
+  outerr:
+    saved_errno = errno;
+    free(days);
+    TEMP_FAILURE_RETRY( close(fd) );
+    errno = saved_errno;
+    return -1;
+}
+
+
+
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 vim: expandtab:ts=4:sw=4

src/libiso8601/100_types.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/100_types.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,19 +9,20 @@
 
 /*! \brief Date/time point.
 
-This structure contains the details to represent a specific instant on the UTC timescale. It uses
-Jan 1, year 0000 as the origin (when \a day will be 0). \a sec is the number of seconds elapsed
-since start of day, and \a nsec is the number of nanoseconds elapsed since the start of the current
-second.
+This structure contains the details to represent a specific instant on the UTC
+timescale. It uses Jan 1, year 0000 as the origin (when \a day will be 0). \a
+sec is the number of seconds elapsed since start of day, and \a nsec is the
+number of nanoseconds elapsed since the start of the current second.
 
-We correctly deal with leap seconds by encoding 23:59:60 as having a \a sec field of 86400.
+We correctly deal with leap seconds by encoding 23:59:60 as having a \a sec
+field of 86400.
 
 */
 struct iso8601_date {
     /*! \brief Number of nanoseconds elapsed since start of second. */
     int32_t nsec;
 
-    /*! \brief Number of days elapsed since Jan 1, year 0000. May be negative. */
+    /*! \brief Number of days elapsed since Jan 1, year 0000. May be negative.*/
     int32_t day;
 
     /*! \brief Number of seconds elapsed since start of day. */
@@ -33,9 +34,10 @@ struct iso8601_date {
 /*! \brief Date (day portion) precision.
 \ingroup parser
 
-This enumeration will record how precisely the date was specified, as well as the format in use. It
-allows the library to determine the earliest and latest dates that could possibly be represented
-with the given input and also allows the output format to match the input format.
+This enumeration will record how precisely the date was specified, as well as
+the format in use. It allows the library to determine the earliest and latest
+dates that could possibly be represented with the given input and also allows
+the output format to match the input format.
 
 */
 enum iso8601_date_prec {
@@ -56,16 +58,17 @@ enum iso8601_date_prec {
 
     /*! \brief Year, week and weekday specified (week format). */
     iso8601_prec_wday
-}date_prec;
+};
 
 
 
 /*! \brief Time precision.
 \ingroup parser
 
-This enumeration records how precisely the time was specified as well as its format. The fractional
-format will record whether it was the hour, minute or second that was specified with a fractional
-part, allowing a processed date/time to be presented to the user in the format it was originally
+This enumeration records how precisely the time was specified as well as its
+format. The fractional format will record whether it was the hour, minute or
+second that was specified with a fractional part, allowing a processed
+date/time to be presented to the user in the format it was originally
 encountered.
 
 */
@@ -84,23 +87,23 @@ enum iso8601_time_prec {
     iso8601_prec_minfrac,
     /*! \brief Display hour, minute, second and nanoseconds. */
     iso8601_prec_secfrac
-}time_prec;
+};
 
 
 
 /*! \brief Date/time formatting details.
 
-This structure simply records details related to the formatting (and precision) of a date/time
-structure. The structure can be filled out by the parser so that a program's output can match
-the format of its input. Alternatively it can be controlled by the program to provide a consistent
-output format.
+This structure simply records details related to the formatting (and precision)
+of a date/time structure. The structure can be filled out by the parser so that
+a program's output can match the format of its input. Alternatively it can be
+controlled by the program to provide a consistent output format.
 
 */
 struct iso8601_details {
-    /*! \brief Date precision (enum iso8601_date_prec). */
+    /*! \brief Date precision (\ref iso8601_date_prec). */
     uint8_t date_prec;
 
-    /*! \brief Time precision (enum iso8601_time_prec). */
+    /*! \brief Time precision (\ref iso8601_time_prec). */
     uint8_t time_prec;
 
     /*! \brief Flag: non-zero if extended format should be used. */
@@ -114,9 +117,10 @@ struct iso8601_details {
 
 /*! \brief Short period elapsed time.
 
-This structure contains the details of an elapsed time period, split into seconds and nanoseconds.
-None of its components can ever be negative. This is only capable of representing short (compared to
-struct iso8601_date's range) periods of up to approximately 136 years.
+This structure contains the details of an elapsed time period, split into
+seconds and nanoseconds.  None of its components can ever be negative. This is
+only capable of representing short (compared to struct iso8601_date's range)
+periods of up to approximately 136 years.
 
 */
 struct iso8601_elapsed {
@@ -130,5 +134,5 @@ struct iso8601_elapsed {
 
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/200_parser.c

@@ -1,24 +1,25 @@
 /* libiso8601/src/libiso8601/200_parser.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 
 
-int iso8601_parse(const char* str, struct iso8601_date* earliest, struct iso8601_date* latest,
-    struct iso8601_details* details)
+int
+iso8601_parse(const char* str, struct iso8601_date* earliest,
+    struct iso8601_date* latest, struct iso8601_details* details)
 {
     enum {
         state_none,
-        state_year, // e.g. `2006' or `2006123'
-        state_date2, // 2nd component of date, e.g. `2006-' or `2006-1'
-        state_day, // e.g. `2006-01-' or `2006-01-01'
-        state_week_basic, // e.g. `2006W' or `2006W123'
-        state_week_extended, // e.g. `2006-W' or `2006-W31'
-        state_week_day, // e.g. `2006-W31-'
-        state_week_done, // `2006-W31-1'
+        state_year, /* e.g. `2006' or `2006123' */
+        state_date2, /* 2nd component of date, e.g. `2006-' or `2006-1' */
+        state_day, /* e.g. `2006-01-' or `2006-01-01' */
+        state_week_basic, /* e.g. `2006W' or `2006W123' */
+        state_week_extended, /* e.g. `2006-W' or `2006-W31' */
+        state_week_day, /* e.g. `2006-W31-' */
+        state_week_done, /* `2006-W31-1' */
         state_time_basic,
         state_time_hour,
         state_time_min,
@@ -34,8 +35,9 @@ int iso8601_parse(const char* str, struct iso8601_date* earliest, struct iso8601
 
     div_t qr;
     char ch;
-    int num = 0, neg = 0, dig = 0, tz_neg = 0, nsec = -1, nsec_dig = -1, leap_sec_req = 0;
-    int y = 0, m = -1, d = -1, w = -1, wd = -1, hour = -1, min = -1, sec = -1, tz_sec = 0;
+    int num = 0, neg = 0, dig = 0, tz_neg = 0, nsec = -1, nsec_dig = -1,
+        leap_sec_req = 0, y = 0, m = -1, d = -1, w = -1, wd = -1, hour = -1,
+        min = -1, sec = -1, tz_sec = 0;
     double frac;
     struct iso8601_elapsed elapsed;
 
@@ -436,7 +438,8 @@ int iso8601_parse(const char* str, struct iso8601_date* earliest, struct iso8601
             case '-':
                 tz_neg = -1;
             case '+':
-                state = (state == state_time_nsec_basic) ? state_tz_basic : state_tz_hour;
+                state = (state == state_time_nsec_basic) ?
+                    state_tz_basic : state_tz_hour;
                 break;
             }
             break;
@@ -544,7 +547,8 @@ done:
     if(m != -1) {
         if(d == -1) {
             ERROR_IF(earliest && iso8601_from_cal(earliest, y, m, 1));
-            ERROR_IF(latest && iso8601_from_cal(latest, y, m, _days_in_month(y, m)));
+            ERROR_IF(latest && iso8601_from_cal(latest, y, m,
+                _days_in_month(y, m)));
             if(details) details->date_prec = iso8601_prec_month;
 
         } else {
@@ -608,7 +612,8 @@ done:
 
     } else if(min != -1) {
         if(nsec_dig == -1) {
-            ERROR_IF(earliest && iso8601_from_clocktime(earliest, hour, min, 0));
+            ERROR_IF(earliest && iso8601_from_clocktime(earliest,
+                hour, min, 0));
             ERROR_IF(latest && iso8601_from_clocktime(latest, hour, min, 59));
             if(latest) latest->nsec = 999999999;
             if(details) details->time_prec = iso8601_prec_min;
@@ -617,7 +622,8 @@ done:
             frac = nsec * 60.0 / 1e9;
             sec = (int)frac;
             nsec = (frac - sec) * 1e9;
-            ERROR_IF(earliest && iso8601_from_clocktime(earliest, hour, min, sec));
+            ERROR_IF(earliest && iso8601_from_clocktime(earliest,
+                hour, min, sec));
             if(earliest) earliest->nsec = nsec;
             ERROR_IF(latest && iso8601_from_clocktime(latest, hour, min, sec));
             if(latest) latest->nsec = nsec;
@@ -639,7 +645,8 @@ done:
             frac *= 60;
             sec = (int)frac;
             nsec = (frac - sec) * 1e9;
-            ERROR_IF(earliest && iso8601_from_clocktime(earliest, hour, min, sec));
+            ERROR_IF(earliest && iso8601_from_clocktime(earliest,
+                hour, min, sec));
             if(earliest) earliest->nsec = nsec;
             ERROR_IF(latest && iso8601_from_clocktime(latest, hour, min, sec));
             if(latest) latest->nsec = nsec;
@@ -676,7 +683,8 @@ done:
 
 
 
-int iso8601_invalid(const struct iso8601_date* date)
+int
+iso8601_invalid(const struct iso8601_date* date)
 {
     return date->nsec < 0
         || date->nsec >= BILLION

src/libiso8601/200_parser.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/200_parser.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,31 +9,41 @@
 
 /*! \defgroup parser Parsing, printing and validation routines.
 
-These routines are used for parsing an ISO8601 date/time string into the internal structure used
-to represent them, and for validating such dates/times.
+These routines are used for parsing an ISO8601 date/time string into the
+internal structure used to represent them, and for validating such dates/times.
 
 */
 /*!@{*/
 
+
+
 /*! \brief Parse ISO8601 date/time.
 
 \param str The input string. Whitespace will be stripped.
-\param[out] earliest The earliest possible time the string could represent. May be 0.
-\param[out] latest The latest possible time the string could represent. May be 0.
-\param[out] details Stores details such as the precision to which the time/date were specified. May
+\param[out] earliest The earliest possible time the string could represent. May
     be 0.
+\param[out] latest The latest possible time the string could represent. May be
+    0.
+\param[out] details Stores details such as the precision to which the time/date
+    were specified. May be 0.
 \retval -1 on error.
 \retval 0 on success.
 
-Parses a string containing the ISO8601 date/time. Deals with any format of date, optionally storing
-the details in \a details. The time may be partial, in which case this function returns the earliest
-and latest times that could possibly be represented by the string.
+Parses a string containing the ISO8601 date/time. Deals with any format of
+date, optionally storing the details in \a details. The time may be partial, in
+which case this function returns the earliest and latest times that could
+possibly be represented by the string.
 
-Note that this function will accept leap seconds (23:59:60) on days on which they occurred.
+Note that this function will accept leap seconds (23:59:60) on days on which
+they occurred.
 
 */
-int iso8601_parse(const char* str, struct iso8601_date* earliest, struct iso8601_date* latest,
-    struct iso8601_details* details);
+int iso8601_parse(const char* str, struct iso8601_date* earliest,
+    struct iso8601_date* latest, struct iso8601_details* details)
+#ifndef DOXYGEN
+    __attribute__((nonnull(1),warn_unused_result))
+#endif
+;
 
 
 
@@ -45,12 +55,17 @@ int iso8601_parse(const char* str, struct iso8601_date* earliest, struct iso8601
 \param details Formatting details (may be 0).
 \returns Pointer to buffer (\a str).
 
-Formats and prints an ISO8601 date, optionally using the details in \a details. Will always return
-a null-terminated result, even if that means truncating the output to fit the buffer.
+Formats and prints an ISO8601 date, optionally using the details in \a details.
+Will always return a null-terminated result, even if that means truncating the
+output to fit the buffer.
 
 */
 char* iso8601_print(char* str, int amt, const struct iso8601_date* date, 
-    const struct iso8601_details* details);
+    const struct iso8601_details* details)
+#ifndef DOXYGEN
+    __attribute__((nonnull(1,3)))
+#endif
+;
 
 
 
@@ -60,18 +75,21 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
 \retval -1 if not valid.
 \retval 0 if valid.
 
-Checks the details of \a date to ensure that they are sensible. This involves checking that \a sec
-is in the range 0 to 86399 (or 86400 if there is a leap second), and that \a nsec is in the range 0
-to 999999999.
+Checks the details of \a date to ensure that they are sensible. This involves
+checking that \a sec is in the range 0 to 86399 (or 86400 if there is a leap
+second), and that \a nsec is in the range 0 to 999999999.
 
 */
-int iso8601_invalid(const struct iso8601_date* date);
+int iso8601_invalid(const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
 /*!@}*/
-
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/200_print.c

@@ -1,13 +1,18 @@
-/* libiso8601/src/libiso8601/print.c
+/* libiso8601/src/libiso8601/200_print.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 
 
-static const struct iso8601_details _default_details = {
+/* _default_details
+ *  If the user doesn't pass precision details to iso8601_print(), these are
+ *  used instead.
+ */
+static const struct iso8601_details
+_default_details = {
     iso8601_prec_day,
     iso8601_prec_sec,
     1,
@@ -16,7 +21,8 @@ static const struct iso8601_details _default_details = {
 
 
 
-char* iso8601_print(char* str, int amt, const struct iso8601_date* date, 
+char*
+iso8601_print(char* str, int amt, const struct iso8601_date* date, 
     const struct iso8601_details* details)
 {
     int y, m, d, ret = 0, extended;
@@ -27,10 +33,10 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
 
     str_orig = str;
 
-    // use default details if none provided
+    /* use default details if none provided */
     if(!details) details = &_default_details;
 
-    // adjust output for timezone
+    /* adjust output for timezone */
     dttz = *date;
     if(details->tz_sec) {
         elapsed.sec = details ? details->tz_sec : 0;
@@ -38,7 +44,7 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
         iso8601_add_elapsed(&dttz, &elapsed);
     }
 
-    // determine whether or not to force extended output
+    /* determine whether or not to force extended output */
     iso8601_to_cal(&y, &m, &d, &dttz);
     extended = details->extended || y < 0 || y > 9999;
 
@@ -55,27 +61,32 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
 
     case iso8601_prec_day:
         if(y < 0) ret = snprintf(str, amt, "%05d-%02d-%02d", y, m, d);
-        else ret = snprintf(str, amt, extended ? "%04d-%02d-%02d" : "%04d%02d%02d", y, m, d);
+        else ret = snprintf(str, amt, extended ?
+            "%04d-%02d-%02d" : "%04d%02d%02d", y, m, d);
         break;
 
     case iso8601_prec_ord:
         iso8601_to_ord(&y, &d, &dttz);
         if(y < 0) ret = snprintf(str, amt, "%05d-%03d", y, d);
-        else ret = snprintf(str, amt, extended ? "%04d-%03d" : "%04d%03d", y, d);
+        else ret = snprintf(str, amt, extended ?
+            "%04d-%03d" : "%04d%03d", y, d);
         break;
 
     case iso8601_prec_week:
         iso8601_to_week(&y, &m, &d, &dttz);
-        extended = y < 0 || y > 9999 || details->extended; // ISO year is different
+        /* note: ISO year can differ, so recompute extended flag */
+        extended = y < 0 || y > 9999 || details->extended;
         if(y < 0) snprintf(str, amt, "%05d-W%02d", y, m);
         else snprintf(str, amt, extended ? "%04d-W%02d" : "%04dW%02d", y, m);
         return str_orig;
 
     case iso8601_prec_wday:
         iso8601_to_week(&y, &m, &d, &dttz);
-        extended = y < 0 || y > 9999 || details->extended; // ISO year is different
+        /* note: ISO year can differ, so recompute extended flag */
+        extended = y < 0 || y > 9999 || details->extended;
         if(y < 0) ret = snprintf(str, amt, "%05d-W%02d-%d", y, m, d);
-        else ret = snprintf(str, amt, extended ? "%04d-W%02d-%d" : "%04dW%02d%d", y, m, d);
+        else ret = snprintf(str, amt, extended ?
+            "%04d-W%02d-%d" : "%04dW%02d%d", y, m, d);
         break;
     }
 
@@ -111,7 +122,8 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
         break;
 
     case iso8601_prec_sec:
-        ret = snprintf(str, amt, extended ? "T%02d:%02d:%02d" : "T%02d%02d%02d", y, m, d);
+        ret = snprintf(str, amt, extended ?
+            "T%02d:%02d:%02d" : "T%02d%02d%02d", y, m, d);
         break;
 
     case iso8601_prec_hourfrac:
@@ -121,24 +133,22 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
 
     case iso8601_prec_minfrac:
         frac = m + (d + date->nsec / 1e9) / 60.0;
-        ret = snprintf(str, amt, extended ? "T%02d:%#012.9f" : "T%02d%#012.9f", y, frac);
+        ret = snprintf(str, amt, extended ?
+            "T%02d:%#012.9f" : "T%02d%#012.9f", y, frac);
         break;
 
     case iso8601_prec_secfrac:
         frac = d + date->nsec / 1e9;
-        ret = snprintf(str, amt, extended ? "T%02d:%02d:%#012.9f" : "T%02d%02d%#012.9f", y, m, frac);
+        ret = snprintf(str, amt, extended ?
+            "T%02d:%02d:%#012.9f" : "T%02d%02d%#012.9f", y, m, frac);
         break;
     }
 
-    if(ret < 1 || ret >= amt) return str_orig;
+    if(ret < 1 || (ret + 1) >= amt) return str_orig;
     str += ret;
     amt -= ret;
 
     if(details->tz_sec) {
-        if(!--amt) {
-            *str = 0;
-            return str_orig;
-        }
         if(details->tz_sec < 0) {
             *str++ = '-';
             ret = -details->tz_sec;
@@ -146,6 +156,7 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
             *str++ = '+';
             ret = details->tz_sec;
         }
+        --amt;
 
         y = ret / 3600;
         ret -= y * 3600;
@@ -153,12 +164,14 @@ char* iso8601_print(char* str, int amt, const struct iso8601_date* date,
         ret -= m * 60;
         d = ret;
 
-        if(d) snprintf(str, amt, extended ? "%02d:%02d:%02d" : "%02d%02d%02d", y, m, d);
-        else if(m) snprintf(str, amt, extended ? "%02d:%02d" : "%02d%02d", y, m);
+        if(d) snprintf(str, amt, extended ?
+            "%02d:%02d:%02d" : "%02d%02d%02d", y, m, d);
+        else if(m) snprintf(str, amt, extended ?
+            "%02d:%02d" : "%02d%02d", y, m);
         else snprintf(str, amt, "%02d", y);
     } else {
         *str++ = 'Z';
-        if(amt > 1) *str = 0;
+        *str++ = 0;
     }
     
     return str_orig;

src/libiso8601/400_c_library.c

@@ -1,16 +1,17 @@
 /* libiso8601/src/libiso8601/400_c_library.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
-// days between 0000-001 and 1970-001 (the unix epoch)
+/* days between 0000-001 and 1970-001 (the unix epoch) */
 #define EPOCH_GDAY (719528)
 
 
 
-void iso8601_now(struct iso8601_date* date, struct iso8601_details* details)
+void
+iso8601_now(struct iso8601_date* date, struct iso8601_details* details)
 {
     static int use_gettimeofday = 0;
     struct timespec ts;
@@ -21,7 +22,8 @@ void iso8601_now(struct iso8601_date* date, struct iso8601_details* details)
     if(use_gettimeofday || clock_gettime(CLOCK_REALTIME, &ts)) {
         use_gettimeofday = 1;
         gettimeofday(&tv, 0);
-        ts.tv_sec = tv.tv_sec;
+        if(tv.tv_sec < 0) ts.tv_sec = 0;
+        else ts.tv_sec = tv.tv_sec;
         ts.tv_nsec = tv.tv_usec * 1000L;
     }
 
@@ -44,7 +46,8 @@ void iso8601_now(struct iso8601_date* date, struct iso8601_details* details)
 
 
 
-int iso8601_set_sysclock(const struct iso8601_date* date)
+int
+iso8601_set_sysclock(const struct iso8601_date* date)
 {
     static int use_settimeofday = 0;
     struct timeval tv;
@@ -71,11 +74,16 @@ int iso8601_set_sysclock(const struct iso8601_date* date)
 
 
 
-void iso8601_from_ts(struct iso8601_date* date, const struct timespec* ts)
+void
+iso8601_from_ts(struct iso8601_date* date, const struct timespec* ts)
 {
     ldiv_t qr;
 
     qr = ldiv(ts->tv_sec, 86400);
+    if(ts->tv_sec < 0) {
+        --qr.quot;
+        qr.rem += 86400;
+    }
     date->day = EPOCH_GDAY + qr.quot;
     date->sec = qr.rem;
     date->nsec = ts->tv_nsec;
@@ -83,7 +91,8 @@ void iso8601_from_ts(struct iso8601_date* date, const struct timespec* ts)
 
 
 
-void iso8601_to_ts(struct timespec* ts, const struct iso8601_date* date)
+void
+iso8601_to_ts(struct timespec* ts, const struct iso8601_date* date)
 {
     ts->tv_sec = 86400L * (date->day - EPOCH_GDAY) + date->sec;
     ts->tv_nsec = date->nsec;
@@ -91,11 +100,16 @@ void iso8601_to_ts(struct timespec* ts, const struct iso8601_date* date)
 
 
 
-void iso8601_from_tv(struct iso8601_date* date, const struct timeval* tv)
+void
+iso8601_from_tv(struct iso8601_date* date, const struct timeval* tv)
 {
     ldiv_t qr;
 
     qr = ldiv(tv->tv_sec, 86400);
+    if(tv->tv_sec < 0) {
+        --qr.quot;
+        qr.rem += 86400;
+    }
     date->day = EPOCH_GDAY + qr.quot;
     date->sec = qr.rem;
     date->nsec = tv->tv_usec * 1000;
@@ -103,7 +117,8 @@ void iso8601_from_tv(struct iso8601_date* date, const struct timeval* tv)
 
 
 
-void iso8601_to_tv(struct timeval* tv, const struct iso8601_date* date)
+void
+iso8601_to_tv(struct timeval* tv, const struct iso8601_date* date)
 {
     tv->tv_sec = 86400L * (date->day - EPOCH_GDAY) + date->sec;
     tv->tv_usec = date->nsec / 1000;
@@ -111,11 +126,16 @@ void iso8601_to_tv(struct timeval* tv, const struct iso8601_date* date)
 
 
 
-void iso8601_from_time_t(struct iso8601_date* date, const time_t* t)
+void
+iso8601_from_time_t(struct iso8601_date* date, const time_t* t)
 {
     ldiv_t qr;
 
     qr = ldiv(*t, 86400);
+    if(*t < 0) {
+        --qr.quot;
+        qr.rem += 86400;
+    }
     date->day = EPOCH_GDAY + qr.quot;
     date->sec = qr.rem;
     date->nsec = 0;
@@ -123,7 +143,8 @@ void iso8601_from_time_t(struct iso8601_date* date, const time_t* t)
 
 
 
-void iso8601_to_time_t(time_t* t, const struct iso8601_date* date)
+void
+iso8601_to_time_t(time_t* t, const struct iso8601_date* date)
 {
     *t = 86400L * (date->day - EPOCH_GDAY) + date->sec;
 }

src/libiso8601/400_c_library.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/400_c_library.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,7 +9,8 @@
 
 /*! \defgroup c_library C library integration.
 
-These functions enable integration with the C library (system call wrappers and conversion).
+These functions enable integration with the C library (system call wrappers and
+conversion).
 
 */
 /*!@{*/
@@ -18,11 +19,11 @@ These functions enable integration with the C library (system call wrappers and
 
 /*! \brief Retrieve the current time.
 
-\param[out] date Current date/time (may be 0), in UTC.
-\param[out] details Details (may be 0), including timezone.
+\param[out] date Current date/time (may be 0), in UTC. May be 0.
+\param[out] details Details (may be 0), including timezone. May be 0.
 
-Retrieves the current time from the system clock, storing it into \a date and \a details (both
-parameters optional).
+Retrieves the current time from the system clock, storing it into \a date and
+\a details (both parameters optional).
 
 */
 void iso8601_now(struct iso8601_date* date, struct iso8601_details* details);
@@ -35,32 +36,65 @@ void iso8601_now(struct iso8601_date* date, struct iso8601_details* details);
 \retval 0 on success.
 \retval -1 on error (and see \a errno).
 
-Attempts to set the system clock using \c clock_settime(), falling back to \c settimeofday(). The
-user will need the \c CAP_SYS_TIME capability to set the clock, otherwise \a errno will be set to
-\c EPERM.
+Attempts to set the system clock using \c clock_settime(), falling back to \c
+settimeofday(). The user will need the \c CAP_SYS_TIME capability to set the
+clock, otherwise \a errno will be set to \c EPERM.
 
 */
-int iso8601_set_sysclock(const struct iso8601_date* date);
+int iso8601_set_sysclock(const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
 /*! \brief Convert from a struct timespec. */
-void iso8601_from_ts(struct iso8601_date* date, const struct timespec* ts);
+void iso8601_from_ts(struct iso8601_date* date, const struct timespec* ts)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
 /*! \brief Convert to a struct timespec. */
-void iso8601_to_ts(struct timespec* ts, const struct iso8601_date* date);
+void iso8601_to_ts(struct timespec* ts, const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
 /*! \brief Convert from a struct timeval. */
-void iso8601_from_tv(struct iso8601_date* date, const struct timeval* tv);
+void iso8601_from_tv(struct iso8601_date* date, const struct timeval* tv)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
 /*! \brief Convert to a struct timeval. */
-void iso8601_to_tv(struct timeval* tv, const struct iso8601_date* date);
+void iso8601_to_tv(struct timeval* tv, const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
 /*! \brief Convert from a time_t. */
-void iso8601_from_time_t(struct iso8601_date* date, const time_t* t);
+void iso8601_from_time_t(struct iso8601_date* date, const time_t* t)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
 /*! \brief Convert to a time_t. */
-void iso8601_to_time_t(time_t* t, const struct iso8601_date* date);
+void iso8601_to_time_t(time_t* t, const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
 /*!@}*/
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/400_calc.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/400_calc.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,8 +9,8 @@
 
 /*! \defgroup calc Conversion and calculation routines.
 
-This set of functions is useful for converting dates and times into formats understood by humans,
-and vice versa.
+This set of functions is useful for converting dates and times into formats
+understood by humans, and vice versa.
 
 */
 /*!@{*/
@@ -38,7 +38,12 @@ int iso8601_isleap(int year);
 \param date Date to convert.
 
 */
-void iso8601_to_cal(int* year, int* month, int* day, const struct iso8601_date* date);
+void iso8601_to_cal(int* year, int* month, int* day,
+    const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -51,11 +56,18 @@ void iso8601_to_cal(int* year, int* month, int* day, const struct iso8601_date*
 \retval 0 on success.
 \retval -1 on error (and see \a errno).
 
-Converts the date specified in \a year, \a month and \a day into \a date. Does not touch the \a sec
-or \a nsec time members of \a date.
+Converts the date specified in \a year, \a month and \a day into \a date.
+
+\note Does not touch the \a sec or \a nsec time members of \a date. This means
+    they will be unchanged after a call to this function. If this will lead to
+    unexpected results, initialise the structure to 0 first.
 
 */
-int iso8601_from_cal(struct iso8601_date* date, int year, int month, int day);
+int iso8601_from_cal(struct iso8601_date* date, int year, int month, int day)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -66,7 +78,11 @@ int iso8601_from_cal(struct iso8601_date* date, int year, int month, int day);
 \param date Date to convert.
 
 */
-void iso8601_to_ord(int* year, int* oday, const struct iso8601_date* date);
+void iso8601_to_ord(int* year, int* oday, const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -78,11 +94,18 @@ void iso8601_to_ord(int* year, int* oday, const struct iso8601_date* date);
 \retval 0 on success.
 \retval -1 on error (and see \a errno).
 
-Converts the date specified into \a year and \a oday into \a date. Does not touch the \a sec or
-\a nsec time members of \a date.
+Converts the date specified into \a year and \a oday into \a date.
+
+\note Does not touch the \a sec or \a nsec time members of \a date. This means
+    they will be unchanged after a call to this functoin. If this will lead to
+    unexpected results, initialise the structure to 0 first.
 
 */
-int iso8601_from_ord(struct iso8601_date* date, int year, int oday);
+int iso8601_from_ord(struct iso8601_date* date, int year, int oday)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -94,7 +117,12 @@ int iso8601_from_ord(struct iso8601_date* date, int year, int oday);
 \param date Date to convert.
 
 */
-void iso8601_to_week(int* year, int* week, int* wday, const struct iso8601_date* date);
+void iso8601_to_week(int* year, int* week, int* wday,
+    const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -107,8 +135,18 @@ void iso8601_to_week(int* year, int* week, int* wday, const struct iso8601_date*
 \retval 0 on success.
 \retval -1 on error (and see \a errno).
 
+Converts the date specified into \a year, \a week and \a wday into \a date.
+
+\note Does not touch the \a sec or \a nsec time members of \a date. This means
+    they will be unchanged after a call to this functoin. If this will lead to
+    unexpected results, initialise the structure to 0 first.
+
 */
-int iso8601_from_week(struct iso8601_date* date, int year, int week, int wday);
+int iso8601_from_week(struct iso8601_date* date, int year, int week, int wday)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -119,11 +157,16 @@ int iso8601_from_week(struct iso8601_date* date, int year, int week, int wday);
 \param[out] sec Output second.
 \param date Date/time to convert.
 
-Converts the time stored in \a date into wall clock format, storing the result in \a hour, \a min
-and \a sec.
+Converts the time stored in \a date into wall clock format, storing the result
+in \a hour, \a min and \a sec.
 
 */
-void iso8601_to_clocktime(int* hour, int* min, int* sec, const struct iso8601_date* date);
+void iso8601_to_clocktime(int* hour, int* min, int* sec,
+    const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -136,16 +179,25 @@ void iso8601_to_clocktime(int* hour, int* min, int* sec, const struct iso8601_da
 \retval 0 on success.
 \retval -1 on error (and see \a errno).
 
-Converts the time as specified by \a hour, \a min and \a sec, storing the result in \a date. Does
-not touch the \a day (date) member of \a date.
+Converts the time as specified by \a hour, \a min and \a sec, storing the
+result in \a date.
+
+\note Does not touch the \a day (date) member of \a date. This means it will be
+    unchanged after a call to this function. If this will lead to unexpected
+    results, initialise the structure to 0 first.
 
 */
-int iso8601_from_clocktime(struct iso8601_date* date, int hour, int min, int sec);
+int iso8601_from_clocktime(struct iso8601_date* date, int hour, int min,
+    int sec)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
 /*!@}*/
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/400_leap.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/400_leap.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,7 +9,30 @@
 
 /*! \defgroup leap Leap second support.
 
-A set of functions for explicitly dealing with leap seconds.
+A set of functions for explicitly dealing with leap seconds. All library
+functions are implicitly leap second aware, but there are occasions when leap
+seconds must be dealt with explicitly. These functions permit this.
+
+Internally, leap seconds are represented as a table of day numbers; each day
+number present in the table means that the corresponding day has 86401 seconds
+(a leap second).
+
+\note The library does not (yet) have support for negative leap seconds. This
+    support will be added should a day with a negative leap second ever come.
+    This will need to addressed in the API as the current API does not support
+    loading a table of negative leap seconds.
+
+It is possible to create a disk file containing an updated table and to load
+that file using \ref iso8601_leap_table_load (or to explicitly use an existing
+in-memory table with \ref iso8601_leap_table_set). The format of the on-disk
+file is:
+
+<pre># integers are stored big-endian
+[8*char] signature, "/O9PdPZI"
+[uint32] number of entries, 'n'
+
+# entries are repeated 'n' times, and stored lowest day number first
+[uint32] day number of entry</pre>
 
 */
 /*!@{*/
@@ -23,14 +46,19 @@ A set of functions for explicitly dealing with leap seconds.
 \retval 86400 day with no leap second.
 \retval 86401 day with one leap second.
 
-Returns the duration of a day \a date, in seconds. This function takes leap seconds into account and
-may be used to determine if a day contains a leap second or not.
+Returns the duration of a day \a date, in seconds. This function takes leap
+seconds into account and may be used to determine if a day contains a leap
+second or not.
 
-\note There have not yet been any days requiring a negative leap second, so at present 86399 will
-    never be returned.
+\note There have not yet been any days requiring a negative leap second, so at
+    present 86399 will never be returned.
 
 */
-int iso8601_seconds_leap(const struct iso8601_date* date);
+int iso8601_seconds_leap(const struct iso8601_date* date)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -40,18 +68,68 @@ int iso8601_seconds_leap(const struct iso8601_date* date);
 \param end The end date.
 \returns Number of leap seconds elapsed.
 
-Computes the number of leap seconds that have elapsed between two days. Note that this is the sum of
-such leap seconds, so it will be 0 if (for example) there is one positive leap second and one 
-negative leap second. The ordering of the dates is important; if \a start is after \a end, then the
-value returned will be negative (for positive leap seconds).
+Computes the number of leap seconds that have elapsed between two days. Note
+that this is the sum of such leap seconds, so it will be 0 if (for example)
+there is one positive leap second and one negative leap second. The ordering of
+the dates is important; if \a start is after \a end, then the value returned
+will be negative (for positive leap seconds).
 
 */
-int iso8601_leap_elapsed(const struct iso8601_date* start, const struct iso8601_date* end);
+int iso8601_leap_elapsed(const struct iso8601_date* start,
+    const struct iso8601_date* end)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
+
+
+/*! \brief Update table of leap seconds.
+
+\param new_table Array of day numbers on which leap seconds occur.
+\param new_size Number of entries in array.
+
+This function can be used to update the table of leap seconds at runtime. The
+\a new_table argument points to an array of integers, each entry being the day
+number containing a leap second.  The array must be sorted so that lower day
+numbers appear towards the start of the array. \a new_size gives the number of
+entries in the array. \a new_table must persist in memory as long as library
+functions are in use.
+
+\warning If negative leap seconds are ever used, this function will not support
+    them. There may need to be an ABI change in future to solve this problem.
+
+*/
+void iso8601_leap_table_set(int* new_table, int new_size)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
+
+
+/*! \brief Load new table of leap seconds from disk.
+
+\param fname Filename. May be 0 for system default.
+\retval 0 on success.
+\retval -1 on error (and see \a errno).
+
+This function attempts to load a new table of leap seconds from disk, using the
+filename \a fname.  If \a fname is not specified, the system default (set at
+compile time) will be used.
+
+If the table is loaded successfully, it will be set with \ref
+iso8601_leap_table_set(). On any error, -1 will be returned, and \a errno will
+be set appropriately. If \a errno is \c EINVAL, then the file does not contain
+a valid leap second table.
+
+*/
+int iso8601_leap_table_load(const char* fname);
 
 
 
 /*!@}*/
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/400_manip.c

@@ -1,13 +1,14 @@
 /* libiso8601/src/libiso8601/400_manip.c
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
 
 
-int iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2)
+int
+iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2)
 {
     if(d1->day < d2->day) return 1;
     if(d1->day > d2->day) return 0;
@@ -19,7 +20,8 @@ int iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2)
 
 
 
-int iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2)
+int
+iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2)
 {
     if(d1->day < d2->day) return 1;
     if(d1->day > d2->day) return 0;
@@ -31,26 +33,44 @@ int iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2)
 
 
 
-int iso8601_eq(const struct iso8601_date* d1, const struct iso8601_date* d2)
+int
+iso8601_eq(const struct iso8601_date* d1, const struct iso8601_date* d2)
 {
-    return (d1->day == d2->day) && (d1->sec == d2->sec) && (d1->nsec == d2->nsec);
+    return (d1->day == d2->day) && (d1->sec == d2->sec)
+        && (d1->nsec == d2->nsec);
 }
 
 
 
-void iso8601_add_elapsed(struct iso8601_date* date, const struct iso8601_elapsed* per)
+int
+iso8601_cmp(const struct iso8601_date* d1, const struct iso8601_date* d2)
+{
+    if(d1->day < d2->day) return -1;
+    if(d1->day > d2->day) return 1;
+    if(d1->sec < d2->sec) return -1;
+    if(d1->sec > d2->sec) return 1;
+    if(d1->nsec < d2->nsec) return -1;
+    if(d1->nsec > d2->nsec) return 1;
+    return 0;
+}
+
+
+
+void
+iso8601_add_elapsed(struct iso8601_date* date,
+    const struct iso8601_elapsed* per)
 {
     div_t qr;
     int leapcorrect;
 
-    /* work out number to advance `day' by */
+    /* work out number to advance ‘day’ by */
     qr = div(per->sec, 86400);
     leapcorrect = _leap_elapsed_day(date->day, date->day + qr.quot);
     date->day += qr.quot;
     date->sec += qr.rem - leapcorrect;
 
     date->nsec += per->nsec;
-    if(date->nsec > BILLION) {
+    if(date->nsec >= BILLION) {
         ++date->sec;
         date->nsec -= BILLION;
     }
@@ -68,12 +88,14 @@ void iso8601_add_elapsed(struct iso8601_date* date, const struct iso8601_elapsed
 
 
 
-void iso8601_subtract_elapsed(struct iso8601_date* date, const struct iso8601_elapsed* per)
+void 
+iso8601_subtract_elapsed(struct iso8601_date* date,
+    const struct iso8601_elapsed* per)
 {
     div_t qr;
     int leapcorrect;
 
-    /* work out number to advance `day' by */
+    /* work out number to advance ‘day’ by */
     qr = div(per->sec, 86400);
     leapcorrect = _leap_elapsed_day(date->day - qr.quot, date->day);
     date->day -= qr.quot;
@@ -98,7 +120,27 @@ void iso8601_subtract_elapsed(struct iso8601_date* date, const struct iso8601_el
 
 
 
-void iso8601_difference(const struct iso8601_date* d1, const struct iso8601_date* d2,
+void
+iso8601_add_multiple(struct iso8601_date* date,
+    const struct iso8601_elapsed* per, int n)
+{
+    long long nsec;
+    lldiv_t qr;
+    struct iso8601_elapsed mult;
+
+    nsec = per->nsec * llabs(n);
+    qr = lldiv(nsec, BILLION);
+    mult.sec = qr.quot + per->sec * llabs(n);
+    mult.nsec = qr.rem;
+
+    if(n < 0) iso8601_subtract_elapsed(date, &mult);
+    else iso8601_add_elapsed(date, &mult);
+}
+
+
+
+void
+iso8601_difference(const struct iso8601_date* d1, const struct iso8601_date* d2,
     struct iso8601_elapsed* per, int* sign)
 {
     const struct iso8601_date* e1, * e2;
@@ -130,6 +172,32 @@ void iso8601_difference(const struct iso8601_date* d1, const struct iso8601_date
 
 
 
+int
+iso8601_elapsed_div(const struct iso8601_elapsed* num,
+    const struct iso8601_elapsed* denom, struct iso8601_elapsed* remain)
+{
+    unsigned long long pnum, pdenom;
+    lldiv_t val, v2;
+
+    pnum = num->sec;
+    pnum *= BILLION;
+    pnum += num->nsec;
+
+    pdenom = denom->sec;
+    pdenom *= BILLION;
+    pdenom += denom->nsec;
+
+    val = lldiv(pnum, pdenom);
+    if(remain) {
+        v2 = lldiv(val.rem, BILLION);
+        remain->sec = v2.quot;
+        remain->nsec = v2.rem;
+    }
+    return val.quot;
+}
+
+
+
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 vim: expandtab:ts=4:sw=4

src/libiso8601/400_manip.h

@@ -1,7 +1,7 @@
 /* libiso8601/src/libiso8601/400_manip.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
@@ -9,8 +9,8 @@
 
 /*! \defgroup manip Manipulation routines.
 
-This set of functions is useful for performing arithmetic etc. on dates. It uses 
-struct iso8601_elapsed to represent the magnitude of time differences.
+This set of functions is useful for performing arithmetic etc. on dates. It
+uses struct \ref iso8601_elapsed to represent the magnitude of time differences.
 
 */
 /*!@{*/
@@ -25,7 +25,11 @@ struct iso8601_elapsed to represent the magnitude of time differences.
 \retval 0 otherwise
 
 */
-int iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2);
+int iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -37,7 +41,11 @@ int iso8601_lt(const struct iso8601_date* d1, const struct iso8601_date* d2);
 \retval 0 otherwise
 
 */
-int iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2);
+int iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -49,7 +57,28 @@ int iso8601_lte(const struct iso8601_date* d1, const struct iso8601_date* d2);
 \retval 0 otherwise
 
 */
-int iso8601_eq(const struct iso8601_date* d1, const struct iso8601_date* d2);
+int iso8601_eq(const struct iso8601_date* d1, const struct iso8601_date* d2)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
+
+
+/*! \brief Comparison (for qsort et al.).
+
+\param d1 First date to compare.
+\param d2 Second date to compare.
+\retval -1 if \a d1 &lt; \a d2
+\retval 0 if \a d1 == \a d2
+\retval 1 if \a d1 &gt; \a d2
+
+*/
+int iso8601_cmp(const struct iso8601_date* d1, const struct iso8601_date* d2)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -59,7 +88,12 @@ int iso8601_eq(const struct iso8601_date* d1, const struct iso8601_date* d2);
 \param per Period to advance date/time by.
 
 */
-void iso8601_add_elapsed(struct iso8601_date* date, const struct iso8601_elapsed* per);
+void iso8601_add_elapsed(struct iso8601_date* date,
+    const struct iso8601_elapsed* per)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -69,7 +103,32 @@ void iso8601_add_elapsed(struct iso8601_date* date, const struct iso8601_elapsed
 \param per Period to regress date/time by.
 
 */
-void iso8601_subtract_elapsed(struct iso8601_date* date, const struct iso8601_elapsed* per);
+void iso8601_subtract_elapsed(struct iso8601_date* date,
+    const struct iso8601_elapsed* per)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
+
+
+
+/*! \brief Add a multiple of a period to a date.
+
+\param[in,out] date Date to modify.
+\param per Period to advance date/time by.
+\param n Multiple of \a per.
+
+Adds \a n multiples of \a per to \a date. \a n may be 0 or negative. The result
+is stored in \a date. This is an efficient implementation which avoids loops,
+but it does use 64-bit arithmetic.
+
+*/
+void iso8601_add_multiple(struct iso8601_date* date,
+    const struct iso8601_elapsed* per, int n)
+#ifndef DOXYGEN
+    __attribute__((nonnull))
+#endif
+;
 
 
 
@@ -80,18 +139,44 @@ void iso8601_subtract_elapsed(struct iso8601_date* date, const struct iso8601_el
 \param[out] per Magnitude of period elapsed between two dates. Pointer may be 0.
 \param[out] sign Set to sign of difference (-1 or +1). Pointer may be 0.
 
-This function will perform the calculation <code>|d1 - d2|</code>, storing the result in \a per (if
-it is not a null pointer). The sign of the result is stored in \a sign (if it is not a null 
-pointer), i.e. -1 if \a d2 &gt; \a d1 or +1 if \a d2 &lt;= \a d1.
+This function will perform the calculation <code>|d1 - d2|</code>, storing the
+result in \a per (if it is not a null pointer). The sign of the result is
+stored in \a sign (if it is not a null pointer), i.e. -1 if \a d2 &gt; \a d1 or
++1 if \a d2 &lt;= \a d1.
 
 */
-void iso8601_difference(const struct iso8601_date* d1, const struct iso8601_date* d2,
-    struct iso8601_elapsed* per, int* sign);
+void iso8601_difference(const struct iso8601_date* d1,
+    const struct iso8601_date* d2, struct iso8601_elapsed* per, int* sign)
+#ifndef DOXYGEN
+    __attribute__((nonnull(1,2)))
+#endif
+;
+
+
+
+/*! \brief Divide one period by another.
+
+\param num Numerator.
+\param denom Denominator (divisor).
+\param[out] remain Remainder. May be 0.
+\returns Number of times \a denom divides into \a num.
+
+This function computes the number of times that \a denom can be divided into \a
+num, returning that number. If desired, the remaining period which could not be
+divided can be written into \a remain.  Uses 64-bit arithmetic internally.
+
+*/
+int iso8601_elapsed_div(const struct iso8601_elapsed* num,
+    const struct iso8601_elapsed* denom, struct iso8601_elapsed* remain)
+#ifndef DOXYGEN
+    __attribute__((nonnull(1,2)));
+#endif
+;
 
 
 
 /*!@}*/
 /* options for text editors
 kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-vim: expandtab:ts=4:sw=4
+vim: expandtab:ts=4:sw=4:syntax=ch.doxygen
 */

src/libiso8601/999_BottomHeader.h

@@ -1,10 +1,14 @@
 /* libiso8601/src/libiso8601/999_BottomHeader.h
  *
- *  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv2. See file COPYING or
+ *  (c)2006-2010, Laurence Withers, <l@lwithers.me.uk>.
+ *  Released under the GNU GPLv3. See file COPYING or
  *  http://www.gnu.org/copyleft/gpl.html for details.
 */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif
 
 /* options for text editors

src/libiso8601/build.install-lib

@@ -7,6 +7,7 @@ build_dir_tree "${INCLUDEDIR}" || return 1
 
 # install library
 echo "Installing libraries into '${LIBDIR}'"
+source src/libiso8601/soversion
 install_file ${libiso8601} ${LIBDIR} 0755 || return 1
 BASE="${libiso8601_BASE}.so"
 MAJOR="${BASE}.${SOMAJOR}"
@@ -33,5 +34,4 @@ do_cmd_redir "${CONFFILE}" sed \
 do_cmd chmod 0755 "${CONFFILE}"
 print_success "Done"
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/libiso8601/build.lib

@@ -14,7 +14,9 @@ then
     libiso8601="obj/${libiso8601_BASE}.so.${SOMAJOR}.${SOMICRO}"
     libiso8601_DEP_CFLAGS=""
     libiso8601_DEP_LIBS="-lrt"
-    SO_EXTRA="${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS} -lc"
+    SO_EXTRA="${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS} -lc \
+        -D_GNU_SOURCE -std=gnu99 \
+        -DDEFAULT_LEAP_TABLE=\"${DEFAULT_LEAP_TABLE}\""
 
     echo "Building library ${libiso8601}..."
 
@@ -39,8 +41,9 @@ then
             -Wl,-soname,${SONAME} \
             ${SRC} ${SO_EXTRA} || return 1
 
-        # make tests work
-        do_cmd ln -sf $(basename ${libiso8601}) obj/${SONAME} || return 1
+        # make tests and linking work
+        do_cmd ln -sf "$(basename "${libiso8601}")" "obj/${SONAME}" || return 1
+        do_cmd ln -sf "$(basename "${libiso8601}")" "obj/${libiso8601_BASE}.so" || return 1
 
         print_success "Library built"
     else
@@ -51,5 +54,4 @@ then
     libiso8601_HEADER=${HDR}
 
 fi
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/libiso8601/build.monolithic

@@ -17,5 +17,4 @@ then
     libiso8601_MONOLITHIC=1
     MONOLITHIC_DOC="${MONOLITHIC_DOC} ${HDR}"
 fi
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/libiso8601/config-script

@@ -95,4 +95,3 @@ true
 
 
 # vim: syntax=sh:expandtab:ts=4:sw=4
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;

src/libiso8601/pkgconf.in

@@ -1,21 +0,0 @@
-# libiso8601/src/lib/clib/pkgconf.in
-#
-#  Metadata file for pkg-config
-#  ( http://www.freedesktop.org/software/pkgconfig/ )
-#
-#  (c)2006, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv2. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
-#
-
-# Name, description
-Name: @TODO@
-Description: @TODO@
-Version: @VERSION@
-
-# Requirements
-Requires:
-
-# Compilation information
-Libs: -L@LIBDIR@ -liso8601
-Cflags: -I@INCLUDEDIR@

src/libiso8601/soversion

@@ -1,8 +1,8 @@
 # libiso8601/src/libiso8601/soversion
 #
-#  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv3. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
+#  Copyright: ©2007–2011, Güralp Systems Ltd.
+#  Author: Laurence Withers <lwithers@guralp.com>
+#  License: GPLv3
 #
 
 
@@ -12,4 +12,4 @@
 SOMAJOR=1
 
 # SOMICRO is bumped every time there is a binary-compatible release.
-SOMICRO=0
+SOMICRO=10

src/setisodate/build.app

@@ -8,7 +8,8 @@ build_target libiso8601
 if [ -z ${setisodate_BUILT} ]
 then
     setisodate="obj/setisodate"
-    EXTRAS="${libiso8601} ${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS}"
+    EXTRAS="-std=gnu99 -D_GNU_SOURCE -DAPP_NAME=\"setisodate\" \
+        ${libiso8601} ${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS}"
 
     echo "Building application ${setisodate}..."
 
@@ -39,5 +40,4 @@ then
 
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/setisodate/build.install-app

@@ -8,5 +8,4 @@ echo "Installing binaries into '${SBINDIR}'"
 install_file "${setisodate}" "${SBINDIR}" 0755 || return 1
 print_success "Done"
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/setisodate/build.monolithic

@@ -14,5 +14,4 @@ then
     MONOLITHIC_DOC="${MONOLITHIC_DOC} ${SRC}"
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/tests/build.default

@@ -1,3 +1 @@
 source src/tests/build.tests
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
-# vim: syntax=sh:expandtab:ts=4:sw=4

src/tests/build.tests

@@ -7,14 +7,14 @@ build_target libiso8601 || return 1
 if [ -z ${tests_BUILT} ]
 then
     LIBS="${libiso8601} ${libiso8601_DEP_CFLAGS} ${libiso8601_DEP_LIBS} "
-    EXTRAS="-D_GNU_SOURCE"
+    EXTRAS="-lm"
 
     echo "Building test programs..."
     do_cmd mkdir -p obj/tests || return 1
 
     for SRC in src/tests/*.c
     do
-        TEST="obj/tests/$(basename ${SRC} | sed -e 's,.c$,,')"
+        TEST="obj/tests/$(basename "${SRC}" ".c")"
         MODIFIED=0
         for file in ${LIBS} ${SRC} src/tests/build.tests
         do
@@ -25,14 +25,9 @@ then
             fi
         done
 
-        case "${TEST}" in
-        obj/tests/manip) TEST_EXTRAS="-lm" ;;
-        *) TEST_EXTRAS="" ;;
-        esac
-
         if [ ${MODIFIED} -ne 0 ]
         then
-            do_cmd ${CC} -Iobj ${CFLAGS} -o ${TEST} ${SRC} ${LIBS} ${EXTRAS} ${TEST_EXTRAS} || return 1
+            do_cmd ${CC} -Iobj ${CFLAGS} -o ${TEST} ${SRC} ${LIBS} ${EXTRAS} || return 1
             print_success "Built ${TEST}"
         else
             print_success "${TEST} is up to date"
@@ -44,5 +39,4 @@ then
     tests_BUILT=1
 fi
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: syntax=sh:expandtab:ts=4:sw=4

src/tests/manip.c

@@ -92,13 +92,26 @@ void date_stack_push_elapsed(const struct iso8601_elapsed* per)
 
 
 
+/* date_stack_pop()
+ *  Pops an element from the date stack.
+ */
+void date_stack_pop(void)
+{
+    struct date_stack* next;
+
+    --date_stack_size;
+    next = date_stack_top->next;
+    free(date_stack_top);
+    date_stack_top = next;
+}
+
+
+
 /* date_stack_pop_date()
  *  Pops a date from the stack, returning non-0 on error (underflow or type mismatch).
  */
 int date_stack_pop_date(struct iso8601_date* d, struct iso8601_details* det)
 {
-    struct date_stack* next;
-
     if(!date_stack_top) {
         fputs("Stack underflow.\n", stderr);
         return -1;
@@ -110,11 +123,7 @@ int date_stack_pop_date(struct iso8601_date* d, struct iso8601_details* det)
 
     *d = date_stack_top->u.date.d;
     *det = date_stack_top->u.date.det;
-
-    --date_stack_size;
-    next = date_stack_top->next;
-    free(date_stack_top);
-    date_stack_top = next;
+    date_stack_pop();
 
     return 0;
 }
@@ -126,8 +135,6 @@ int date_stack_pop_date(struct iso8601_date* d, struct iso8601_details* det)
  */
 int date_stack_pop_elapsed(struct iso8601_elapsed* per)
 {
-    struct date_stack* next;
-
     if(!date_stack_top) {
         fputs("Stack underflow.\n", stderr);
         return -1;
@@ -138,17 +145,40 @@ int date_stack_pop_elapsed(struct iso8601_elapsed* per)
     }
 
     *per = date_stack_top->u.per;
-
-    --date_stack_size;
-    next = date_stack_top->next;
-    free(date_stack_top);
-    date_stack_top = next;
+    date_stack_pop();
 
     return 0;
 }
 
 
 
+/* date_stack_dump()
+ *  Dumps and clears the contents of the date stack.
+ */
+void date_stack_dump(void)
+{
+    while(date_stack_top) {
+        switch(date_stack_top->type) {
+        case date_stack_type_date:
+            fprintf(stderr, "Date (day=%d, sec=%d, nsec=%d)\n",
+                date_stack_top->u.date.d.day, date_stack_top->u.date.d.sec, date_stack_top->u.date.d.nsec);
+            break;
+            
+        case date_stack_type_per:
+            fprintf(stderr, "Period (sec=%d, nsec=%d)\n",
+                date_stack_top->u.per.sec, date_stack_top->u.per.nsec);
+            break;
+
+        default:
+            fprintf(stderr, "Unknown type %d.\n", date_stack_top->type);
+            break;
+        }
+        date_stack_pop();
+    }
+}
+
+
+
 /* usage()
  *  Displays help.
  */
@@ -159,11 +189,14 @@ void usage(void)
         "Operators:\n"
         "   +   (date, period)      Advance date by elapsed time, push date.\n"
         "   -   (date, period)      Regress date by elapsed time, push date.\n"
+        "   +*  (date, period, num) Advance date by elapsed time multiplied by num, push date.\n"
+        "   -*  (date, period, num) Regress date by elapsed time multiplied by num, push date.\n"
         "   dp  (date, date)        Compute difference, print elapsed time.\n"
         "   <   (date, date)        Prints 1 if first date less than second.\n"
         "   <=  (date, date)        Prints 1 if first date less than or equal to second.\n"
         "   ==  (date, date)        Prints 1 if dates equal.\n"
         "   p   (date)              Prints a date.\n"
+        "   ds                      Dump stack.\n"
         "\n"
         "Type help for this screen at any point.\n"
     "\n", stdout);
@@ -175,7 +208,7 @@ int parse_command(char* cmd)
 {
     struct iso8601_date date, date2;
     struct iso8601_details details, details2;
-    struct iso8601_elapsed period;
+    struct iso8601_elapsed period, num;
     double period_d;
     char date_str[40];
     int ret = 0, sign;
@@ -209,6 +242,27 @@ int parse_command(char* cmd)
 
             }
 
+        } else if(!strcmp(cmd, "+*") || !strcmp(cmd, "-*")) {
+            if(date_stack_pop_elapsed(&num)) {
+                ret = 1;
+
+            } else if(num.nsec) {
+                ret = 1;
+                fputs("Number cannot be fractional.\n", stderr);
+
+            } else {
+
+                if(date_stack_pop_elapsed(&period) || date_stack_pop_date(&date, &details)) {
+                    ret = 1;
+
+                } else {
+                    iso8601_add_multiple(&date, &period, ((cmd[0] == '-') ? -1 : 1) * num.sec);
+                    date_stack_push_date(&date, &details);
+
+                }
+
+            }
+
         } else if(!strcmp(cmd, "dp")) {
             if(date_stack_pop_date(&date, &details) || date_stack_pop_date(&date2, &details2)) {
                 ret = 1;
@@ -259,6 +313,9 @@ int parse_command(char* cmd)
                 putc('\n', stdout);
             }
 
+        } else if(!strcmp(cmd, "ds")) {
+            date_stack_dump();
+
         } else {
             fputs("Unrecognised command or argument.\n", stderr);
             ret = 1;

src/tests/printer.c

@@ -204,7 +204,7 @@ int main(int argc, char* argv[])
     int ret = 0;
     struct iso8601_date dt;
     struct iso8601_details details, details2;
-    char buf[100], buf2[100];
+    char buf[40], buf2[40];
     const struct test* test;
 
     if(argc == 2 && !strcmp(argv[1], "--print-summary")) {
@@ -215,7 +215,11 @@ int main(int argc, char* argv[])
     iso8601_now(&dt, &details);
     printf("%-30s  %-30s  %s\n", "Name", "Basic format", "Extended format");
     for(test = tests; test->desc; ++test) {
+        memset(buf, 'X', sizeof(buf));
+        memset(buf2, 'X', sizeof(buf2)); /* test null-termination */
+
         test->do_details(&details2, &details);
+
         iso8601_print(buf, sizeof(buf), &dt, &details2);
         ++details2.extended;
         iso8601_print(buf2, sizeof(buf2), &dt, &details2);

src/tests/template

@@ -1,9 +1,9 @@
-/* libiso8601/src/tests/???.c
+/* libiso8601/src/tests/xxx.c
  *
- *  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
- *  Released under the GNU GPLv3. See file COPYING or
- *  http://www.gnu.org/copyleft/gpl.html for details.
-*/
+ *  Copyright: ©2007–2011, Güralp Systems Ltd.
+ *  Author: Laurence Withers <lwithers@guralp.com>
+ *  License: GPLv3
+ */
 
 #include "iso8601.h"
 
@@ -12,12 +12,13 @@
 
 
 
-int main(int argc, char* argv[])
+int
+main(int argc, char* argv[])
 {
     int ret = 0;
 
     if(argc == 2 && !strcmp(argv[1], "--print-summary")) {
-        printf("One line summary.\n");
+        fputs("One line summary.\n", stdout);
         return 0;
     }
 
@@ -30,7 +31,8 @@ int main(int argc, char* argv[])
     return ret;
 }
 
+
+
 /* options for text editors
-kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 vim: expandtab:ts=4:sw=4
 */

version

@@ -1,8 +1,8 @@
 # libiso8601/version
 # 
-#  (c)2007, Laurence Withers, <l@lwithers.me.uk>.
-#  Released under the GNU GPLv3. See file COPYING or
-#  http://www.gnu.org/copyleft/gpl.html for details.
+#  Copyright: ©2007–2011, Güralp Systems Ltd.
+#  Author: Laurence Withers <lwithers@guralp.com>
+#  License: GPLv3
 #
 
 
@@ -11,7 +11,6 @@
 # expected to be in 'major.minor.micro' format.
 VERMAJOR=0
 VERMINOR=3
-VERMICRO=1
+VERMICRO=15
 
-# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
 # vim: expandtab:ts=4:sw=4:syntax=sh