svn commit: r336483 - head/bin/sh

[Mateusz Piotrowski]

Author: 0mp (ports committer)
Date: Thu Jul 19 13:09:29 2018
New Revision: 336483
URL: https://svnweb.freebsd.org/changeset/base/336483

Log:
  Describe how to prevent *.core files from being created using ulimit.
  
  While here, pet mandoc.
  
  Reviewed by:	eadler (previous revision), jilles (previous revision), mat (mentor)
  Approved by:	manpages (jilles), mat (mentor)
  Differential Revision:	https://reviews.freebsd.org/D15609

Modified:
  head/bin/sh/sh.1

Modified: head/bin/sh/sh.1
==============================================================================
--- head/bin/sh/sh.1	Thu Jul 19 13:02:29 2018	(r336482)
+++ head/bin/sh/sh.1	Thu Jul 19 13:09:29 2018	(r336483)
@@ -32,7 +32,7 @@
 .\"	from: @(#)sh.1	8.6 (Berkeley) 5/4/95
 .\" $FreeBSD$
 .\"
-.Dd October 8, 2016
+.Dd July 19, 2018
 .Dt SH 1
 .Os
 .Sh NAME
@@ -69,8 +69,7 @@ is close to the
 .St -p1003.1
 specification for the shell.
 It only supports features
-designated by
-.Tn POSIX ,
+designated by POSIX,
 plus a few Berkeley extensions.
 This man page is not intended to be a tutorial nor a complete
 specification of the shell.
@@ -248,9 +247,7 @@ particularly in larger scripts.
 .It Fl f Li noglob
 Disable pathname expansion.
 .It Fl h Li trackall
-A do-nothing option for
-.Tn POSIX
-compliance.
+A do-nothing option for POSIX compliance.
 .It Fl I Li ignoreeof
 Ignore
 .Dv EOF Ap s
@@ -344,9 +341,7 @@ variable subjected to parameter expansion and arithmet
 to standard error before it is executed.
 Useful for debugging.
 .It Li nolog
-Another do-nothing option for
-.Tn POSIX
-compliance.
+Another do-nothing option for POSIX compliance.
 It only has a long name.
 .El
 .Pp
@@ -409,7 +404,7 @@ The word starting with
 .Ql #
 and the rest of the line are ignored.
 .Pp
-.Tn ASCII
+ASCII
 .Dv NUL
 characters (character code 0) are not allowed in shell input.
 .Ss Quoting
@@ -447,9 +442,7 @@ If
 .Ar c
 is a backslash, it must be doubled.
 .It \ee
-The ESC character
-.Tn ( ASCII
-0x1b)
+The ESC character (ASCII 0x1b)
 .It \ef
 Formfeed
 .It \en
@@ -745,9 +738,7 @@ passing the arguments and the environment to the progr
 If the program is not a normal executable file
 (i.e., if it does not begin with the
 .Dq "magic number"
-whose
-.Tn ASCII
-representation is
+whose ASCII representation is
 .Dq Li #! ,
 resulting in an
 .Er ENOEXEC
@@ -1064,12 +1055,17 @@ command.
 .Ss Grouping Commands Together
 Commands may be grouped by writing either
 .Pp
-.D1 Li \&( Ns Ar list Ns Li \%)
+.Sm off
+.Bd -literal -offset -ident
+.Po Ar list Pc
+.Ed
+.Sm on
 .Pp
 or
+.Bd -literal -offset -ident
+.No { Ar list ; }
+.Ed
 .Pp
-.D1 Li { Ar list Ns Li \&; }
-.Pp
 The first form executes the commands in a subshell environment.
 A subshell environment has its own copy of:
 .Bl -enum
@@ -1750,11 +1746,11 @@ and contain integer constants.
 .It Unary operators
 .Li "! ~ + -"
 .It Binary operators
-.Li "* / % + - << >> < <= > >= == != & ^ | && ||"
+.Li "* / % + - << >> < <= > >= == != & ^ | && ||"\&
 .It Assignment operators
 .Li "= += -= *= /= %= <<= >>= &= ^= |="
 .It Conditional operator
-.Li "? :"
+.Li "? :"\&
 .El
 .Pp
 The result of the expression is substituted in decimal.
@@ -1862,7 +1858,7 @@ A locale-dependent range of characters may be specifie
 A named class of characters (see
 .Xr wctype 3 )
 may be specified by surrounding the name with
-.Ql \&[:
+.Ql \&[:\&
 and
 .Ql :\&] .
 For example,
@@ -2099,9 +2095,7 @@ Backspace
 Suppress the trailing newline (this has the side-effect of truncating the
 line if it is not the last character)
 .It \ee
-The ESC character
-.Tn ( ASCII
-0x1b)
+The ESC character (ASCII 0x1b)
 .It \ef
 Formfeed
 .It \en
@@ -2301,8 +2295,7 @@ Move the specified
 .Ar job
 or the current job to the foreground.
 .It Ic getopts Ar optstring var
-The
-.Tn POSIX
+The POSIX
 .Ic getopts
 command.
 The
@@ -2415,7 +2408,7 @@ read from the standard input.
 The trailing newline
 is deleted from the line and the line is split as
 described in the section on
-.Sx White Space Splitting (Field Splitting)
+.Sx White Space Splitting (Field Splitting)\&
 above, and
 the pieces are assigned to the variables in order.
 If there are more pieces than variables, the remaining
@@ -2663,6 +2656,9 @@ They are mutually exclusive.
 The maximum size of socket buffer usage, in bytes.
 .It Fl c Ar coredumpsize
 The maximal size of core dump files, in 512-byte blocks.
+Setting
+.Ar coredumpsize
+to 0 prevents core dump files from being created.
 .It Fl d Ar datasize
 The maximal size of the data segment of a process, in kilobytes.
 .It Fl f Ar filesize