Fwd: misc/53091: Web page refers to non-existent directory

[Ray Phillips <ray.phillips%gmail.com@localhost>]

The following reply was made to PR misc/53091; it has been noted by GNATS.

From: Ray Phillips <ray.phillips%gmail.com@localhost>
To: gnats-bugs%netbsd.org@localhost
Cc: 
Subject: Fwd: misc/53091: Web page refers to non-existent directory
Date: Wed, 14 Mar 2018 03:13:32 +1000

 ---------- Forwarded message ----------
 From: Ray Phillips <ray.phillips%gmail.com@localhost>
 Date: 13 March 2018 at 02:01
 Subject: Re: misc/53091: Web page refers to non-existent directory
 To: leot%netbsd.org@localhost
 
 
 Thanks for replying Leonardo.
 
 That's curious, when I read /usr/share/doc/usd/vi/summary.txt and
 vitut.txt using less(1) neither has the ^ character in the "not in"
 line:
 
 sumary.txt:
 
             [str]      any char in str
             [str]      ... not in str
 
 vitut.txt:
 
      [str]   matches any single character in str
      [str]   matches any single character not in str
 
 I checked by viewing those lines using od(1) with its -c option as
 well, for example summary.txt:
 
 0013140            [  \b   [   _  \b   s   _  \b   t   _  \b   r   ]  \b
 0013160    ]                           a   n   y       c   h   a   r
 0013200    i   n       _  \b   s   _  \b   t   _  \b   r  \n
 0013220                                        [  \b   [   _  \b   s   _
 0013240   \b   t   _  \b   r   ]  \b   ]                           .   .
 0013260    .       n   o   t       i   n       _  \b   s   _  \b   t   _
 0013300   \b   r  \n                                                   [
 
 So there's not a hidden ^ character on the "not in" line.
 
 However, ^ is shown in summary.ps.gz and vitut.ps.gz (when
 uncompressed using 7-Zip and viewed with PS View on a Windows PC).
 
 I see that the ^ is also not showing up in this paragraph (section
 8.3) in /usr/share/doc/reference/ref1/ex/reference.txt :
 
 [string]       Matches  any  (single)  character  in  the   class
                defined  by  string.   Most  characters  in string
                define themselves.  A pair of characters separated
                by  `-'  in  string  defines the set of characters
                collating between the specified  lower  and  upper
                bounds,  thus  `[a-z]'  as  a  regular  expression
                matches any (single) lower-case  letter.   If  the
                first  character  of string is an `' then the con-
                struct matches those characters which it otherwise
                would  not;  thus  `[a-z]'  matches anything but a
                lower-case letter (and of course a  newline).   To
                place  any  of  the  characters `', `[', or `-' in
                string you must escape them with a preceding  `\'.
 
 but it is present in reference.ps.gz
 
 
 Ray
 
 
 On 12 March 2018 at 19:55, Leonardo Taccari <leot%netbsd.org@localhost> wrote:
 > The following reply was made to PR misc/53091; it has been noted by GNATS.
 >
 > From: Leonardo Taccari <leot%NetBSD.org@localhost>
 > To: gnats-bugs%NetBSD.org@localhost
 > Cc:
 > Subject: Re: misc/53091: Web page refers to non-existent directory
 > Date: Mon, 12 Mar 2018 10:50:20 +0100
 >
 >  Hello Ray,
 >
 >  ray.phillips%gmail.com@localhost writes:
 >  > >Number:         53091
 >  > >Category:       misc
 >  > >Synopsis:       Web page refers to non-existent directory
 >  > >Confidential:   no
 >  > >Severity:       non-critical
 >  > >Priority:       low
 >  > >Responsible:    misc-bug-people
 >  > >State:          open
 >  > >Class:          doc-bug
 >  > >Submitter-Id:   net
 >  > >Arrival-Date:   Mon Mar 12 07:00:00 +0000 2018
 >  > >Originator:     Ray
 >  > >Release:        7.1.1
 >  > >Organization:
 >  > >Environment:
 >  > NetBSD b2.home 7.1.1 NetBSD 7.1.1 (GENERIC.201712222334Z) amd64
 >  > >Description:
 >  > Section 6.2.2 on this Web page:
 >  >
 >  > https://www.netbsd.org/docs/guide/en/chap-edit.html
 >  >
 >  > says NetBSD's src.tgz file contains a directory with documentation about=
 >   vi (usr/src/usr.bin/vi/docs).  However, that's not right as far as I can =
 >  tell.  I checked by downloading this file:
 >  >
 >  > http://mirror.aarnet.edu.au/pub/netbsd/NetBSD-7.1.1/source/sets/src.tgz
 >  >
 >
 >  Nice catch! IMHO it is probably better to redirect the reader directly
 >  to files installed as part as the misc.tgz installation set.
 >  While here I have also updated the suggested documentation according the
 >  ones installed in /usr/share/doc, a patch to address that for htdocs is
 >  available in:
 >
 >   <https://www.NetBSD.org/~leot/htdocs-patches/chap-edit-adjust-vi-docs.pat=
 >  ch>
 >
 >  ...and if you directly would like to just take a look the chap-edit.html
 >  regenerated HTML with this patch is available here:
 >
 >   <https://www.NetBSD.org/~leot/htdocs-patches/chap-edit-pr-53091.html>
 >
 >  > Given that, what follows is probably irrelevant, but in case you decide =
 >  to put that directory back into src.tgz, one if its files might contain a =
 >  mistake, judging by this...
 >  >
 >  > I found a copy of "An Introduction to Display Editing with Vi" here:
 >  >
 >  > http://ex-vi.sourceforge.net/viin/paper-7.html
 >  >
 >  > and its section 7.4 has an error:
 >  >
 >  > [str]        matches any single character not in str
 >  >
 >  > which of course should be:
 >  >
 >  > [^str]       matches any single character not in str
 >  > [...]
 >
 >  Mmh, this is nowdays available in
 >  `/usr/share/doc/usd/vi/vitut.{ps.gz,txt}'. I guess that maybe the
 >  HTML version just messed up the `^' character. The one in the `.txt'
 >  seems okay while the one in `.ps.gz' is a bit more confusing but seems
 >  documented in `2.1 Scrolling and paging' in order to clarify the `^' in
 >  e.g. [^str] or `^' (to go to the first non-white on line) and ^<char>
 >  (e.g. ^W to erase a word during an insert) used as a `Control + <char>'
 >  notation.
 >  So, I would prefer to leave them as-is.
 >
 >
 >  I will wait several days and if there will be no feedback I will commit
 >  the proposed patch to htdocs.
 >
 >
 >  Thank you Ray for the PR!
 >