GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CSTOCS (1)

.ds Aq ’

NAME

cstocs -- charset encoding convertor for the Czech and Slovak languages.

CONTENTS

FORMAT



        cstocs [options] src_encoding dst_encoding [files ...]



SYNOPSIS



        cstocs il2 ascii < file | less
        cstocs -i utf8 il2 file1 file2 file3
        cstocs --help



DESCRIPTION

Cstocs is a simple conversion utility to change charset encoding of a text. It reads either specified files or (if none specified) the standard input, assumes that the input is encoded in src_encoding and ties to reencode it into dst_encoding. The result is written to the standard output.

Run cstocs without parameters to get short help and list of available encodings.

Characters that are not defined in src_encoding are passed to the output unchanged.

If source text contains character, that is defined in src_encoding but not in dst_encoding, it can be handled several ways. For example, character e with caron (symbol ecaron), and d with caron (symbol dcaron) are included in the iso-8859-2 encoding, but not in the iso-8859-1. If you will do reencoding of 8859-2 text to 8859-1, you may want to do one of the following actions:
1. Keep it the same, option --nofillstring.
2. Do not produce any output instead of ecaron symbol, option --null.
3. Substitute some string (possibly a space) instead of both ecaron and dcaron, options --fillstring.
4. Substitute a letter d instead of dcaron, and e instead of ecaron. It is even possible to substitute string instead of symbol, so you can replace the AE Latin character with string AE (letter A, and letter E). Or you can replace a plusminus sign with a string +/-. These substitutions are described in the accent file.

OPTIONS

-i, -i.ext, --inplace.ext Files specified will be converted in-place, using Perl -i facility. Optionaly, an extension for backup copies may be specified after dot. This parameter <B>hasB> to be the first one, if specified.
--dir directory Encoding files are taken from directory instead of the default, which is Cz/Cstocs/enc in the Perl lib tree. The location of encoding files can also be changed using the CSTOCSDIR environment variable, but the --dir option has the highest priority.
--fillstring string If source text contains character, that is defined in the src_encoding but not in the dst_encoding nor in the accent file (or accent file is not used), it is replaced by string. The default is single space.
--nofillstring Disable changes of characters that would otherwise have fillstring applied. This is different from --null because that cancels that character out.
--null Completely equivalent to --fillstring "".
--nochange or --noaccent Do not use the accent file at all.
--onebyone Use only those rules from the accent file, which rewrite one character to one character. If this option is specified, character ecaron will be rewritten to e, but AE character will not be rewritten to AE string.
--onebymore Use all rules from accent file. This is the default option.

SEE ALSO

Cz::Cstocs(3).

AUTHOR

Jan Yenya Kasprzak has done the original Un*x implementation.

Jan Pazdziora, adelton@fi.muni.cz, created the Perl module version.

Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 CSTOCS (1) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.