From 9cc790869ed3905c78c7eeeb0bb44f800b3f2af4 Mon Sep 17 00:00:00 2001 From: Daniel Wilhelm Date: Fri, 18 Apr 2014 17:11:09 +0200 Subject: 3.15 --- BUILD/Help/html/Features.html | 7 +- BUILD/Help/html/advanced/BackupStrategy.html | 21 +--- BUILD/Help/html/advanced/Batch Scripting.html | 75 +++++++------- BUILD/Help/html/advanced/EnvironmentVariables.html | 94 ----------------- BUILD/Help/html/advanced/ExternalApp.html | 18 ++-- BUILD/Help/html/advanced/Macros.html | 113 +++++++++++++++++++++ BUILD/Help/html/advanced/RealtimeSync.html | 12 ++- BUILD/Help/html/advanced/VariableDrive.html | 56 +++++----- 8 files changed, 210 insertions(+), 186 deletions(-) delete mode 100644 BUILD/Help/html/advanced/EnvironmentVariables.html create mode 100644 BUILD/Help/html/advanced/Macros.html (limited to 'BUILD/Help/html') diff --git a/BUILD/Help/html/Features.html b/BUILD/Help/html/Features.html index 6182e752..ac65cfc8 100644 --- a/BUILD/Help/html/Features.html +++ b/BUILD/Help/html/Features.html @@ -5,7 +5,7 @@ - + - - -

Environment -Variables

All -directory names may contain macros that are expanded during -synchronization. Begin and end of each macro is marked by a '%' -character. Besides special macros handling time and date (see "Backup -Strategies"), the operating system's environment variables can -also be used.

Example:

- C:\Backup\%USERNAME%_Config expands - to
C:\Backup\ZenJu_Config
-
- %APPDATA%\FreeFileSync expands - to
C:\Documents and - Settings\ZenJu\Application Data\FreeFileSync
-

Hint:

