From 6a491b80a228369cec75a672e330b32ccfbd689e Mon Sep 17 00:00:00 2001 From: tshiozak Date: Fri, 4 Jul 2003 06:59:52 +0000 Subject: [PATCH] add manpage for iconv(1). --- distrib/sets/lists/man/mi | 4 +- doc/TODO.i18n | 4 +- usr.bin/iconv/Makefile | 4 +- usr.bin/iconv/iconv.1 | 105 ++++++++++++++++++++++++++++++++++++++ 4 files changed, 112 insertions(+), 5 deletions(-) create mode 100644 usr.bin/iconv/iconv.1 diff --git a/distrib/sets/lists/man/mi b/distrib/sets/lists/man/mi index e956c81d4c9c..47f74b030798 100644 --- a/distrib/sets/lists/man/mi +++ b/distrib/sets/lists/man/mi @@ -1,4 +1,4 @@ -# $NetBSD: mi,v 1.588 2003/07/01 10:05:46 wiz Exp $ +# $NetBSD: mi,v 1.589 2003/07/04 06:59:53 tshiozak Exp $ ./usr/share/info/am-utils.info man-amd-info ./usr/share/info/as.info man-computil-info ./usr/share/info/awk.info man-util-info @@ -144,6 +144,7 @@ ./usr/share/man/cat1/history.0 man-util-catman ./usr/share/man/cat1/host.0 man-netutil-catman ./usr/share/man/cat1/hostname.0 man-util-catman +./usr/share/man/cat1/iconv.0 man-util-catman ./usr/share/man/cat1/id.0 man-util-catman ./usr/share/man/cat1/ident.0 man-util-catman ./usr/share/man/cat1/indent.0 man-c-catman @@ -1954,6 +1955,7 @@ ./usr/share/man/man1/history.1 man-util-man ./usr/share/man/man1/host.1 man-netutil-man ./usr/share/man/man1/hostname.1 man-util-man +./usr/share/man/man1/iconv.1 man-util-man ./usr/share/man/man1/id.1 man-util-man ./usr/share/man/man1/ident.1 man-util-man ./usr/share/man/man1/indent.1 man-c-man diff --git a/doc/TODO.i18n b/doc/TODO.i18n index 31d30c30e070..dc1c32a4380d 100644 --- a/doc/TODO.i18n +++ b/doc/TODO.i18n @@ -1,4 +1,4 @@ -# $NetBSD: TODO.i18n,v 1.2 2003/07/04 06:07:48 tshiozak Exp $ +# $NetBSD: TODO.i18n,v 1.3 2003/07/04 06:59:52 tshiozak Exp $ NetBSD I18N support status / TODO @@ -124,7 +124,7 @@ wcstoumax s user tools status spec remarks -iconv s SUSv3 +iconv sm SUSv3 localedef - SUSv3 locale sm SUSv3 diff --git a/usr.bin/iconv/Makefile b/usr.bin/iconv/Makefile index 8a2dba009776..c3b061ad425c 100644 --- a/usr.bin/iconv/Makefile +++ b/usr.bin/iconv/Makefile @@ -1,9 +1,9 @@ -# $NetBSD: Makefile,v 1.1 2003/06/27 05:21:55 tshiozak Exp $ +# $NetBSD: Makefile,v 1.2 2003/07/04 06:59:55 tshiozak Exp $ WARNS?= 2 PROG= iconv SRCS= iconv.c CPPFLAGS+= -I. -I${.CURDIR} -I${NETBSDSRCDIR}/lib/libc -MKMAN= no +MAN= iconv.1 .include diff --git a/usr.bin/iconv/iconv.1 b/usr.bin/iconv/iconv.1 new file mode 100644 index 000000000000..1e811b4a0428 --- /dev/null +++ b/usr.bin/iconv/iconv.1 @@ -0,0 +1,105 @@ +.\" $NetBSD: iconv.1,v 1.1 2003/07/04 06:59:55 tshiozak Exp $ +.\" +.\" Copyright (c)2003 Citrus Project, +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd July 4, 2003 +.Dt iconv 1 +.Os +.\" ---------------------------------------------------------------------- +.Sh NAME +.Nm iconv +.Nd codeset conversion utility +.\" ---------------------------------------------------------------------- +.Sh SYNOPSIS +.Nm +.Op Fl cs +.Fl f +.Ar from_name +.Fl t +.Ar to_name +.Op Ar file ... +.Nm +.Fl l +.\" ---------------------------------------------------------------------- +.Sh DESCRIPTION +The +.Nm +utility converts the codeset of inputs (specified by +.Ar file , +or the standard input unless it is specified) and puts the converted +texts to the standard output. +.Pp +The following options are available: +.Bl -tag -width 0123 +.It Fl c +Prevent to put any invalid characters. By default, +.Nm +puts "invalid character" specified by +.Ar to_name +codeset when it encounts a character +which is valid in +.Ar from_name +codeset but not corresponding to +.Ar to_name +codeset. +.It Fl s +Silent. By default, +.Nm +puts the number of "invalid characters" to the standard error if they exist. +This option prevents this behaviour. +.It Fl f +Specifies the source codeset name as +.Ar from_name . +.It Fl t +Specifies the destination codeset name as +.Ar to_name . +.It Fl l +Lists available codeset names. +Note that not all combinations of +.Ar from_name +and +.Ar to_name +are valid. +.El +.\" ---------------------------------------------------------------------- +.Sh EXIT STATUS +.Nm +exits with 0 on success, and with non-zero if an error occurs. +.\" ---------------------------------------------------------------------- +.Sh SEE ALSO +.Xr iconv_open 3 , +.Xr iconv_close 3 +and +.Xr iconv 3 . +.\" ---------------------------------------------------------------------- +.Sh HISTORY +.Nm +first appeared in +.Nx 2.0 . +.\" ---------------------------------------------------------------------- +.Sh STANDARDS +.Nm +conform to +.St -p1003.1-2001 .