head	1.3;
access;
symbols
	pkgsrc-2026Q3:1.3.0.106
	pkgsrc-2026Q3-base:1.3
	pkgsrc-2026Q2:1.3.0.104
	pkgsrc-2026Q2-base:1.3
	pkgsrc-2026Q1:1.3.0.102
	pkgsrc-2026Q1-base:1.3
	pkgsrc-2025Q4:1.3.0.100
	pkgsrc-2025Q4-base:1.3
	pkgsrc-2025Q3:1.3.0.98
	pkgsrc-2025Q3-base:1.3
	pkgsrc-2025Q2:1.3.0.96
	pkgsrc-2025Q2-base:1.3
	pkgsrc-2025Q1:1.3.0.94
	pkgsrc-2025Q1-base:1.3
	pkgsrc-2024Q4:1.3.0.92
	pkgsrc-2024Q4-base:1.3
	pkgsrc-2024Q3:1.3.0.90
	pkgsrc-2024Q3-base:1.3
	pkgsrc-2024Q2:1.3.0.88
	pkgsrc-2024Q2-base:1.3
	pkgsrc-2024Q1:1.3.0.86
	pkgsrc-2024Q1-base:1.3
	pkgsrc-2023Q4:1.3.0.84
	pkgsrc-2023Q4-base:1.3
	pkgsrc-2023Q3:1.3.0.82
	pkgsrc-2023Q3-base:1.3
	pkgsrc-2023Q2:1.3.0.80
	pkgsrc-2023Q2-base:1.3
	pkgsrc-2023Q1:1.3.0.78
	pkgsrc-2023Q1-base:1.3
	pkgsrc-2022Q4:1.3.0.76
	pkgsrc-2022Q4-base:1.3
	pkgsrc-2022Q3:1.3.0.74
	pkgsrc-2022Q3-base:1.3
	pkgsrc-2022Q2:1.3.0.72
	pkgsrc-2022Q2-base:1.3
	pkgsrc-2022Q1:1.3.0.70
	pkgsrc-2022Q1-base:1.3
	pkgsrc-2021Q4:1.3.0.68
	pkgsrc-2021Q4-base:1.3
	pkgsrc-2021Q3:1.3.0.66
	pkgsrc-2021Q3-base:1.3
	pkgsrc-2021Q2:1.3.0.64
	pkgsrc-2021Q2-base:1.3
	pkgsrc-2021Q1:1.3.0.62
	pkgsrc-2021Q1-base:1.3
	pkgsrc-2020Q4:1.3.0.60
	pkgsrc-2020Q4-base:1.3
	pkgsrc-2020Q3:1.3.0.58
	pkgsrc-2020Q3-base:1.3
	pkgsrc-2020Q2:1.3.0.54
	pkgsrc-2020Q2-base:1.3
	pkgsrc-2020Q1:1.3.0.34
	pkgsrc-2020Q1-base:1.3
	pkgsrc-2019Q4:1.3.0.56
	pkgsrc-2019Q4-base:1.3
	pkgsrc-2019Q3:1.3.0.52
	pkgsrc-2019Q3-base:1.3
	pkgsrc-2019Q2:1.3.0.50
	pkgsrc-2019Q2-base:1.3
	pkgsrc-2019Q1:1.3.0.48
	pkgsrc-2019Q1-base:1.3
	pkgsrc-2018Q4:1.3.0.46
	pkgsrc-2018Q4-base:1.3
	pkgsrc-2018Q3:1.3.0.44
	pkgsrc-2018Q3-base:1.3
	pkgsrc-2018Q2:1.3.0.42
	pkgsrc-2018Q2-base:1.3
	pkgsrc-2018Q1:1.3.0.40
	pkgsrc-2018Q1-base:1.3
	pkgsrc-2017Q4:1.3.0.38
	pkgsrc-2017Q4-base:1.3
	pkgsrc-2017Q3:1.3.0.36
	pkgsrc-2017Q3-base:1.3
	pkgsrc-2017Q2:1.3.0.32
	pkgsrc-2017Q2-base:1.3
	pkgsrc-2017Q1:1.3.0.30
	pkgsrc-2017Q1-base:1.3
	pkgsrc-2016Q4:1.3.0.28
	pkgsrc-2016Q4-base:1.3
	pkgsrc-2016Q3:1.3.0.26
	pkgsrc-2016Q3-base:1.3
	pkgsrc-2016Q2:1.3.0.24
	pkgsrc-2016Q2-base:1.3
	pkgsrc-2016Q1:1.3.0.22
	pkgsrc-2016Q1-base:1.3
	pkgsrc-2015Q4:1.3.0.20
	pkgsrc-2015Q4-base:1.3
	pkgsrc-2015Q3:1.3.0.18
	pkgsrc-2015Q3-base:1.3
	pkgsrc-2015Q2:1.3.0.16
	pkgsrc-2015Q2-base:1.3
	pkgsrc-2015Q1:1.3.0.14
	pkgsrc-2015Q1-base:1.3
	pkgsrc-2014Q4:1.3.0.12
	pkgsrc-2014Q4-base:1.3
	pkgsrc-2014Q3:1.3.0.10
	pkgsrc-2014Q3-base:1.3
	pkgsrc-2014Q2:1.3.0.8
	pkgsrc-2014Q2-base:1.3
	pkgsrc-2014Q1:1.3.0.6
	pkgsrc-2014Q1-base:1.3
	pkgsrc-2013Q4:1.3.0.4
	pkgsrc-2013Q4-base:1.3
	pkgsrc-2013Q3:1.3.0.2
	pkgsrc-2013Q3-base:1.3
	pkgsrc-2013Q2:1.2.0.60
	pkgsrc-2013Q2-base:1.2
	pkgsrc-2013Q1:1.2.0.58
	pkgsrc-2013Q1-base:1.2
	pkgsrc-2012Q4:1.2.0.56
	pkgsrc-2012Q4-base:1.2
	pkgsrc-2012Q3:1.2.0.54
	pkgsrc-2012Q3-base:1.2
	pkgsrc-2012Q2:1.2.0.52
	pkgsrc-2012Q2-base:1.2
	pkgsrc-2012Q1:1.2.0.50
	pkgsrc-2012Q1-base:1.2
	pkgsrc-2011Q4:1.2.0.48
	pkgsrc-2011Q4-base:1.2
	pkgsrc-2011Q3:1.2.0.46
	pkgsrc-2011Q3-base:1.2
	pkgsrc-2011Q2:1.2.0.44
	pkgsrc-2011Q2-base:1.2
	pkgsrc-2011Q1:1.2.0.42
	pkgsrc-2011Q1-base:1.2
	pkgsrc-2010Q4:1.2.0.40
	pkgsrc-2010Q4-base:1.2
	pkgsrc-2010Q3:1.2.0.38
	pkgsrc-2010Q3-base:1.2
	pkgsrc-2010Q2:1.2.0.36
	pkgsrc-2010Q2-base:1.2
	pkgsrc-2010Q1:1.2.0.34
	pkgsrc-2010Q1-base:1.2
	pkgsrc-2009Q4:1.2.0.32
	pkgsrc-2009Q4-base:1.2
	pkgsrc-2009Q3:1.2.0.30
	pkgsrc-2009Q3-base:1.2
	pkgsrc-2009Q2:1.2.0.28
	pkgsrc-2009Q2-base:1.2
	pkgsrc-2009Q1:1.2.0.26
	pkgsrc-2009Q1-base:1.2
	pkgsrc-2008Q4:1.2.0.24
	pkgsrc-2008Q4-base:1.2
	pkgsrc-2008Q3:1.2.0.22
	pkgsrc-2008Q3-base:1.2
	cube-native-xorg:1.2.0.20
	cube-native-xorg-base:1.2
	pkgsrc-2008Q2:1.2.0.18
	pkgsrc-2008Q2-base:1.2
	cwrapper-base:1.2
	cwrapper:1.2.0.16
	pkgsrc-2008Q1:1.2.0.14
	pkgsrc-2008Q1-base:1.2
	pkgsrc-2007Q4:1.2.0.12
	pkgsrc-2007Q4-base:1.2
	pkgsrc-2007Q3:1.2.0.10
	pkgsrc-2007Q3-base:1.2
	pkgsrc-2007Q2:1.2.0.8
	pkgsrc-2007Q2-base:1.2
	pkgsrc-2007Q1:1.2.0.6
	pkgsrc-2007Q1-base:1.2
	pkgsrc-2006Q4:1.2.0.4
	pkgsrc-2006Q4-base:1.2
	pkgsrc-2006Q3:1.2.0.2
	pkgsrc-2006Q3-base:1.2
	pkgsrc-2006Q2:1.1.1.1.0.12
	pkgsrc-2006Q2-base:1.1.1.1
	pkgsrc-2006Q1:1.1.1.1.0.10
	pkgsrc-2006Q1-base:1.1.1.1
	pkgsrc-2005Q4:1.1.1.1.0.8
	pkgsrc-2005Q4-base:1.1.1.1
	pkgsrc-2005Q3:1.1.1.1.0.6
	pkgsrc-2005Q3-base:1.1.1.1
	pkgsrc-2005Q2:1.1.1.1.0.4
	pkgsrc-2005Q2-base:1.1.1.1
	pkgsrc-2005Q1:1.1.1.1.0.2
	pkgsrc-2005Q1-base:1.1.1.1
	pkgsrc-base:1.1.1.1
	TNF:1.1.1;
