X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=lib%2Fparse-duration.h;h=d9bb69d6dc7bd2eb66195e40ac60fca91103e2db;hb=a77413333408e54b8d6c4e19918098794cef4b4b;hp=fbc732ff39c0e4110713c22970831353174c3b61;hpb=6c95f03dbe22357828df688bc272f893afff4492;p=gnulib.git diff --git a/lib/parse-duration.h b/lib/parse-duration.h index fbc732ff3..d9bb69d6d 100644 --- a/lib/parse-duration.h +++ b/lib/parse-duration.h @@ -1,5 +1,5 @@ /* Parse a time duration and return a seconds count - Copyright (C) 2008 Free Software Foundation, Inc. + Copyright (C) 2008-2013 Free Software Foundation, Inc. Written by Bruce Korb , 2008. This program is free software: you can redistribute it and/or modify @@ -28,10 +28,12 @@ ==== if it is a digit - the string may contain: NNN d NNN h NNN m NNN s - This represents NNN days, NNN hours, NNN minutes and NNN seconds. - The embeded white space is optional. + the string may contain: NNN Y NNN M NNN W NNN d NNN h NNN m NNN s + This represents NNN years, NNN months, NNN weeks, NNN days, NNN hours, + NNN minutes and NNN seconds. + The embedded white space is optional. These terms must appear in this order. + Case is significant: 'M' is months and 'm' is minutes. The final "s" is optional. All of the terms ("NNN" plus designator) are optional. Minutes and seconds may optionally be represented as NNN:NNN. @@ -83,6 +85,6 @@ /* Parses the given string. If it has the syntax of a valid duration, this duration is returned. Otherwise, the return value is BAD_TIME, and errno is set to either EINVAL (bad syntax) or ERANGE (out of range). */ -extern time_t parse_duration(char const * in_pz); +extern time_t parse_duration (char const * in_pz); #endif /* GNULIB_PARSE_DURATION_H */