On Fri, Jul 20, 2018 at 02:10:09PM +0200, Klemens Nanni wrote: > 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? >
i'm ok with this. i'm not sure though if there is/was a specific reason to refer to glob(3), or if it just got copied across pages. jmc > 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, >
