diff options
-rw-r--r-- | share/man/man5/bsd.port.mk.5 | 48 | ||||
-rw-r--r-- | share/man/man5/elf.5 | 56 | ||||
-rw-r--r-- | share/man/man5/fbtab.5 | 4 | ||||
-rw-r--r-- | usr.sbin/afs/src/arlad/DynRootDB.5 | 2 | ||||
-rw-r--r-- | usr.sbin/afs/src/arlad/SuidCells.5 | 6 |
5 files changed, 60 insertions, 56 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, diff --git a/usr.sbin/afs/src/arlad/DynRootDB.5 b/usr.sbin/afs/src/arlad/DynRootDB.5 index f3a95aad753..9ad67404aa2 100644 --- a/usr.sbin/afs/src/arlad/DynRootDB.5 +++ b/usr.sbin/afs/src/arlad/DynRootDB.5 @@ -29,7 +29,7 @@ is started, normally when the system boots. .Pp If .Nm -doesn't exist, then all cells listed CellServDB and dynamically +doesn't exist, then all cells listed in CellServDB and dynamically found nodes appear in the afs root. .Sh FILES .Pa /etc/afs/DynRootDB diff --git a/usr.sbin/afs/src/arlad/SuidCells.5 b/usr.sbin/afs/src/arlad/SuidCells.5 index 14f02408e10..7db09b646ce 100644 --- a/usr.sbin/afs/src/arlad/SuidCells.5 +++ b/usr.sbin/afs/src/arlad/SuidCells.5 @@ -1,11 +1,11 @@ -.\" $OpenBSD: SuidCells.5,v 1.3 2002/06/07 08:00:32 hin Exp $ +.\" $OpenBSD: SuidCells.5,v 1.4 2003/01/17 17:36:04 deraadt Exp $ .\" $KTH: SuidCells.5,v 1.3 2000/09/25 07:25:59 lha Exp $ .Dd April 19, 2000 .Dt SuidCells 5 .Os Arla .Sh NAME .Nm SuidCells -.Nd lists AFS cells for which the setuid bit is honored +.Nd lists AFS cells which honor the setuid bit .Sh DESCRIPTION The setuid bit on binaries executed from AFS are ignored for the cells that are not listed in @@ -13,7 +13,7 @@ for the cells that are not listed in .Pp The .Nm -file contain a list of cells separated by newline. The cells need to +file contain a list of cells separated by newlines. The cells need to exist in CellServDB or in DNS (with AFSDB resource records). .Sh SEE ALSO .Xr CellServDB 5 , |