You can -add a great amount of flexibility to Batch Synchronization -(*.ffs_batch) by creating new temporary environment variables in a -*.bat/*.cmd file that are evaluated by FreeFileSync at runtime!

Example:

The -batch configuration file C:\SyncJob.ffs_batch -contains macro %MyVar% -instead of an absolute target directory and is invoked by a -*.cmd file:

set - MyVar=C:\Target
cd "C:\Program - files\FreeFileSync"
FreeFileSync.exe C:\SyncJob.ffs_batch - (->%MyVar% is - replaced by C:\Target during - execution)

- Note:
Temporary - environment variables created with the "set" - command are only valid if the batch job is started by calling the - executable directly! Using "start - /wait" or relying on Shell Execute creates a new - program context without these temporal variables.

- - \ No newline at end of file diff --git a/BUILD/Help/html/advanced/ExternalApp.html b/BUILD/Help/html/advanced/ExternalApp.html index 1dd05d4e..68f186c4 100644 --- a/BUILD/Help/html/advanced/ExternalApp.html +++ b/BUILD/Help/html/advanced/ExternalApp.html @@ -5,7 +5,7 @@ - + @@ -52,17 +52,21 @@ available:

Example:

Examples:

Start - associated application: cmd /c - start "" "%name"
-
Start - visual difference tool: C:\Program + visual difference tool:
C:\Program Files\WinMerge\WinMergeU.exe "%name" "%nameCo"
+
Show + file in Windows Explorer:
explorer + /select, "%name"
+
Open + file in associated application:
cmd + /c start "" "%name"
Open - Console: cmd /k cd /D "%dir"
+ console dialog:
cmd /k cd /D + "%dir"

diff --git a/BUILD/Help/html/advanced/Macros.html b/BUILD/Help/html/advanced/Macros.html new file mode 100644 index 00000000..b8126555 --- /dev/null +++ b/BUILD/Help/html/advanced/Macros.html @@ -0,0 +1,113 @@ + + + + + + + + + + + + + + + +

Macros

All +directory names may contain macros that are expanded during +synchronization. Begin and end of each macro is marked by a '%' +character. Besides special macros handling time and date, the +operating system's environment variables can also be used.

Internal +macros:

%time%    - + current time, format [hhmmss], e. g. "201340"
%weekday% - + day of the week, e. g. "Monday"
%date%    - + current date, e. g. "2010-07-13"
%week%    - + calendar week, e. g. "28"
%month%   - + current month, e. g. "July"
%year%    - + current year, e. g. "2010"

Hint:

You can +add a great amount of flexibility to Batch Synchronization +(*.ffs_batch) by creating new temporary environment variables in a +*.bat/*.cmd file that are evaluated by FreeFileSync at runtime!

Example:

+ C:\Backup\%username%_Config expands + to
C:\Backup\ZenJu_Config
+
+
+ %appdata%\FreeFileSync expands + to
C:\Documents and + Settings\ZenJu\Application Data\FreeFileSync
+

Example:

The +batch configuration file C:\SyncJob.ffs_batch +contains macro %MyVar% +instead of an absolute target directory and is invoked by a +*.cmd file:

set + MyVar=C:\Target
cd "C:\Program + files\FreeFileSync"
FreeFileSync.exe C:\SyncJob.ffs_batch + (->%MyVar% is + replaced by C:\Target during + execution)

+ Note:
Temporary + environment variables created with the "set" + command are only valid if the batch job is started by calling the + executable directly! Using "start + /wait" or relying on Shell Execute creates a new + program context without these temporal variables.

+ + \ No newline at end of file diff --git a/BUILD/Help/html/advanced/RealtimeSync.html b/BUILD/Help/html/advanced/RealtimeSync.html index 6acea5d5..7fb599e8 100644 --- a/BUILD/Help/html/advanced/RealtimeSync.html +++ b/BUILD/Help/html/advanced/RealtimeSync.html @@ -5,7 +5,7 @@ - + @@ -70,13 +70,17 @@ to begin monitoring.

The settings dialog can be skipped by passing a RealtimeSync configuration file (*.ffs_real) OR a FreeFileSync batch file (*.ffs_batch) - as first command-line argument. This allows for integration with - the operating system's auto start facility.

+ as first command-line argument to RealtimeSync.exe. This allows + for integration with the operating system's auto start facility.

Using RealtimeSync is not restricted to starting FreeFileSync. It can also be used in other scenarios, like sending an email whenever a certain directory is modified.

+ If you schedule a Windows batch + file (.bat, .cmd), see notes in Batch + Scripting.

@@ -147,7 +151,5 @@ batch file similar to this one:

\ No newline at end of file diff --git a/BUILD/Help/html/advanced/VariableDrive.html b/BUILD/Help/html/advanced/VariableDrive.html index 10e26e57..136b727f 100644 --- a/BUILD/Help/html/advanced/VariableDrive.html +++ b/BUILD/Help/html/advanced/VariableDrive.html @@ -5,7 +5,7 @@ - + @@ -23,32 +24,39 @@ sticks with variable drive letters

USB -sticks often have different volume names assigned to them when -plugged into two distinct computers. In order to handle this -flexibility FreeFileSync is able to process directory names relative -to the current working directory.

+sticks often get different volume names assigned when plugged into +distinct computers. FreeFileSync offers two solutions to handle this +issue:

Thus -the following workflow is possible:

Specify + a directory via volume name: Syntax: [<volume name>]\<path>
+
Example: + Use "[ZenJu-USB]\directory" + instead of "E:\directory" + where "ZenJu-USB" + is the name of the USB stick.
+

Use + a relative directory name:
+

Replace - the absolute USB directory name in your configuration by a relative - one:
E.g. "E:\SyncDir" - -> "\SyncDir"
-
-
Save - and copy synchronization settings to the USB stick: - "E:\settings.ffs_gui"
-
-
"Start - FreeFileSync by double-clicking on "E:\settings.ffs_gui"
=> - Working directory automatically is set to "E:\" - by the operating system so that "\SyncDir" - is interpreted as "E:\SyncDir" - during synchronization.
-

Example: + Use "\directory" + instead of "E:\directory"
+
Save + and copy synchronization settings to the USB stick: + "E:\settings.ffs_gui"
+
Start + FreeFileSync by double-clicking on "E:\settings.ffs_gui"
=> + Working directory is automatically set to "E:\" + by the operating system so that "\directory" + is resolved as "E:\directory" + during synchronization.

\ No newline at end of file -- cgit