TextMaestro™

14. Text Conversion In Command Line Mode

Below are the specifications and qualifiers for command line conversion.

Environment variables: (1) If you have installed TextMaestro using the installer, two environment variables, namely textmaestro and tmt are defined in your system. Therefore, using %textmaestro% or %tmt% you can launch TextMaestro from a cmd console from anywhere in your system. Here is an example:

Note, if you do not specify an argument after %textmaestro% (or %tmt%), the GUI application will be launched. If you do specify an argument after
%textmaestro%, (or %tmt%), it becomes command line driven mode and no GUI will be launched.

(2) If you have not used TextMaestro installer, you need to define an environment variable as follows: (for XP and NT 2000)

Start | My Computer | Right click | Properties.

Advanced tab | Environment Variables | New (top).

If you define the variable manually, you should restart the system.

Qualifiers: Below are the options and qualifiers.

C:\Test> %textmaestro%  -input=file or directory, [-output=file or directory,]

             [-cvt={tp, fr, kl},] [-libfile=your_library_file,] [-libind=index,]

             [-include=inc_flag,] [-exclude=exc_flag,]

Note the use comma after each qualifier. Last comma is optional.

Qualifiers inside brackets [] above are optional. What it means, you can skip them if you choose. In that case TextMaestro will pick the following defaults for you and display a warning on a second cmd window, which you need to dismiss.

Should you desire to suppress this default spec warning, simply use -default=y qualifier as shown below:

C:\Test> %textmaestro%  -input=file_name, -default=y

Note, -input=something is the only required qualifier. Instead of
-input=file_name, you may have -input=directory_name as below:

C:\Test> %textmaestro%  -input=MyInputDirectory, -output=MyOutputDirectory,

              -default=y

which means, convert all files found inside MyInputDirectory directory using above default attributes, and place the output files into MyOutputDirectory directory.

Comment 1: File and directory names for -input= and -output= may be absolute or relative.

Comment 2: If -input= is a file name, -output= must be also a file name. If -input= is a directory name,  -output= must be also a directory name. In other words, you cannot have -output=file_name when you specify -input=directory_name.

Comment 3: -include=inc_flag and -exclude=exc_flag are applicable only if
-input=directory is specified.

Comment 4: Whatever you specify for -input={a file name or a directory name}, that entity must exist. Otherwise, the conversion is aborted.

Comment 5: Do not forget comma (,) when you write the command line.

Comment 6: The result of the operation is logged in:

C:\TMT-WorkFiles\Cmd-Area\cmd_log.txt

Typical text inside this file:

***************************************************************************

       Batch conversion executed at: 01:05:49 AM,  15-Apr-2005 (Friday).

***************************************************************************

Command line: -input=myinputfiles, -default=y

---------------------------------------------------------------------------

{Default -cvt=fr chosen for conversion type.}

{Default -libfile=C:\TMT-UserInfo\LibraryInfo\_tmt_library.txt is chosen for library.}

{Default -libind=0 chosen for library index.}

{Default -include=*.* chosen for include filter.}

{Default -exclude=(empty) chosen for exclude filter.}

---------------------------------------------------------------------------

Summary: Directory mode.

---------------------------------------------------------------------------

   Inputdir:       C:\Test\myinputdirectory

   Outputdir:      C:\Test\myoutputdirectory

   CVT-ind:        1 Find and Replace (default).

   Lib-file:       C:\TMT-UserInfo\LibraryInfo\_tmt_library.txt

   Lib-ind:        0

   Files Included: *.*

   Files Excluded: (none)

---------------------------------------------------------------------------

The following files were modified:

==================================

      1. ae_comp.cpp

      2. ae_comp.h

      3. ae_sym.cpp

      4. ae_sym.h

      5. annot.cpp

      6. annot.h

      7. build_info.h

      8. bundle.cpp

      9. bundle.h

     10. bundle_ctrl.cpp

     11. bundle_ctrl.h

     12. bundle_info.cpp

     13. bundle_info.h

     14. char.cpp

     15. check.cpp

     16. check.h

--- Batch cvt over ---

Success if no error message above.

Top