Emacs для начинающих

   Регуляторы давления газа |     

Manual-e


  

rusconv v.3.11 manual

  Description.

   Rusconv is intended for converting text between russian encodings: alternative (for DOS, codepage 866), KOI-8 (for UNIX), Macintosh, Windows (codepage 1251) and latinica (russian text spelled latin letters). Rusconv also can convert from DOS/windows text file format to UNIX one and back. Files can be converted to several encodings simultaneously, any number of files can be converted simultaneously. Designed for use from command line and from command scripts. Windows version supports long file names and local network files.

  Synopsys.

  • rusconv (-h|--help)
  • rusconv [options] -(alt|koi|mac|win) +(alt|koi|mac|lat|win) [--] <file_list> [output_dir]
  • rusconv [options] -(cr2crlf|crlf2cr) [--] <file_list> [output_dir]
  • rusconv [options] -(dos2unix|win2unix|unix2dos|unix2win|d2u|w2u|u2d|u2w) [--] <file_list> [output_dir]
  • 1. rusconv (-h|--help)

      Prints help.



    2. rusconv [options] -(alt|koi|mac|win) +(alt|koi|mac|lat|win) [--] <file_list> [output_dir]

      Program converts content of files in <file_list>

    from encoding -xxx to encoding +xxx. Results are placed in files with the same names but with another extensions. Files are created in directory [output_dir], or in current one if output directory is not specified.

      You should specify one and only one encoding from which to convert:

    flag encoding

    -alt - alternative (DOS) -koi - KOI-8 (UNIX) -mac - Macintosh -win - Windows

      You can specify several encodings to convert to:

    flag encoding

    +alt - alternative (DOS) +koi - KOI-8 (UNIX) +lat - latinica +mac - Macintosh +win - Windows

      Default extensions are:

    extension for encoding

    .alt - alternative (DOS) .koi - KOI-8 (UNIX) .lat - latinica .mac - Macintosh .win - Windows

      To specify you own extensions for files with convert results use commands:

    extension for files contained text in encoding


    -aext extension - alternative (DOS) -kext extension - KOI-8 (UNIX) -lext extension - latinica -mext extension - Macintosh -wext extension - Windows

       When converting to only one encoding you can use command

    -ext extension

      Depending on encoding to which you convert it is interpreted as one of command '-aext extension', '-kext extension', '-lext extension', '-mext extension' or '-wext extension'.

      Flag '-o' is used for overwriting. Instead of creating new files rusconv changes content of existing files.

      Rusconv also can convert from DOS/windows text file format to UNIX one and back. In DOS and windows end of line is coded by two chars, in UNIX - by one char. For converting from one format to another use flags

    -cr2crlf - from UNIX text file format to DOS/windows one -crlf2cr - from DOS/windows text file format to UNIX one

      DOS and windows versions are verbose by default. UNIX version prints only warnings and error messages. To redefine default mode use flags

    '-s' - silent work, no any message will be printed '-v' - verbose work, all messages will be printed

      Windows operating system runs rusconv in separate window which should be closed after program finished. To avoid this and to let user to see report rusconv after all files converted waits for key pressed. Behavior can be changed by flags

    '-close' - to finish after all files converted '-noclose' - do not close window with report, by default

      Flags '-close' and '-noclose' are used only in windows version. DOS and UNIX versions ignore them.

      Symbols '--' stands for 'end of flag'. All after this symbols is a file list.

    3. rusconv [options] -(cr2crlf|crlf2cr) [--] <file_list> [output_dir]

      In this case rusconv converts only type of lines and doesn't convert from one encoding to another. In DOS and windows end of line coded by two chars, in UNIX - by one char.

    -cr2crlf - from UNIX text file format to DOS/windows one -crlf2cr - from DOS/windows text file format to UNIX one



      Default extensions for files are:

    extension text file format

    .cr - UNIX type .crlf - DOS/windows type .crl - DOS/windows type (used in DOS version)

       To specify you own extension use command

    -ext extension

      Other flags are used as in section '2'.

    4. rusconv [options] -(dos2unix|win2unix|unix2dos|unix2win|d2u|w2u|u2d|u2w) [--] <file_list> [output_dir]

      For most often tasks - converting general russian text from DOS to UNIX, from Windows to UNIX and back - it is enough only one flag:

    -dos2unix (or -d2u) - from DOS to UNIX -win2unix (or -w2u) - from Windows to UNIX -unix2dos (or -u2d) - from UNIX to DOS -unix2win (or -u2w) - from UNIX to Windows

      This flags are abbreviations. During command line parsing they are replaced by:

    -dos2unix (or -d2u) by '-alt +koi -crlf2cr'

    -win2unix (or -w2u) by '-win +koi -crlf2cr'

    -unix2dos (or -u2d) by '-koi +alt -cr2crlf'

    -unix2win (or -u2w) by '-koi +win -cr2crlf'



      Examples.



      1. Example for windows.

      Files file1.txt and file2.txt are converted from encoding KOI-8 to all other encodings. Results are placed in files file1.alt, file1.koi, file1.lat, file1.mac, file1.win, file2.alt, file2.koi, file2.lat, file2.mac, file2.win in directory e:\txt.

    E:\EX>rusconv -koi +alt +koi +win +mac +lat file1.txt file2.txt e:\txt\ ** rusconv -- convertor of Russian codepages, v.3.11. ** (c)w_re -- Oleg A. Paraschenko http://beta.math.spbu.ru/~prof/w_re/ .\file1.txt -> e:\txt\file1.alt, e:\txt\file1.koi, e:\txt\file1.mac, e:\txt\file1.lat, e:\txt\file1.win: ok. .\file2.txt -> e:\txt\file2.alt, e:\txt\file2.koi, e:\txt\file2.mac, e:\txt\file2.lat, e:\txt\file2.win: ok. 2 file(s) converted.

      2. Example for windows.

      Type of lines of text network files \\server\d\files\*.txt is converted from UNIX format to DOS/windows format.

    E:\EX>rusconv -cr2crlf -o \\server\d\files\*.txt ** rusconv -- convertor of Russian codepages, v.3.11. ** (c)w_re -- Oleg A. Paraschenko http://beta.math.spbu.ru/~prof/w_re/ \\server\d\files\EC-1845.TXT -> \\server\d\files\rcB180.TMP -> \\server\d\files\EC-1845.TXT: ok. \\server\d\files\HUMOR_PR.TXT -> \\server\d\files\rcB181.TMP -> \\server\d\files\HUMOR_PR.TXT: ok. \\server\d\files\NON_PAS.TXT -> \\server\d\files\rcB183.TMP -> \\server\d\files\NON_PAS.TXT: ok. 3 file(s) converted.

      3. Example for UNIX.

      Content of .html-files in directory win/

    is converted from windows style of russian text to UNIX style. Results are placed in files with the same name in directory koi/.

    rusconv -v -win2unix -ext html win/*.html koi/ ** rusconv -- convertor of Russian codepages, v.3.11. ** (c)w_re -- Oleg A. Paraschenko http://beta.math.spbu.ru/~prof/w_re/ win/faq.html -> koi/faq.html: ok. win/feedback.html -> koi/feedback.html: ok. win/index.html -> koi/index.html: ok. 3 file(s) converted.



      Return code.



      Number of converted files.

    manual-e.html

    Document created by Oleg A. Paraschenko

    Last changes - 15 November 1998


    Содержание раздела