Looking at which programs use and document globbing patterns, it seems
odd that some manuals point at glob's C API in the "Library functions"
sections instead of the list of special characters in the
"Miscellaneous information" section actual patterns are described.

Diff below adjusts pax(1), tar(1), sftp(1), ssh_config(5), tmux(1),
syslogd.conf(5) as per `man -k xr=glob'. find(1) already mentions
section 7.

Feeback?

Index: /usr/src/bin/pax/pax.1
===================================================================
RCS file: /cvs/src/bin/pax/pax.1,v
retrieving revision 1.73
diff -u -p -r1.73 pax.1
--- /usr/src/bin/pax/pax.1      26 Aug 2016 04:40:27 -0000      1.73
+++ /usr/src/bin/pax/pax.1      20 Jul 2018 11:34:49 -0000
@@ -205,7 +205,7 @@ The
 operand is used to select one or more pathnames of archive members.
 Archive members are selected using the pattern matching notation described
 by
-.Xr glob 3 .
+.Xr glob 7 .
 When the
 .Ar pattern
 operand is not supplied, all members of the archive will be selected.
Index: /usr/src/bin/pax/tar.1
===================================================================
RCS file: /cvs/src/bin/pax/tar.1,v
retrieving revision 1.60
diff -u -p -r1.60 tar.1
--- /usr/src/bin/pax/tar.1      9 Oct 2017 15:54:39 -0000       1.60
+++ /usr/src/bin/pax/tar.1      20 Jul 2018 11:55:04 -0000
@@ -94,7 +94,7 @@ command line, only those files will be l
 The
 .Ar file
 arguments may be specified as glob patterns (see
-.Xr glob 3
+.Xr glob 7
 for more information), in which case
 .Nm
 will list all archive members that match each pattern.
@@ -109,7 +109,7 @@ archive.
 The
 .Ar file
 arguments may be specified as glob patterns (see
-.Xr glob 3
+.Xr glob 7
 for more information), in which case
 .Nm
 will extract all archive members that match each pattern.
@@ -344,7 +344,7 @@ to a file called
 Verbosely create an archive, called
 .Pa backup.tar.gz ,
 of all files matching the shell
-.Xr glob 3
+.Xr glob 7
 function
 .Pa *.c :
 .Pp
Index: /usr/src/usr.bin/tmux/tmux.1
===================================================================
RCS file: /cvs/src/usr.bin/tmux/tmux.1,v
retrieving revision 1.606
diff -u -p -r1.606 tmux.1
--- /usr/src/usr.bin/tmux/tmux.1        6 Jul 2018 07:11:23 -0000       1.606
+++ /usr/src/usr.bin/tmux/tmux.1        20 Jul 2018 11:35:00 -0000
@@ -964,7 +964,7 @@ show debugging information about jobs an
 Execute commands from
 .Ar path
 (which may be a
-.Xr glob 3
+.Xr glob 7
 pattern).
 If
 .Fl q
Index: /usr/src/usr.bin/ssh/sftp.1
===================================================================
RCS file: /cvs/src/usr.bin/ssh/sftp.1,v
retrieving revision 1.116
diff -u -p -r1.116 sftp.1
--- /usr/src/usr.bin/ssh/sftp.1 9 Jun 2018 06:36:31 -0000       1.116
+++ /usr/src/usr.bin/ssh/sftp.1 20 Jul 2018 11:39:55 -0000
@@ -316,7 +316,7 @@ to
 .Ar grp .
 .Ar path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 .Ar grp
 must be a numeric GID.
@@ -327,7 +327,7 @@ to
 .Ar mode .
 .Ar path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 .It Ic chown Ar own Ar path
 Change owner of file
@@ -336,7 +336,7 @@ to
 .Ar own .
 .Ar path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 .Ar own
 must be a numeric UID.
@@ -374,7 +374,7 @@ path name is not specified, it is given 
 remote machine.
 .Ar remote-path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 If it does and
 .Ar local-path
@@ -430,7 +430,7 @@ may contain any flags supported by the l
 command.
 .Ar path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 .It Ic lmkdir Ar path
 Create local directory specified by
@@ -461,7 +461,7 @@ or the current directory if
 is not specified.
 .Ar path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 .Pp
 The following flags are recognized and alter the behaviour of
@@ -514,7 +514,7 @@ If the remote path name is not specified
 on the local machine.
 .Ar local-path
 may contain
-.Xr glob 3
+.Xr glob 7
 characters and may match multiple files.
 If it does and
 .Ar remote-path
@@ -617,7 +617,7 @@ Synonym for help.
 .Xr ssh 1 ,
 .Xr ssh-add 1 ,
 .Xr ssh-keygen 1 ,
-.Xr glob 3 ,
+.Xr glob 7 ,
 .Xr ssh_config 5 ,
 .Xr sftp-server 8 ,
 .Xr sshd 8
Index: /usr/src/usr.bin/ssh/ssh_config.5
===================================================================
RCS file: /cvs/src/usr.bin/ssh/ssh_config.5,v
retrieving revision 1.279
diff -u -p -r1.279 ssh_config.5
--- /usr/src/usr.bin/ssh/ssh_config.5   4 Jul 2018 13:49:31 -0000       1.279
+++ /usr/src/usr.bin/ssh/ssh_config.5   20 Jul 2018 11:26:06 -0000
@@ -934,7 +934,7 @@ to unknown options that appear before it
 .It Cm Include
 Include the specified configuration file(s).
 Multiple pathnames may be specified and each pathname may contain
-.Xr glob 3
+.Xr glob 7
 wildcards and, for user configurations, shell-like
 .Sq ~
 references to user home directories.
Index: /usr/src/usr.sbin/syslogd/syslog.conf.5
===================================================================
RCS file: /cvs/src/usr.sbin/syslogd/syslog.conf.5,v
retrieving revision 1.37
diff -u -p -r1.37 syslog.conf.5
--- /usr/src/usr.sbin/syslogd/syslog.conf.5     17 Jul 2018 13:51:47 -0000      
1.37
+++ /usr/src/usr.sbin/syslogd/syslog.conf.5     20 Jul 2018 11:33:59 -0000
@@ -102,7 +102,9 @@ Each block of lines is separated from th
 The tag is a line beginning with
 .Em !prog
 and each block will be associated with calls to syslog from that specific
-program (matched using shell globbing rules).
+program (matched using
+.Xr glob 7
+rules).
 When a message matches multiple blocks, the action of each matching
 block is taken.
 If no tag is specified at the beginning of the file,

Reply via email to