docs/70916: msync.2 manpage update

[Radim Kolar]

>Number:         70916
>Category:       docs
>Synopsis:       msync.2 manpage update
>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:   Tue Aug 24 20:40:22 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Radim Kolar
>Release:        FreeBSD 5.3-BETA1 i386
>Organization:
>Environment:
System: FreeBSD sanatana.dharma 5.3-BETA1 FreeBSD 5.3-BETA1 #1: Tue Aug 24 14:21:29 CEST 2004 root at sanatana.dharma:/usr/obj/usr/src/sys/UP i386
>Description:
Msync function is obsolete as noted in mmap manpage, but this information
is missing from msync manpage itself.
>How-To-Repeat:
>Fix:
Add following text to msync.2 BUGS section
/copied from mmap manpage/

The msync(2) system call is obsolete since
BSD implements a coherent file system buffer cache.
However, it may be used to associate dirty VM pages
with file system buffers and thus cause them to be
flushed to physical media sooner rather than later.
>Release-Note:
>Audit-Trail:
>Unformatted: