From inof@hermes.rz.tu-clausthal.de Tue Mar  9 16:16:09 1999
Return-Path: <inof@hermes.rz.tu-clausthal.de>
Received: from hermes.rz.tu-clausthal.de (hermes.rz.tu-clausthal.de [139.174.3.10])
	by hub.freebsd.org (Postfix) with ESMTP id 927E11511E
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  9 Mar 1999 16:16:04 -0800 (PST)
	(envelope-from inof@hermes.rz.tu-clausthal.de)
Received: (from inof@localhost)
	by hermes.rz.tu-clausthal.de (8.9.2/8.9.2) id BAA48135;
	Wed, 10 Mar 1999 01:15:46 +0100 (CET)
	(envelope-from inof)
Message-Id: <199903100015.BAA48135@hermes.rz.tu-clausthal.de>
Date: Wed, 10 Mar 1999 01:15:46 +0100 (CET)
From: oliver.fromme@heim3.tu-clausthal.de
Sender: inof@hermes.rz.tu-clausthal.de
Reply-To: oliver.fromme@heim3.tu-clausthal.de
To: FreeBSD-gnats-submit@freebsd.org
Subject: Missing manpage for /usr/bin/gensetdefs (fix included!)
X-Send-Pr-Version: 3.2

>Number:         10517
>Category:       docs
>Synopsis:       Missing manpage for /usr/bin/gensetdefs (fix included!)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Mar  9 16:20:00 PST 1999
>Closed-Date:    Tue May 4 13:32:07 PDT 1999
>Last-Modified:  Tue May  4 13:33:00 PDT 1999
>Originator:     Oliver Fromme
>Release:        FreeBSD 3.0-STABLE i386
>Organization:
Clausthal University of Technology
>Environment:

3.1-stable, 4.0-current

>Description:

There is no manpage for /usr/bin/gensetdefs.

It would be nice to have a manpage for every tool in
/usr/bin, even for those that are unimportant for the
"normal" user, so you can at least find out what it's
good for without having to dig in some sources...

>How-To-Repeat:

man gensetdefs

>Fix:
	
The following manpage gensetdefs(8) is based on source
code comments by John D. Polstra.

.Dd March 10, 1999
.Dt GENSETDEFS 8
.Os
.Sh NAME
.Nm gensetdefs
.Nd generate linker set definitions
.Sh SYNOPSIS
.Nm gensetdefs
.Ar file ...
.Sh DESCRIPTION
The
.Nm
command is a special-purpose program to generate the
linker set definitions needed when building an ELF kernel.
Its
.Ar file
arguments are the names of ELF object files.
It scans the section names of the object files,
building a table of those that begin with
.Dv .set. ,
which represent linker sets.  Finally, for each set
.Dv foo
with 
.Dv count
elements, it writes a line 
.Fn DEFINE_SET foo count ;
to the standard output.
.Pp
This command ist used by the kernel
.Pa makefile .
.Sh FILES
.Bl -tag -width /sys/i386/conf/Makefile.i386 -compact
.It Pa /sys/i386/conf/Makefile.i386
generic makefile for the
.Tn i386
.Sh SEE ALSO
.Xr config 8
.Sh AUTHORS
The
.Nm
command was written by
.An John D. Polstra .

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ghelmer 
State-Changed-When: Tue May 4 13:32:07 PDT 1999 
State-Changed-Why:  
Page committed to CURRENT with minor modifications.  Thanks! 
>Unformatted:
