From owner-freebsd-doc  Tue Mar  9 16:20:20 1999
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 8802A15070
	for <doc@FreeBSD.ORG>; Tue,  9 Mar 1999 16:20:14 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.2/8.9.2) id QAA51252;
	Tue, 9 Mar 1999 16:20:00 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
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
Reply-To: oliver.fromme@heim3.tu-clausthal.de
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/10517: Missing manpage for /usr/bin/gensetdefs (fix included!)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         10517
>Category:       docs
>Synopsis:       Missing manpage for /usr/bin/gensetdefs (fix included!)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Mar  9 16:20:00 PST 1999
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message