1 .\" $Id: preconv.1,v 1.1 2011/05/26 12:01:14 kristaps Exp $
3 .\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
5 .\" Permission to use, copy, modify, and distribute this software for any
6 .\" purpose with or without fee is hereby granted, provided that the above
7 .\" copyright notice and this permission notice appear in all copies.
9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 .Dd $Mdocdate: May 26 2011 $
22 .Nd recodes multibyte UNIX manuals as mandoc input
31 utility recodes multibyte
36 Its arguments are as follows:
40 This is case-insensitive.
46 The document's encoding.
47 This is case-insensitive.
60 accepts standard input.
61 Output is written to standard output.
62 Unicode characters in the ASCII range are printed as regular ASCII
63 characters; those above this range are printed using the
68 If input bytes are improperly formed in the current encoding, they're
69 passed unmodified to standard output.
78 encodings as arguments to
83 An encoding is chosen according to the following steps:
86 From the argument passed to
89 If a BOM exists, utf\-8 encoding is selected.
91 From the argument passed to
94 If all else fails, Latin\-1 is used.
96 .\" .Sh IMPLEMENTATION NOTES
97 .\" Not used in OpenBSD.
99 .\" For sections 2, 3, & 9 only.
101 .\" For sections 1, 6, 7, & 8 only.
107 .\" For sections 1, 4, 6, 7, & 8 only.
109 .\" For sections 2, 3, & 9 only.
116 utility references the US-ASCII character set standard, ANSI_X3.4\-1968;
117 the Latin\-1 character set standard, ISO/IEC 8859\-1:1998; the UTF\-8
118 character set standard; and UCS (Unicode), ISO/IEC 10646.
122 utility first appeared in the GNU troff
124 system in December 2005, authored by Tomohiro Kubota and Werner
126 The implementation that is part of the
128 utility appeared in May 2011.
132 utility was written by
133 .An Kristaps Dzonsons Aq kristaps@bsd.lv .
136 .\" .Sh SECURITY CONSIDERATIONS
137 .\" Not used in OpenBSD.