share/man/man1/msgcvt.1

   1 '\" te
   2 .\" Copyright (c) 2000-2007 AT&T Knowledge Ventures
   3 .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt
   4 .\" Portions Copyright (c) 2007, Sun Microsystems, Inc.
   5 .TH MSGCVT 1 "Oct 9, 2007"
   6 .SH NAME
   7 msgcvt \- convert message file to and from HTML
   8 .SH SYNOPSIS
   9 .LP
  10 .nf
  11 \fBmsgcvt\fR [\fB-hmr\fR]
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 \fBmsgcvt\fR reads a \fBgencat\fR(1) format file on the standard input and
  18 converts it to \fBHTML\fR on the standard output. The input file must contain
  19 the control statement \fB$quote "\fR and use the \fB"\fR character to quote
  20 message text. The output is in a form suitable for automatic translation by web
  21 sites such as http://babelfish.altavista.com\&.
  22 .SH OPTIONS
  23 .sp
  24 .LP
  25 The following options are supported:
  26 .sp
  27 .ne 2
  28 .na
  29 \fB\fB-h\fR\fR
  30 .ad
  31 .br
  32 .na
  33 \fB\fB--html\fR\fR
  34 .ad
  35 .RS 10n
  36 Generate \fBHTML\fR from \fBgencat\fR(1) input.
  37 .sp
  38 This is the default.
  39 .RE
  40
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-m\fR\fR
  45 .ad
  46 .br
  47 .na
  48 \fB\fB--msg\fR\fR
  49 .ad
  50 .RS 10n
  51 Generate a \fBgencat\fR(1) message file from (presumably translated)
  52 \fBHTML\fR. Wide characters are UTF-8 encoded.
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB-r\fR\fR
  59 .ad
  60 .br
  61 .na
  62 \fB\fB--raw\fR\fR
  63 .ad
  64 .RS 10n
  65 The message file is raw message text, one message per line, with no quoting or
  66 line numbering.
  67 .RE
  68
  69 .SH EXIT STATUS
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB0\fR\fR
  74 .ad
  75 .RS 6n
  76 Successful completion.
  77 .RE
  78
  79 .sp
  80 .ne 2
  81 .na
  82 \fB\fB>0\fR\fR
  83 .ad
  84 .RS 6n
  85 One or more specified jobs does not exist.
  86 .RE
  87
  88 .SH EXAMPLES
  89 .LP
  90 \fBExample 1 \fRGenerating a \fBgencat\fR Message Catalog File
  91 .sp
  92 .LP
  93 The following example generates a \fBgencat\fR(1) message catalog file from an
  94 HTML file:
  95
  96 .sp
  97 .in +2
  98 .nf
  99 example% cat example.html | msgcvt -m > examplecat
 100 .fi
 101 .in -2
 102 .sp
 103
 104 .SH AUTHORS
 105 .sp
 106 .LP
 107 Glenn Fowler, \fBgsf@research.att.com\fR
 108 .SH ATTRIBUTES
 109 .sp
 110 .LP
 111 See \fBattributes\fR(5) for descriptions of the following attributes:
 112 .sp
 113
 114 .sp
 115 .TS
 116 box;
 117 c | c
 118 l | l .
 119 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 120 _
 121 Interface Stability     Volatile
 122 .TE
 123
 124 .SH SEE ALSO
 125 .sp
 126 .LP
 127 \fBgencat\fR(1), \fBmsgcc\fR(1), \fBmsggen\fR(1), \fBattributes\fR(5)