Re: bin/24001: missing man pages for mkesdb and mkcsmapper

To: gnats-admin%netbsd.org@localhost,netbsd-bugs%netbsd.org@localhost,wiz%NetBSD.org@localhost
Subject: Re: bin/24001: missing man pages for mkesdb and mkcsmapper
From: coypu%SDF.ORG@localhost
Date: Mon, 30 May 2016 17:00:02 +0000 (UTC)
The following reply was made to PR bin/24001; it has been noted by GNATS.

From: coypu%SDF.ORG@localhost
To: gnats-bugs%netbsd.org@localhost
Cc: 
Subject: Re: bin/24001: missing man pages for mkesdb and mkcsmapper
Date: Mon, 30 May 2016 16:55:43 +0000

 --IJpNTDwzlM2Ie8A6
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Woops, this might be better - we do have a debug flag, it's just not
 listed in usage().
 
 --IJpNTDwzlM2Ie8A6
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="0001-Add-man-pages-for-mkcswrapper-and-mkesdb-from-FreeBS.patch"
 
 From 2d941dd8bc010d978568b2fa83d7c64a108f4330 Mon Sep 17 00:00:00 2001
 From: coypu <coypu%sdf.org@localhost>
 Date: Mon, 30 May 2016 19:51:38 +0300
 Subject: [PATCH 1/2] Add man pages for mkcswrapper and mkesdb from FreeBSD
 
 ---
  usr.bin/mkcsmapper/mkcsmapper.1 | 88 +++++++++++++++++++++++++++++++++++++++++
  usr.bin/mkesdb/mkesdb.1         | 83 ++++++++++++++++++++++++++++++++++++++
  2 files changed, 171 insertions(+)
  create mode 100644 usr.bin/mkcsmapper/mkcsmapper.1
  create mode 100644 usr.bin/mkesdb/mkesdb.1
 
 diff --git a/usr.bin/mkcsmapper/mkcsmapper.1 b/usr.bin/mkcsmapper/mkcsmapper.1
 new file mode 100644
 index 0000000..22d8948
 --- /dev/null
 +++ b/usr.bin/mkcsmapper/mkcsmapper.1
 @@ -0,0 +1,88 @@
 +.\" Copyright (c) 2009 Gabor Kovesdan <gabor%FreeBSD.org@localhost>
 +.\" 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.
 +.\"
 +.\" Portions of this text are reprinted and reproduced in electronic form
 +.\" from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
 +.\" Portable Operating System Interface (POSIX), The Open Group Base
 +.\" Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
 +.\" Electrical and Electronics Engineers, Inc and The Open Group.  In the
 +.\" event of any discrepancy between this version and the original IEEE and
 +.\" The Open Group Standard, the original IEEE and The Open Group Standard is
 +.\" the referee document.  The original Standard can be obtained online at
 +.\"     http://www.opengroup.org/unix/online.html.
 +.\"
 +.\" $FreeBSD$
 +.\"
 +.Dd Sep 6, 2009
 +.Dt MKCSMAPPER 1
 +.Os
 +.Sh NAME
 +.Nm mkcsmapper
 +.Nd generates hashed conversion data for
 +.Xr iconv 3
 +.Sh SYNOPSIS
 +.Nm
 +.Op Fl mpd
 +.Fl o
 +.Ar outfile
 +.Ar infile
 +.Sh DESCRIPTION
 +The
 +.Nm
 +utility generates binary conversion data from plain text conversion tables
 +for the
 +.Xr iconv 3
 +library.
 +The conversion data has two components:
 +The conversion mapping between specific character encodings.
 +A pivot file, which the possible source and destination encoding
 +pairs or the set of mappings to use for a compound encoding.
 +.Pp
 +The following options are available:
 +.Bl -tag -width 0123
 +.It Fl d
 +Turns on debug mode.
 +.It Fl m
 +Generate mapping data from
 +.Ar infile .
 +.It Fl o Ar outfile
 +Put generated binary data to
 +.Ar outfile .
 +.It Fl p
 +Generate pivot data from
 +.Ar outfile .
 +.El
 +.Sh EXIT STATUS
 +.Ex -std mkcsmapper
 +.Sh SEE ALSO
 +.Xr iconv 1 ,
 +.Xr mkesdb 1 ,
 +.Xr iconv 3
 +.Sh HISTORY
 +.Nm
 +first appeared in
 +.Nx 2.0 .
 +.Sh AUTHORS
 +This manual page was written by
 +.An Gabor Kovesdan Aq Mt gabor%FreeBSD.org@localhost .
 diff --git a/usr.bin/mkesdb/mkesdb.1 b/usr.bin/mkesdb/mkesdb.1
 new file mode 100644
 index 0000000..4c9df02
 --- /dev/null
 +++ b/usr.bin/mkesdb/mkesdb.1
 @@ -0,0 +1,83 @@
 +.\" Copyright (c) 2009 Gabor Kovesdan <gabor%FreeBSD.org@localhost>
 +.\" 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.
 +.\"
 +.\" Portions of this text are reprinted and reproduced in electronic form
 +.\" from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology --
 +.\" Portable Operating System Interface (POSIX), The Open Group Base
 +.\" Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of
 +.\" Electrical and Electronics Engineers, Inc and The Open Group.  In the
 +.\" event of any discrepancy between this version and the original IEEE and
 +.\" The Open Group Standard, the original IEEE and The Open Group Standard is
 +.\" the referee document.  The original Standard can be obtained online at
 +.\"     http://www.opengroup.org/unix/online.html.
 +.\"
 +.\" $FreeBSD$
 +.\"
 +.Dd November 1, 2009
 +.Dt MKESDB 1
 +.Os
 +.Sh NAME
 +.Nm mkesdb
 +.Nd generates conversion catalog for
 +.Xr iconv 3
 +.Sh SYNOPSIS
 +.Nm
 +.Op Fl md
 +.Fl o
 +.Ar outfile
 +.Ar infile
 +.Sh DESCRIPTION
 +The
 +.Nm
 +utility generates conversion catalog for the
 +.Xr iconv 3
 +library.
 +The generated data includes a list of supported encodings
 +and their most important characteristics, like the pluggable
 +module to use
 +.Pp
 +The following options are available:
 +.Bl -tag -width 0123
 +.It Fl d
 +Turns on debug mode.
 +.It Fl m
 +Process directory catalog or alias file.
 +If not specified, the input file is treated as an encoding description.
 +.It Fl o Ar outfile
 +Put generated binary data to
 +.Ar outfile .
 +.El
 +.Sh EXIT STATUS
 +.Ex -std mkesdb
 +.Sh SEE ALSO
 +.Xr iconv 1 ,
 +.Xr mkcsmapper 1 ,
 +.Xr iconv 3
 +.Sh HISTORY
 +.Nm
 +first appeared in
 +.Nx 2.0 .
 +.Sh AUTHORS
 +This manual page was written by
 +.An Gabor Kovesdan Aq Mt gabor%FreeBSD.org@localhost .
 -- 
 2.8.2
 
 
 --IJpNTDwzlM2Ie8A6
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="0002-Add-debug-flag-to-usage-of-mkesdb.patch"
 
 From 58f89a67b2bb51424760b90d7be11a85ed9da4cb Mon Sep 17 00:00:00 2001
 From: coypu <coypu%sdf.org@localhost>
 Date: Mon, 30 May 2016 19:52:23 +0300
 Subject: [PATCH 2/2] Add debug flag to usage() of mkesdb
 
 ---
  usr.bin/mkesdb/yacc.y | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)
 
 diff --git a/usr.bin/mkesdb/yacc.y b/usr.bin/mkesdb/yacc.y
 index 3e4ff6e..449b4bd 100644
 --- a/usr.bin/mkesdb/yacc.y
 +++ b/usr.bin/mkesdb/yacc.y
 @@ -290,7 +290,7 @@ do_mkdb(FILE *in)
  __dead static void
  usage(void)
  {
 -	fprintf(stderr, "Usage: %s [-m] [-o outfile] [infile]\n",
 +	fprintf(stderr, "Usage: %s [-d] [-m] [-o outfile] [infile]\n",
  	    getprogname());
  	exit(EXIT_FAILURE);
  }
 -- 
 2.8.2
 
 
 --IJpNTDwzlM2Ie8A6--
Follow-Ups:
- Re: bin/24001: missing man pages for mkesdb and mkcsmapper
  - From: Christos Zoulas
Prev by Date: PR/50594 CVS commit: src/sys/arch/arm/samsung
Next by Date: PR/50886 CVS commit: src/usr.sbin/sysinst
Previous by Thread: Re: bin/24001: missing man pages for mkesdb and mkcsmapper
Next by Thread: Re: bin/24001: missing man pages for mkesdb and mkcsmapper
Indexes:
Home | Main Index | Thread Index | Old Index