locks; strict;
comment	@.\" @;


1.3
date	2013.07.20.21.50.53;	author wiz;	state Exp;
branches;
next	1.2;
commitid	JkeZW8O0bOxzYfYw;

1.2
date	2006.09.20.12.53.21;	author rillig;	state Exp;
branches;
next	1.1;

1.1
date	2005.01.25.13.00.46;	author jmmv;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2005.01.25.13.00.46;	author jmmv;	state Exp;
branches;
next	;


desc
@@


1.3
log
@Use Mt for email addresses.
@
text
@.\" $NetBSD: wrapper.man,v 1.2 2006/09/20 12:53:21 rillig Exp $
.\"
.\" pkg_alternatives - Generic wrappers for programs with similar interfaces
.\" Copyright (c) 2005 Julio M. Merino Vidal <jmmv@@NetBSD.org>
.\"
.\" 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. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\" 3. Neither the name of author nor the names of its contributors may
.\"    be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. 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 FOUNDATION 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 January 25, 2005
.Dt __TITLE__ __SECTION__
.Os
.Sh NAME
.Nm __WRAPPER__
.Nd generic wrapper created by the alternatives system
.Sh SYNOPSIS
.Nm
.Op arguments
.Sh DESCRIPTION
.Nm
is a generic wrapper created by the
.Xr pkg_alternatives 1
utility.
Its purpose is to execute a program that provides a similar interface
to the one expected by the more common name
.Nm .
.Pp
The program to be really run is determined from a list of alternatives.
You can check which one will be executed, as well as all available
candidates, by issuing:
.Bd -literal -offset indent
$ pkg_alternatives -w status __WRAPPERBASE__
.Ed
.Pp
Once you know which alternative is the chosen one, look at its manual page
for more information.
.Sh FILES
.Bl -tag -width XXXX
.It ~/.pkg_alternatives__PREFIX__/__WRAPPERBASE__
User-specific list of candidates.
.It __CONF_FILE__
System-wide list of candidates, automatically configured by installed
packages.
.It __DB_FILE__
System-wide list of candidates, manually configured by the administrator.
.El
.Sh SEE ALSO
.Xr pkg_alternatives 8
.Sh AUTHORS
.An Julio M. Merino Vidal Aq Mt jmmv@@NetBSD.org
@


1.2
log
@It's pkg_alternatives(8), not (1).
@
text
@d1 1
a1 1
.\" $NetBSD: wrapper.man,v 1.1.1.1 2005/01/25 13:00:46 jmmv Exp $
d70 1
a70 1
.An Julio M. Merino Vidal Aq jmmv@@NetBSD.org
@


1.1
log
@Initial revision
@
text
@d1 1
a1 1
.\" $NetBSD$
d68 1
a68 1
.Xr pkg_alternatives 1
@


1.1.1.1
log
@Initial import of pkg_alternatives, version 1.0:

pkg_alternatives is a tool to manage the alternatives system provided by
The NetBSD Packages Collection, also known as pkgsrc.  It creates, configures
and destroys generic wrappers used to run programs with similar interfaces.

No objections in tech-pkg@@.  Agreed with jlam@@, who has provided lots of
design suggestions.
@
text
@@
