Changeset 13907 in project


Ignore:
Timestamp:
03/24/09 22:46:51 (11 years ago)
Author:
Kon Lovett
Message:

Release.

Location:
release/3/srfi-19
Files:
4 edited
2 copied

Legend:

Unmodified
Added
Removed
  • release/3/srfi-19/tags/2.8.0/srfi-19-eggdoc.scm

    r12808 r13907  
    9090
    9191          (p "Where the SRFI-19 document states a " (i "tz-offset") " argument a "
    92           "timezone-locale object is also legal.")
     92          "timezone-components object is also legal.")
    9393
    9494          (p "The " (code "string->date") " procedure allows the "
     
    9999          (procedure "(make-date NANOSECOND SECOND MINUTE HOUR DAY MONTH YEAR ZONE-OFFSET [TZ-NAME #f] [DST-FLAG #f])"
    100100            (p "Same as SRFI-19 except for the optional parameters and allowing a "
    101             "timezone-locale object for the " (tt "ZONE-OFFSET") ".") )
     101            "timezone-components object for the " (tt "ZONE-OFFSET") ".") )
    102102
    103103          (procedure "(read-leap-second-table FILENAME)"
     
    140140            "into a date object. The " (tt "TIMEZONE-INFO") " is " (code "#t") " for the "
    141141            "local timezone, " (code "#f") " for the utc timezone, or a "
    142             "timezone-locale object.")
     142            "timezone-components object.")
    143143
    144144            (p (tt "SECONDS") " is relative to 00:00:00 January 1, 1970 UTC.") )
     
    305305          (p "Remember that SRFI-19 timezone offset follows ISO 8601.")
    306306
    307           (procedure "(make-timezone-locale DST-FLAG TZ-COMPONENTS)"
    308             (p "Returns a timezone-locale object.")
    309 
    310             (p "A " (tt "TZ-COMPONENTS") " object is as described by the "
    311             (url "locale.html" "locale egg") ".") )
    312 
    313           (procedure "(timezone-locale? OBJ)"
    314             (p "Is the " (tt "OBJ") " a timezone-locale object?") )
    315 
    316           (parameter "(local-timezone-locale [TZ-LOCALE])"
     307          (parameter "(local-timezone-locale [TZ-COMPONENTS])"
    317308            (p "Gets or sets the local timezone-locale object.") )
    318309
    319           (parameter "(utc-timezone-locale [TZ-LOCALE])"
     310          (parameter "(utc-timezone-locale [TZ-COMPONENTS])"
    320311            (p "Gets or sets the utc timezone-locale object.")
    321312
    322313            (p "Probably not a good idea to change the value.") )
    323314
    324           (procedure "(timezone-locale-name [TZ-LOCALE])"
    325             (p "Returns the timezone-locale name of the supplied " (tt "TZ-LOCALE") ", or the "
     315          (procedure "(timezone-locale-name [TZ-COMPONENTS])"
     316            (p "Returns the timezone-locale name of the supplied " (tt "TZ-COMPONENTS") ", or the "
    326317            (code "(local-timezone-locale)") " if missing.") )
    327318
    328           (procedure "(timezone-locale-offset [TZ-LOCALE])"
    329             (p "Returns the timezone-locale offset of the supplied " (tt "TZ-LOCALE") ", or the "
     319          (procedure "(timezone-locale-offset [TZ-COMPONENTS])"
     320            (p "Returns the timezone-locale offset of the supplied " (tt "TZ-COMPONENTS") ", or the "
    330321            (code "(local-timezone-locale)") " if missing.") )
    331322
    332           (procedure "(timezone-locale-dst? [TZ-LOCALE])"
     323          (procedure "(timezone-locale-dst? [TZ-COMPONENTS])"
    333324            (p "Returns the timezone-locale daylight saving time flag of the supplied "
    334             (tt "TZ-LOCALE") ", or the " (code "(local-timezone-locale)") " if missing.") )
     325            (tt "TZ-COMPONENTS") ", or the " (code "(local-timezone-locale)") " if missing.") )
     326
     327          (subsubsubsection "Deprecated"
     328   
     329            (procedure "(make-timezone-locale DST-FLAG TZ-COMPONENTS)"
     330              (p "Returns a timezone-locale object.")
     331 
     332              (p "A " (tt "TZ-COMPONENTS") " object is as described by the "
     333              (url "locale.html" "locale egg") ".") )
     334 
     335            (procedure "(timezone-locale? OBJ)"
     336              (p "Is the " (tt "OBJ") " a timezone-locale object?") )
     337          )
    335338        )
    336339      )
  • release/3/srfi-19/tags/2.8.0/srfi-19.html

    r13899 r13907  
    177177<p>The <b>nanosecond</b> time object element is an integer between 0 and 999,999,999 inclusive. (The SRFI-19 document mis-states the value.)</p>
    178178<p>A <i>tz-offset</i> value follows ISO 8601; positive for <em>east</em> of UTC, and negative for <em>west</em>. This is the <em>opposite</em> of the POSIX TZ environment variable.</p>
    179 <p>Where the SRFI-19 document states a <i>tz-offset</i> argument a timezone-locale object is also legal.</p>
     179<p>Where the SRFI-19 document states a <i>tz-offset</i> argument a timezone-components object is also legal.</p>
    180180<p>The <code>string-&gt;date</code> procedure allows the template-name argument to be optional. When missing the locale's date-time-format string is used. The supplied locale bundle's strings are invertible.</p>
    181181<dt class="definition"><strong>procedure:</strong> (make-date NANOSECOND SECOND MINUTE HOUR DAY MONTH YEAR ZONE-OFFSET [TZ-NAME #f] [DST-FLAG #f])</dt>
    182182<dd>
    183 <p>Same as SRFI-19 except for the optional parameters and allowing a timezone-locale object for the <tt>ZONE-OFFSET</tt>.</p></dd>
     183<p>Same as SRFI-19 except for the optional parameters and allowing a timezone-components object for the <tt>ZONE-OFFSET</tt>.</p></dd>
    184184<dt class="definition"><strong>procedure:</strong> (read-leap-second-table FILENAME)</dt>
    185185<dd>
     
    205205<dt class="definition"><strong>procedure:</strong> (seconds-&gt;date/type SECONDS [TIMEZONE-INFO #f])</dt>
    206206<dd>
    207 <p>Converts a <tt>SECONDS</tt> value, which may be fractional, into a date object. The <tt>TIMEZONE-INFO</tt> is <code>#t</code> for the local timezone, <code>#f</code> for the utc timezone, or a timezone-locale object.</p>
     207<p>Converts a <tt>SECONDS</tt> value, which may be fractional, into a date object. The <tt>TIMEZONE-INFO</tt> is <code>#t</code> for the local timezone, <code>#f</code> for the utc timezone, or a timezone-components object.</p>
    208208<p><tt>SECONDS</tt> is relative to 00:00:00 January 1, 1970 UTC.</p></dd>
    209209<dt class="definition"><strong>procedure:</strong> (time-&gt;nanoseconds TIME)</dt>
     
    338338<p><b>Note</b> that the daylight saving time (summer time) flag is <em>always</em> taken from the system, unless supplied. Any summer time rule component of a <code>timezone-components</code> object is <em>not</em> processed.</p>
    339339<p>Remember that SRFI-19 timezone offset follows ISO 8601.</p>
     340<dt class="definition"><strong>parameter:</strong> (local-timezone-locale [TZ-COMPONENTS])</dt>
     341<dd>
     342<p>Gets or sets the local timezone-locale object.</p></dd>
     343<dt class="definition"><strong>parameter:</strong> (utc-timezone-locale [TZ-COMPONENTS])</dt>
     344<dd>
     345<p>Gets or sets the utc timezone-locale object.</p>
     346<p>Probably not a good idea to change the value.</p></dd>
     347<dt class="definition"><strong>procedure:</strong> (timezone-locale-name [TZ-COMPONENTS])</dt>
     348<dd>
     349<p>Returns the timezone-locale name of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     350<dt class="definition"><strong>procedure:</strong> (timezone-locale-offset [TZ-COMPONENTS])</dt>
     351<dd>
     352<p>Returns the timezone-locale offset of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     353<dt class="definition"><strong>procedure:</strong> (timezone-locale-dst? [TZ-COMPONENTS])</dt>
     354<dd>
     355<p>Returns the timezone-locale daylight saving time flag of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     356<div class="subsubsubsection">
     357<h6>Deprecated</h6>
    340358<dt class="definition"><strong>procedure:</strong> (make-timezone-locale DST-FLAG TZ-COMPONENTS)</dt>
    341359<dd>
     
    344362<dt class="definition"><strong>procedure:</strong> (timezone-locale? OBJ)</dt>
    345363<dd>
    346 <p>Is the <tt>OBJ</tt> a timezone-locale object?</p></dd>
    347 <dt class="definition"><strong>parameter:</strong> (local-timezone-locale [TZ-LOCALE])</dt>
    348 <dd>
    349 <p>Gets or sets the local timezone-locale object.</p></dd>
    350 <dt class="definition"><strong>parameter:</strong> (utc-timezone-locale [TZ-LOCALE])</dt>
    351 <dd>
    352 <p>Gets or sets the utc timezone-locale object.</p>
    353 <p>Probably not a good idea to change the value.</p></dd>
    354 <dt class="definition"><strong>procedure:</strong> (timezone-locale-name [TZ-LOCALE])</dt>
    355 <dd>
    356 <p>Returns the timezone-locale name of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
    357 <dt class="definition"><strong>procedure:</strong> (timezone-locale-offset [TZ-LOCALE])</dt>
    358 <dd>
    359 <p>Returns the timezone-locale offset of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
    360 <dt class="definition"><strong>procedure:</strong> (timezone-locale-dst? [TZ-LOCALE])</dt>
    361 <dd>
    362 <p>Returns the timezone-locale daylight saving time flag of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd></div></div>
     364<p>Is the <tt>OBJ</tt> a timezone-locale object?</p></dd></div></div></div>
    363365<div class="subsection">
    364366<h4>Time Period</h4>
  • release/3/srfi-19/trunk/srfi-19-eggdoc.scm

    r12808 r13907  
    9090
    9191          (p "Where the SRFI-19 document states a " (i "tz-offset") " argument a "
    92           "timezone-locale object is also legal.")
     92          "timezone-components object is also legal.")
    9393
    9494          (p "The " (code "string->date") " procedure allows the "
     
    9999          (procedure "(make-date NANOSECOND SECOND MINUTE HOUR DAY MONTH YEAR ZONE-OFFSET [TZ-NAME #f] [DST-FLAG #f])"
    100100            (p "Same as SRFI-19 except for the optional parameters and allowing a "
    101             "timezone-locale object for the " (tt "ZONE-OFFSET") ".") )
     101            "timezone-components object for the " (tt "ZONE-OFFSET") ".") )
    102102
    103103          (procedure "(read-leap-second-table FILENAME)"
     
    140140            "into a date object. The " (tt "TIMEZONE-INFO") " is " (code "#t") " for the "
    141141            "local timezone, " (code "#f") " for the utc timezone, or a "
    142             "timezone-locale object.")
     142            "timezone-components object.")
    143143
    144144            (p (tt "SECONDS") " is relative to 00:00:00 January 1, 1970 UTC.") )
     
    305305          (p "Remember that SRFI-19 timezone offset follows ISO 8601.")
    306306
    307           (procedure "(make-timezone-locale DST-FLAG TZ-COMPONENTS)"
    308             (p "Returns a timezone-locale object.")
    309 
    310             (p "A " (tt "TZ-COMPONENTS") " object is as described by the "
    311             (url "locale.html" "locale egg") ".") )
    312 
    313           (procedure "(timezone-locale? OBJ)"
    314             (p "Is the " (tt "OBJ") " a timezone-locale object?") )
    315 
    316           (parameter "(local-timezone-locale [TZ-LOCALE])"
     307          (parameter "(local-timezone-locale [TZ-COMPONENTS])"
    317308            (p "Gets or sets the local timezone-locale object.") )
    318309
    319           (parameter "(utc-timezone-locale [TZ-LOCALE])"
     310          (parameter "(utc-timezone-locale [TZ-COMPONENTS])"
    320311            (p "Gets or sets the utc timezone-locale object.")
    321312
    322313            (p "Probably not a good idea to change the value.") )
    323314
    324           (procedure "(timezone-locale-name [TZ-LOCALE])"
    325             (p "Returns the timezone-locale name of the supplied " (tt "TZ-LOCALE") ", or the "
     315          (procedure "(timezone-locale-name [TZ-COMPONENTS])"
     316            (p "Returns the timezone-locale name of the supplied " (tt "TZ-COMPONENTS") ", or the "
    326317            (code "(local-timezone-locale)") " if missing.") )
    327318
    328           (procedure "(timezone-locale-offset [TZ-LOCALE])"
    329             (p "Returns the timezone-locale offset of the supplied " (tt "TZ-LOCALE") ", or the "
     319          (procedure "(timezone-locale-offset [TZ-COMPONENTS])"
     320            (p "Returns the timezone-locale offset of the supplied " (tt "TZ-COMPONENTS") ", or the "
    330321            (code "(local-timezone-locale)") " if missing.") )
    331322
    332           (procedure "(timezone-locale-dst? [TZ-LOCALE])"
     323          (procedure "(timezone-locale-dst? [TZ-COMPONENTS])"
    333324            (p "Returns the timezone-locale daylight saving time flag of the supplied "
    334             (tt "TZ-LOCALE") ", or the " (code "(local-timezone-locale)") " if missing.") )
     325            (tt "TZ-COMPONENTS") ", or the " (code "(local-timezone-locale)") " if missing.") )
     326
     327          (subsubsubsection "Deprecated"
     328   
     329            (procedure "(make-timezone-locale DST-FLAG TZ-COMPONENTS)"
     330              (p "Returns a timezone-locale object.")
     331 
     332              (p "A " (tt "TZ-COMPONENTS") " object is as described by the "
     333              (url "locale.html" "locale egg") ".") )
     334 
     335            (procedure "(timezone-locale? OBJ)"
     336              (p "Is the " (tt "OBJ") " a timezone-locale object?") )
     337          )
    335338        )
    336339      )
  • release/3/srfi-19/trunk/srfi-19.html

    r13899 r13907  
    177177<p>The <b>nanosecond</b> time object element is an integer between 0 and 999,999,999 inclusive. (The SRFI-19 document mis-states the value.)</p>
    178178<p>A <i>tz-offset</i> value follows ISO 8601; positive for <em>east</em> of UTC, and negative for <em>west</em>. This is the <em>opposite</em> of the POSIX TZ environment variable.</p>
    179 <p>Where the SRFI-19 document states a <i>tz-offset</i> argument a timezone-locale object is also legal.</p>
     179<p>Where the SRFI-19 document states a <i>tz-offset</i> argument a timezone-components object is also legal.</p>
    180180<p>The <code>string-&gt;date</code> procedure allows the template-name argument to be optional. When missing the locale's date-time-format string is used. The supplied locale bundle's strings are invertible.</p>
    181181<dt class="definition"><strong>procedure:</strong> (make-date NANOSECOND SECOND MINUTE HOUR DAY MONTH YEAR ZONE-OFFSET [TZ-NAME #f] [DST-FLAG #f])</dt>
    182182<dd>
    183 <p>Same as SRFI-19 except for the optional parameters and allowing a timezone-locale object for the <tt>ZONE-OFFSET</tt>.</p></dd>
     183<p>Same as SRFI-19 except for the optional parameters and allowing a timezone-components object for the <tt>ZONE-OFFSET</tt>.</p></dd>
    184184<dt class="definition"><strong>procedure:</strong> (read-leap-second-table FILENAME)</dt>
    185185<dd>
     
    205205<dt class="definition"><strong>procedure:</strong> (seconds-&gt;date/type SECONDS [TIMEZONE-INFO #f])</dt>
    206206<dd>
    207 <p>Converts a <tt>SECONDS</tt> value, which may be fractional, into a date object. The <tt>TIMEZONE-INFO</tt> is <code>#t</code> for the local timezone, <code>#f</code> for the utc timezone, or a timezone-locale object.</p>
     207<p>Converts a <tt>SECONDS</tt> value, which may be fractional, into a date object. The <tt>TIMEZONE-INFO</tt> is <code>#t</code> for the local timezone, <code>#f</code> for the utc timezone, or a timezone-components object.</p>
    208208<p><tt>SECONDS</tt> is relative to 00:00:00 January 1, 1970 UTC.</p></dd>
    209209<dt class="definition"><strong>procedure:</strong> (time-&gt;nanoseconds TIME)</dt>
     
    338338<p><b>Note</b> that the daylight saving time (summer time) flag is <em>always</em> taken from the system, unless supplied. Any summer time rule component of a <code>timezone-components</code> object is <em>not</em> processed.</p>
    339339<p>Remember that SRFI-19 timezone offset follows ISO 8601.</p>
     340<dt class="definition"><strong>parameter:</strong> (local-timezone-locale [TZ-COMPONENTS])</dt>
     341<dd>
     342<p>Gets or sets the local timezone-locale object.</p></dd>
     343<dt class="definition"><strong>parameter:</strong> (utc-timezone-locale [TZ-COMPONENTS])</dt>
     344<dd>
     345<p>Gets or sets the utc timezone-locale object.</p>
     346<p>Probably not a good idea to change the value.</p></dd>
     347<dt class="definition"><strong>procedure:</strong> (timezone-locale-name [TZ-COMPONENTS])</dt>
     348<dd>
     349<p>Returns the timezone-locale name of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     350<dt class="definition"><strong>procedure:</strong> (timezone-locale-offset [TZ-COMPONENTS])</dt>
     351<dd>
     352<p>Returns the timezone-locale offset of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     353<dt class="definition"><strong>procedure:</strong> (timezone-locale-dst? [TZ-COMPONENTS])</dt>
     354<dd>
     355<p>Returns the timezone-locale daylight saving time flag of the supplied <tt>TZ-COMPONENTS</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
     356<div class="subsubsubsection">
     357<h6>Deprecated</h6>
    340358<dt class="definition"><strong>procedure:</strong> (make-timezone-locale DST-FLAG TZ-COMPONENTS)</dt>
    341359<dd>
     
    344362<dt class="definition"><strong>procedure:</strong> (timezone-locale? OBJ)</dt>
    345363<dd>
    346 <p>Is the <tt>OBJ</tt> a timezone-locale object?</p></dd>
    347 <dt class="definition"><strong>parameter:</strong> (local-timezone-locale [TZ-LOCALE])</dt>
    348 <dd>
    349 <p>Gets or sets the local timezone-locale object.</p></dd>
    350 <dt class="definition"><strong>parameter:</strong> (utc-timezone-locale [TZ-LOCALE])</dt>
    351 <dd>
    352 <p>Gets or sets the utc timezone-locale object.</p>
    353 <p>Probably not a good idea to change the value.</p></dd>
    354 <dt class="definition"><strong>procedure:</strong> (timezone-locale-name [TZ-LOCALE])</dt>
    355 <dd>
    356 <p>Returns the timezone-locale name of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
    357 <dt class="definition"><strong>procedure:</strong> (timezone-locale-offset [TZ-LOCALE])</dt>
    358 <dd>
    359 <p>Returns the timezone-locale offset of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd>
    360 <dt class="definition"><strong>procedure:</strong> (timezone-locale-dst? [TZ-LOCALE])</dt>
    361 <dd>
    362 <p>Returns the timezone-locale daylight saving time flag of the supplied <tt>TZ-LOCALE</tt>, or the <code>(local-timezone-locale)</code> if missing.</p></dd></div></div>
     364<p>Is the <tt>OBJ</tt> a timezone-locale object?</p></dd></div></div></div>
    363365<div class="subsection">
    364366<h4>Time Period</h4>
Note: See TracChangeset for help on using the changeset viewer.