summaryrefslogtreecommitdiff
path: root/support/charconv/charconv.man
blob: 717d303141fe927e599c8a7124503ce045352748 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
.TH CHARCONV 1 "13 July 1993" 
.SH NAME
charconv \- Conversion of characters between various systems
.SH SYNOPSIS
\fBcharconv\fP [-d|-m|-u] [-f \fIfrom_table\fP] [-t \fIto_table\fP]
[[-i] \fIinput_file\fP [-o] \fIoutput_file\fP]
.SH "DESCRIPTION"
CHARCONV is a program or filter that allows the transformation of
one encoding of an extended character set (e.g., ISO Latin-1) to
another. Note that the encoding of umlauts, diphthongs, or diacritics
is quite different in ISO Latin-1 (Unix, MS Windows),
MS DOS (code page 437) or Apple Macintosh. Moreover, this program
takes care of transcriptions used in TeX or HTML (hypertext markup
language). Internally, a font description similar to the TeX code
(but without math mode) is used. Tags and macros are removed from
HTML and TeX input.
.LP
Furthermore, the program allows conversion between different
end-of-line markers (Unix: LF, DOS: CRLF, Mac: CR).
.SH OPTIONS
\fBcharconv\fP [-d|-m|-u] [-f \fIfrom_table\fP] [-t \fIto_table\fP]
[[-i] \fIinput_file\fP [-o] \fIoutput_file\fP]
.LP
.IP \fB-d\fP
create MS DOS end-of-line (CRLF)
.IP \fB-m\fP
create Macintosh end-of-line (CR)
.IP \fB-u\fP
create Unix end-of-line (LF)
.IP \fB-f\fP
\fIfrom_table\fP
.IP \fB-t\fP
\fIto_table\fP
.PP
from/to character table, where from_table/to_table is one of:
.LP
.in +4m
.nf
  a - ASCII (7 bit) (*)
  c - transcription (*)
  d - DOS code page 437
  e - EBCDIC (only for ASCII <-> EBCDIC!)
  h - HTML (hypertext) (*)
  l - ISO Latin 1 (Unix, ANSI, MS Windows)
  m - Apple Macintosh
  r - RTF (Rich Text Format) (output only!)
  s - Symbol font
  t - TeX (*)
  z - Atari ST
    (*) string code
.fi
.in -4m
.LP
.SH EXAMPLES
.nf
      charconv -ft myfile.tex
         (de-texify file, using umlauts of current system)
      charconv -ft -th myfile.tex myfile.html
         (convert from TeX to HTML)
      charconv -m -fd -tm dos.txt mac_txt
         (convert from "DOS" to "Macintosh")
      cat myfile.html | charconv -fh | less -r
.fi
.SH FILES
.nf
\fI/usr/local/bin/charconv\fR  binary
\fI/usr/local/man/man1/charconv.1\fR man page
.fi
.SH BUGS
(probably)
.SH RESTRICTIONS
Note: the text is not formatted. RTF output assumes ISO Latin-1 coding,
end-of-line markers are not changed.
.SH AUTHOR
Burkhard Kirste (kirste@chemie.fu-berlin.de)