.\" Copyright (c) 2000, 2001 Udo Erdelhoff. All rights reserved.
.\" Written for the FreeBSD German Documentation Project
.\"
.\" Redistribution and use in source and compiled 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 as the first lines of this file unmodified.
.\"
.\"  2. Redistributions in compiled 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 DOCUMENTATION IS PROVIDED BY UDO ERDELHOFF "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 UDO ERDELHOFF 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 DOCUMENTATION, EVEN IF ADVISED OF
.\" THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: sortmanent.1,v 1.6 2002/11/24 09:41:37 ue Exp $
.Dd July 22, 2000
.Dt SORTMANENT 1
.Os FreeBSD
.Sh NAME
.Nm sortmanent
.Nd sort manapge entities
.Sh SYNOPSIS
.Nm
.Sh DESCRIPTION
The entries in the "Docbook Manual Page Entities" document used by the
.Fx
Documentation Project
.Pq Qq manpage entities
are listed in an unusal way.
The entries are grouped by their manual volume and a blank line is inserted
between the groups.
The entries inside each group are sorted by name.
.Pp
.Nm
reads a list of unsorted manpage entities on its standard input.
Lines
.Em not
conforming to the format used in the
.Qq Docbook Manual Page Entities
document are sent to the standard output in the order of appearance.
All other lines are grouped and sorted
.Pq using the rules outlined above
and are sent to the standard output
.Em after
the non-conforming lines.
.Pp
.Sh DIAGNOSTICS
The
.Nm
utility always returns 0.
.Sh COMPATIBILITY
The sorting order of the entity definitions is indentical to the sorting
order used in the "Docbook Manual Page Entites" document created and used
by the
.Fx
Documentation Project.
.Sh SEE ALSO
.Xr mme 1
.Sh HISTORY
This is the first publication of the
.Nm
utility.
.Sh AUTHORS
The
.Nm
utility and this manual page were written by
.An Udo Erdelhoff Aq ue@nathan.ruhr.de
in July 2000.
.Sh BUGS
Absolutely useless outside the context of the
.Fx
Documentation Project.