docs/158973: Update man(1)

[Momchil Ivanov]

>Number:         158973
>Category:       docs
>Synopsis:       Update man(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jul 16 16:00:22 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Momchil Ivanov
>Release:        FreeBSD 8.2-STABLE #13: Sat Feb 26 16:30:35 CET 2011
>Organization:
>Environment:
FreeBSD 8.2-STABLE #13: Sat Feb 26 16:30:35 CET 2011 i386
>Description:
man(1) does not state, that it can display man pages outside of the manpath directory structure. From time to time one needs to display a man page from some third party sources that one has downloaded but not installed yet: man <somefile>, but the caveat is that <somefile> needs to include at least one "/", otherwise man fails. See /usr/src/gnu/usr.bin/man/man/man.c:208 for more details:

      else if (strchr (nextarg, '/') != NULL && is_file (nextarg) == 1)
	{
	  format_and_display (NULL, ultimate_source(nextarg, dirname(nextarg)),
			      NULL);
	}
      else
	{
	  status = man (nextarg);

	  if (status == 0)
	    gripe_not_found (nextarg, longsec);
	}
>How-To-Repeat:
man <somefile>

<somefile> has no "/", i.e. is in the current directory
>Fix:
Update man(1) accordingly, so that it reflects the requirement for at least one "/" in the file name/path, whenever one wants to display a man page outside the manpath tree structure

>Release-Note:
>Audit-Trail:
>Unformatted: