summaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
authorTheo de Raadt <deraadt@cvs.openbsd.org>2003-01-17 17:36:05 +0000
committerTheo de Raadt <deraadt@cvs.openbsd.org>2003-01-17 17:36:05 +0000
commita913cdafc881378edd8e429886a07608f301cfc9 (patch)
tree4df80e9cec08d422c70746cebafa3c9e2d165f7d /share/man
parent676deebee93875a6226028f45b47f4959db2b91e (diff)
more; jmc@prioris.mini.pw.edu.pl
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man5/bsd.port.mk.548
-rw-r--r--share/man/man5/elf.556
-rw-r--r--share/man/man5/fbtab.54
3 files changed, 56 insertions, 52 deletions
diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 43bd3f7f11b..a1df33ee29f 100644
--- a/share/man/man5/bsd.port.mk.5
+++ b/share/man/man5/bsd.port.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.82 2003/01/14 18:19:07 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.83 2003/01/17 17:36:04 deraadt Exp $
.\"
.\" Copyright (c) 2000 Marc Espie
.\"
@@ -79,7 +79,7 @@ is set to a list of files to ignore.
Invoking
.Ar checksum
with REFETCH=true
-will try to fetch a version of with mismatched checksums off the
+will try to fetch a version without mismatched checksums off the
.Ox
main archive site.
.It Ar clean
@@ -254,7 +254,7 @@ testing, define a
.It Ar show
Invoked as show=name, show the contents of ${name}.
Mostly used from recursive makes, or to know the contents of another
-port's variables without guessing wrong.
+port's variables without guessing wrongly.
.It Ar update-plist
Update the packing lists for a port, using the fake installation and the
existing packing lists.
@@ -425,7 +425,7 @@ Many ports ignore it.
See also
.Ev COPTS .
.It Ev CHECKSUM_FILE
-Location for this port checksums, used by
+Location for this port's checksums, used by
.Ar addsum ,
.Ar checksum ,
and
@@ -433,7 +433,7 @@ and
Defaults to distinfo.
.It Ev CLEANDEPENDS
If set to
-.Sq Yes
+.Sq Yes ,
.Sq make clean
will also clean dependencies.
Note that distclean never recurses down to dependencies.
@@ -464,7 +464,7 @@ Set to name of script invoked by
target, if appropriate.
Should be relative to ${WRKSRC}.
.It Ev CONFIGURE_SHARED
-Set to --enable-shared or --disable-shared, depending whether the
+Set to --enable-shared or --disable-shared, depending on whether the
architecture supports shared libraries.
Should be appended to CONFIGURE_ARGS, for ports that build dynamic libraries
and whose configure script supports these options.
@@ -490,7 +490,7 @@ see also
.Pc .
Add
.Sq old
-if port is an older autoconf port, that does not recognize --sysconfdir.
+if port is an older autoconf port that does not recognize --sysconfdir.
Add
.Sq autoconf
if autoconf needs to be rerun first.
@@ -542,19 +542,18 @@ to refer to ports' distfiles location, as it takes an eventual
.Ev DIST_SUBDIR
into account.
.It Ev DISTFILES
-The main port distribution files (the actual software source, except
+The main port's distribution files (the actual software source, except
for binary-only ports).
Will be retrieved from the MASTER_SITES (see
.Ar fetch ) ,
checksummed and extracted (see
.Ar checksum ,
.Ar extract ) .
-normally holds a list of files, possibly with :0
.Ev DISTFILES
normally holds a list of files, possibly with
-.Sq 0
+.Sq :0
to
-.Sq 9
+.Sq :9
appended to select a different
.Ev MASTER_SITES .
See also
@@ -663,7 +662,7 @@ Location of other files related to the current ports.
Holds at least the checksum file, sometimes other files
(default: files.${ARCH} or files).
.It Ev FLAVOR
-The port current options.
+The port's current options.
Set by the user, and tested by the port to activate wanted functionalities.
.It Ev FLAVORS
List of all flavors keywords a port may match.
@@ -708,7 +707,7 @@ for more details.
.Pp
On architectures that use dynamic libraries,
.Ev LIB_DEPENDS
-is also used as a running time dependency, and recorded in the package as
+is also used as a run-time dependency, and recorded in the package as
such.
.It Ev FULLDISTDIR
Complete path to directory where ${DISTFILES} and ${PATCHFILES} will be
@@ -934,7 +933,8 @@ Default will trip ports that try to write into $HOME while building.
Path used by most shell invocations.
Don't override unless really needed.
.It Ev PORTSDIR
-Root of the ports tree (default: /usr/ports).
+Root of the ports tree (default:
+.Pa /usr/ports ) .
.It Ev PKGDIR
Location for packaging information (packing list, port description, port
short description).
@@ -942,7 +942,7 @@ Default: pkg.${ARCH} or pkg.
.It Ev PKGNAME
Name of the main created package.
Default is ${DISTNAME} for the main package,
-and ${DISTNAME} for multi-packages ports.
+and ${DISTNAME} for multi-package ports.
This does not take flavors into account.
See
.Ev FULLPKGNAME
@@ -960,11 +960,12 @@ Default is
The first cipher that matches in ${CHECKSUM_FILE} is verified.
.It Ev PREFIX
Base directory for the current port installation.
-Usually ${LOCALBASE}, though some ports may elect a location under /var,
+Usually ${LOCALBASE}, though some ports may elect a location under
+.Pa /var ,
and some multi-package ports may install under several locations.
.It Ev PSEUDO_FLAVORS
Extra list of flavors that do not register in package names, but are still
-used to control build logic, and e.g., working directories names.
+used to control build logic, and e.g., working directory names.
Its main use is for disabling part of a multi-packages build, for instance:
.Bd -literal
FLAVOR=no_gnome make package
@@ -1115,7 +1116,7 @@ Ports that need to know the WRKDIR of another port must use
cd that_port_dir && make show VARNAME=WRKDIR for this.
Note that WRKDIR may be a symbolic link.
.It Ev WRKDIST
-Subdirectory of ${WRKDIR} where the source normally unpacked.
+Subdirectory of ${WRKDIR} where the source is normally unpacked.
Base for all patches (default: ${WRKDIR}/${DISTNAME}).
Note that WRKDIST may be a symbolic link, if set to ${WRKDIR}.
.It Ev WRKSRC
@@ -1144,7 +1145,7 @@ if gnu make (${GMAKE}) is needed for correct behavior of this port.
Set to
.Sq Yes
if libtool is required for correct behavior of this port.
-Add correct dependencies, and passes LIBTOOL environment variable to
+Adds correct dependencies, and passes LIBTOOL environment variable to
scripts invocations.
.It Ev USE_MOTIF
Set to
@@ -1411,7 +1412,7 @@ for
.Ev SUBPACKAGE
-foo .
.Ev PKGNAME
-now holds the package name, not taking multi-packages nor flavors
+now holds the package name, not taking multi-packages or flavors
into account.
Most ports are not concerned by this change.
.It Ev PLIST_SUBST
@@ -1454,8 +1455,11 @@ was used.
.It Pa /usr/share/mk/bsd.port.mk
Original location of
.Nm bsd.port.mk .
-The current file lives under ${PORTSDIR}/infrastructure/mk/bsd.port.mk,
-whereas /usr/share/mk/bsd.port.mk is just a stub.
+The current file lives under
+.Pa ${PORTSDIR}/infrastructure/mk/bsd.port.mk ,
+whereas
+.Pa /usr/share/mk/bsd.port.mk
+is just a stub.
.It Pa {scripts,files,patches}.${OPSYS}
The
.Ox
diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5
index b8653171cc9..4ff5dbcc076 100644
--- a/share/man/man5/elf.5
+++ b/share/man/man5/elf.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: elf.5,v 1.1 2002/10/14 21:09:21 miod Exp $
+.\" $OpenBSD: elf.5,v 1.2 2003/01/17 17:36:04 deraadt Exp $
.\"Copyright (c) 1999 Jeroen Ruigrok van der Werven
.\"All rights reserved.
.\"
@@ -60,10 +60,10 @@ all the types and structures by their generic names
and to the macros by
.Dq ELF_xxx .
Applications written this way can be compiled on any architecture,
-regardless whether the host is 32-bit or 64-bit.
+regardless of whether the host is 32-bit or 64-bit.
.Pp
Should an application need to process ELF files of an unknown
-architecture, then the application needs to explicitely use either
+architecture, then the application needs to explicitly use either
.Dq Elf32_xxx
or
.Dq Elf64_xxx
@@ -74,10 +74,10 @@ or
.Dq ELF64_xxx .
.Pp
This header file describes the above mentioned headers as C structures
-and also include structures for dynamic sections, relocation sections and
+and also includes structures for dynamic sections, relocation sections and
symbol tables.
.Pp
-The following types are being used for 32-bit architectures:
+The following types are used for 32-bit architectures:
.Bd -literal -offset indent
Elf32_Addr Unsigned program address
Elf32_Half Unsigned halfword field
@@ -87,7 +87,7 @@ Elf32_Word Field or unsigned large integer
.\" Elf32_Size Unsigned object size
.Ed
.Pp
-And the following types are being used for 64-bit architectures:
+And the following types are used for 64-bit architectures:
.Bd -literal -offset indent
Elf64_Addr Unsigned program address
Elf64_Shalf Signed halfword field
@@ -408,11 +408,11 @@ This value specifies the lower bound of the range of reserved indexes.
.It Dv SHN_LOPROC
This value up to and including
.Sy SHN_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHN_HIPROC
This value down to and including
.Sy SHN_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHN_ABS
This value specifies absolute values for the corresponding reference.
For
@@ -423,7 +423,7 @@ have absolute values and are not affected by relocation.
Symbols defined relative to this section are common symbols, such as Fortran
COMMON or unallocated C external variables.
.It Dv SHN_HIRESERVE
-This value specifies the upper bound of the range of the range of reserved
+This value specifies the upper bound of the range of reserved
indices between
.Sy SHN_LORESERVE
and
@@ -540,16 +540,16 @@ If it is present it must precede any loadable segment entry.
.It Dv PT_LOPROC
This value up to and including
.Sy PT_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv PT_HIPROC
This value down to and including
.Sy PT_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.El
.Pp
.It Dv p_offset
This member holds the offset from the beginning of the file at which
-the first byte of the of the segment resides.
+the first byte of the segment resides.
.It Dv p_vaddr
This member holds the virtual address at which the first byte of the
segment resides in memory.
@@ -606,7 +606,7 @@ modulo
.Sy p_align .
.El
.Pp
-An file's section header table lets one locate all the file's sections.
+A file's section header table lets one locate all the file's sections.
The
section header table is an array of Elf32_Shdr or Elf64_Shdr structures.
The
@@ -634,11 +634,11 @@ This value specifies the lower bound of the range of reserved indices.
.It Dv SHN_LOPROC
This value up to and including
.Sy SHN_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHN_HIPROC
This value down to and including
.Sy SHN_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHN_ABS
This value specifies absolute values for the corresponding reference.
For
@@ -735,7 +735,7 @@ An object may have multiple
relocation sections.
.It Dv SHT_HASH
This section holds a symbol hash table.
-All object participating in
+An object participating in
dynamic linking must contain a symbol hash table.
An object file may
have only one hash table.
@@ -770,11 +770,11 @@ section.
.It Dv SHT_LOPROC
This value up to and including
.Sy SHT_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHT_HIPROC
This value down to and including
.Sy SHT_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv SHT_LOUSER
This value specifies the lower bound of the range of indices reserved for
application programs.
@@ -806,20 +806,20 @@ Undefined attributes are set to zero.
This section contains data that should be writable during process
execution.
.It Dv SHF_ALLOC
-The section occupies memory during process execution.
+This section occupies memory during process execution.
Some control
sections do not reside in the memory image of an object file.
This
attribute is off for those sections.
.It Dv SHF_EXECINSTR
-The section contains executable machine instructions.
+This section contains executable machine instructions.
.It Dv SHF_MASKPROC
All bits included in this mask are reserved for processor-specific
semantics.
.El
.Pp
.It Dv sh_addr
-If the section will appear in the memory image of a process, this member
+If this section appears in the memory image of a process, this member
holds the address at which the section's first byte should reside.
Otherwise, the member contains zero.
.It Dv sh_offset
@@ -1061,7 +1061,7 @@ This section is of type
The attribute used is
.Sy SHF_ALLOC .
.It .rodata1
-This section hold read-only data that typically contributes to a
+This section holds read-only data that typically contributes to a
non-writable segment in the process image.
This section is of type
.Sy SHT_PROGBITS .
@@ -1186,18 +1186,18 @@ symbols of the file, if it is present.
.It Dv STT_LOPROC
This value up to and including
.Sy STT_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv STT_HIPROC
This value down to and including
.Sy STT_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.El
.Pp
.Bl -tag -width "STB_GLOBAL" -compact
.It Dv STB_LOCAL
Local symbols are not visible outside the object file containing their
definition.
-Local symbols of the same name may exist in multiple file
+Local symbols of the same name may exist in multiple files
without interfering with each other.
.It Dv STB_GLOBAL
Global symbols are visible to all object files being combined.
@@ -1210,11 +1210,11 @@ precedence.
.It Dv STB_LOPROC
This value up to and including
.Sy STB_HIPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.It Dv STB_HIPROC
This value down to and including
.Sy STB_LOPROC
-are reserved for processor-specific semantics.
+is reserved for processor-specific semantics.
.Pp
There are macros for packing and unpacking the binding and type fields:
.Pp
@@ -1309,7 +1309,7 @@ applying
.Sy ELF_[32|64]_R_TYPE
or
.Sy ELF[32|64]_R_SYM ,
-respectively to the entry's
+respectively, to the entry's
.Sy r_info
member.
.It Dv r_addend
diff --git a/share/man/man5/fbtab.5 b/share/man/man5/fbtab.5
index 372f0393957..017514383f1 100644
--- a/share/man/man5/fbtab.5
+++ b/share/man/man5/fbtab.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: fbtab.5,v 1.9 2001/08/25 14:54:53 aaron Exp $
+.\" $OpenBSD: fbtab.5,v 1.10 2003/01/17 17:36:04 deraadt Exp $
.\"
.Dd August 22, 1994
.Dt FBTAB 5
@@ -46,7 +46,7 @@ file is used by
to
.Xr chown 2
the specified files to the user who has performed a login.
-As well,
+Additionally,
.Xr chmod 2
is used to set the devices to the specified permission.
When a user logs out,