ldconfig(8): clean up manual page
authorEitan Adler <lists@eitanadler.com>
Sun, 7 Jan 2018 06:28:58 +0000 (22:28 -0800)
committerEitan Adler <lists@eitanadler.com>
Sun, 28 Jan 2018 00:37:54 +0000 (16:37 -0800)
- describe "-s"
- add newlines to sentence ends
- clarify file usage

Reviewed-by: swildner

sbin/ldconfig/ldconfig.8

index f913ff4..b628f98 100644 (file)
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD: src/sbin/ldconfig/ldconfig.8,v 1.19.2.10 2003/05/13 19:25:19 trhodes Exp $
 .\"
-.Dd October 3, 1993
+.Dd January 6, 2018
 .Dt LDCONFIG 8
 .Os
 .Sh NAME
@@ -48,7 +48,8 @@ utility is used to prepare a set of
 .Dq hints
 for use by the dynamic linker
 to facilitate quick lookup of shared libraries available in multiple
-directories.  It scans a set of built-in system directories and any
+directories.
+It scans a set of built-in system directories and any
 .Ar directories
 specified on the command line (in the given order) looking for
 shared libraries and stores the results in a system file to forestall
@@ -56,9 +57,13 @@ the overhead that would otherwise result from the directory search
 operations the dynamic linker would have to perform to load the
 required shared libraries.
 .Pp
-Files named on the command line are expected to contain directories
-to scan for shared libraries.  Each directory's pathname must start on a new
-line.  Blank lines and lines starting with the comment character
+Alternatively,
+.Ar files
+may be specified; these are expected to contain directories
+to scan for shared libraries.
+Each directory's pathname must start on a new
+line.
+Blank lines and lines starting with the comment character
 .Ql \&#
 are ignored.
 Filenames must conform to the
@@ -103,15 +108,18 @@ The following options are recognized by
 .It Fl elf
 Generate the hints for ELF format shared libraries.
 .It Fl R
-Rescan the previously configured directories.  This opens the previous hints
-file and fetches the directory list from the header.  Any additional pathnames
+Rescan the previously configured directories.
+This opens the previous hints
+file and fetches the directory list from the header.
+Any additional pathnames
 on the command line are also processed.
 This is the default action when no parameters are given.
 .It Fl f Ar hints_file
 Read and/or update the specified hints file, instead of the standard file.
 This option is provided primarily for testing.
 .It Fl i
-Run in insecure mode. The security checks will not be performed.
+Run in insecure mode.
+The security checks will not be performed.
 .It Fl m
 Instead of replacing the contents of the hints file
 with those found in the directories specified,
@@ -123,12 +131,11 @@ are also rescanned for new shared libraries.
 .It Fl r
 List the current contents of the hints file
 on the standard output.
-The hints file is not modified.  The list of
+The hints file is not modified.
+The list of
 directories stored in the hints file is included.
-.\".It Fl s
-.\"Do not scan the built-in system directory
-.\".Pq Dq /usr/lib
-.\"for shared libraries.
+.It Fl s
+Ignored for compatibility with other operating systems.
 .El
 .Sh SECURITY
 Special care must be taken when loading shared libraries into the address