Differential D17166 Diff 48068 usr.bin/localedef/localedef.1

Changeset View

Standalone View

usr.bin/localedef/localedef.1

	Show All 27 Lines
	.\" When distributing Covered Code, include this CDDL HEADER in each file and			.\" When distributing Covered Code, include this CDDL HEADER in each file and
	.\" include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable,			.\" include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable,
	.\" add the following below this CDDL HEADER, with the fields enclosed by			.\" add the following below this CDDL HEADER, with the fields enclosed by
	.\" brackets "[]" replaced with your own identifying information:			.\" brackets "[]" replaced with your own identifying information:
	.\" Portions Copyright [yyyy] [name of copyright owner]			.\" Portions Copyright [yyyy] [name of copyright owner]
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd July 28, 2015			.Dd September 15, 2018
				0mpUnsubmitted Done Inline Actions Remember to dump Dd. 0mp: Remember to dump Dd.
	.Dt LOCALEDEF 1			.Dt LOCALEDEF 1
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm localedef			.Nm localedef
	.Nd define locale environment			.Nd define locale environment
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl cDUv			.Op Fl cDUv
	▲ Show 20 Lines • Show All 81 Lines • ▼ Show 20 Lines
	.It Fl v			.It Fl v
	Emit verbose debugging output on standard output.			Emit verbose debugging output on standard output.
	.It Fl w Ar widthfile			.It Fl w Ar widthfile
	The path name of the file containing character screen width definitions.			The path name of the file containing character screen width definitions.
	If not supplied, then default screen widths will be assumed, which will			If not supplied, then default screen widths will be assumed, which will
	generally not account for East Asian encodings requiring more than a single			generally not account for East Asian encodings requiring more than a single
	character cell to display, nor for combining or accent marks that occupy			character cell to display, nor for combining or accent marks that occupy
	no additional screen width.			no additional screen width.
				.It Fl V Ar version
				Specifies a version string describing the source collation data.
				yuripvUnsubmitted Done Inline Actions New sentence, new line; use `.Xr querylocaleversion 3`. yuripv: New sentence, new line; use `.Xr querylocaleversion 3`.
				This string can be retrieved using
				.Xr querylocale 3 ,
				and is intended to allow applications to detect when the definition of a
				collation changes.
	.El			.El
	.Pp			.Pp
	The following operands are required:			The following operands are required:
	.Bl -tag -width ".Ar localename"			.Bl -tag -width ".Ar localename"
	.It Ar localename			.It Ar localename
	Identifies the locale.			Identifies the locale.
	If the name contains one or more slash characters,			If the name contains one or more slash characters,
	.Ar localename			.Ar localename
	▲ Show 20 Lines • Show All 47 Lines • ▼ Show 20 Lines
	Warnings or errors occurred and no output was created.			Warnings or errors occurred and no output was created.
	.El			.El
	.Pp			.Pp
	If an error is detected, no permanent output will be created.			If an error is detected, no permanent output will be created.
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr locale 1 ,			.Xr locale 1 ,
	.Xr iconv_open 3 ,			.Xr iconv_open 3 ,
	.Xr nl_langinfo 3 ,			.Xr nl_langinfo 3 ,
				.Xr querylocale 3 ,
				yuripvUnsubmitted Done Inline Actions Sort. yuripv: Sort.
	.Xr strftime 3 ,			.Xr strftime 3 ,
	.Xr environ 7			.Xr environ 7
	.Sh WARNINGS			.Sh WARNINGS
	If warnings occur, permanent output will be created if the			If warnings occur, permanent output will be created if the
	.Fl c			.Fl c
	option was specified.			option was specified.
	The following conditions will cause warning messages to be issued:			The following conditions will cause warning messages to be issued:
	.Bl -bullet			.Bl -bullet
	▲ Show 20 Lines • Show All 63 Lines • Show Last 20 Lines