From fde455e0daa70a2ffc3935eeed5ba76d435fef62 Mon Sep 17 00:00:00 2001 From: "Steven M. Cohen" Date: Sun, 22 May 2005 18:49:46 +0000 Subject: [PATCH] Document new timestampGranularity attribute and spiff up the page generally, add links to Java code as appropriate, fix up the table column sizing which had become rather unwieldy. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@278326 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/OptionalTasks/ftp.html | 74 +++++++++++++++++++++--------- 1 file changed, 53 insertions(+), 21 deletions(-) diff --git a/docs/manual/OptionalTasks/ftp.html b/docs/manual/OptionalTasks/ftp.html index da8aa42e6..918bdcbe3 100644 --- a/docs/manual/OptionalTasks/ftp.html +++ b/docs/manual/OptionalTasks/ftp.html @@ -39,9 +39,9 @@ coming from your ftp server (ls -l on the ftp prompt).

Parameters

- - - + + + @@ -119,10 +119,30 @@ coming from your ftp server (ls -l on the ftp prompt). Since ant 1.6 + + + + + + - @@ -209,7 +229,8 @@ coming from your ftp server (ls -l on the ftp prompt). Supported values are "UNIX", "VMS", "WINDOWS", "OS/2", "OS/400", "MVS". If not specified, (or specified as "") and if no other xxxConfig attributes are specified, the autodectection mechanism - based on the FTP SYST command will be used. + based on the FTP SYST command will be used.
+ Since ant 1.7 - + - - @@ -280,7 +310,8 @@ coming from your ftp server (ls -l on the ftp prompt).
  • sl - Slovenian
    • If you require a language other than the above, see also the - shortMonthNamesConfig attribute. + shortMonthNamesConfig attribute.
    + Since ant 1.7     @@ -293,7 +324,8 @@ coming from your ftp server (ls -l on the ftp prompt). Icelandic FTP server might conceivably be specified as "jan|feb|mar|apr|maí|jún|júl|ágú|sep|okt|nóv|des". This attribute exists primarily to support languages not supported by - the serverLanguageCode attribute. + the serverLanguageCode attribute.
    + Since ant 1.7
    AttributeDescriptionRequiredAttributeDescriptionRequired
    server No
    timestampGranularitySpecify either MINUTE, NONE, + (or you may specify "" which is equivalent to not specifying a value, + useful for property-file driven scripts). Allows override of the typical situation + in PUT and GET where local filesystem timestamps are HH:mm:ss + and the typical FTP server's timestamps are HH:mm. This can throw + off uptodate calculations. However, the default values should suffice for most + applications.
    + Since ant 1.7 +     		No. Only applies in "puts" and "gets" where the + default values are MINUTE for PUT and NONE for GET. + (It is not as necessary in GET because we have the preservelastmodified option.)
    timediffmillisnumber of milliseconds to add to the time on the remote machine - to get the time on the local machine.
    +     		Deprecated. Number of milliseconds to add to the time on + the remote machine to get the time on the local machine. The timestampGranularity + attribute (for which the default values should suffice in most situations), and the + serverTimeZoneConfig option, should make this unnecessary. + serverTimeZoneConfig does the math for you and also knows about + Daylight Savings Time.
    Since ant 1.6     		NoNo, but if any of the following xxxConfig attributes is specified, UNIX will be assumed, even if "" @@ -218,25 +239,31 @@ coming from your ftp server (ls -l on the ftp prompt).
    serverTimeZoneConfigSpecify as a java.util.Timezone identifier - (e.g. GMT, America/Chicago or - Asia/Jakarta) the timezone - used by the server for timestamps. This enables Ant timestamp dependency - checking even when the server is in a different timezone than the client. - If not specified, (or specified as ""), the timezone of the - client is assumed. + Specify as a Java + + TimeZone identifier, (e.g. GMT, America/Chicago or + Asia/Jakarta) the timezone used by the server for timestamps. This + enables timestamp dependency checking even when the server is in a different + time zone from the client. Time Zones know, also, about daylight savings time, + and do not require you to calculate milliseconds of difference. If not specified, + (or specified as ""), the time zone of the client is assumed.
    + Since ant 1.7     		No
    defaultDateFormatConfigSpecify in java.text.SimpleDateFormat notation, (e.g. - yyyy-MM-dd) the date format generally used by the FTP server + Specify in Java + + SimpleDateFormat notation, (e.g. + yyyy-MM-dd), the date format generally used by the FTP server to parse dates. In some cases this will be the only date format used. In others, (unix for example) this will be used for dates - older than a year old. (See recentDateFormatConfig). If not specified, + older than a year old. (See recentDateFormatConfig). If not specified, (or specified as ""), the default date format for the system - type indicated by the systemTypeKey attribute will be used. + type indicated by the systemTypeKey attribute will be used.
    + Since ant 1.7     		No. @@ -244,11 +271,14 @@ coming from your ftp server (ls -l on the ftp prompt).
    recentDateFormatConfigSpecify in java.text.SimpleDateFormat notation, + Specify in Java + + SimpleDateFormat notation, (e.g. MMM dd hh:mm) the date format used by the FTP server to parse dates less than a year old. If not specified (or specified as ""), and if the system type indicated by the system key uses - a recent date format, its standard format will be used. + a recent date format, its standard format will be used.
    + Since ant 1.7     		No
    NoNo