Defect in XSH readdir

[konrad.schwarz@xxxxxxxxxxx]

        Defect report from : Konrad Schwarz , Siemens AG

(Please direct followup comments direct to austin-group-l@xxxxxx)

@ page 0 line 0 section readdir editorial {readdir-kas}

Problem:

Edition of Specification (Year): 2004

Defect code :  1. Error

The manual page for readdir 
(http://www.opengroup.org/onlinepubs/009695399/functions/readdir.html),
section DESCRIPTION,
first discusses readdir(), then discusses readdir_r() (TSF shaded),
and finally, has a one-line paragraph
"Applications wishing to check for error situations should set errno to 0 
before calling readdir(). If errno is set to non-zero on return, an error 
occurred." again on readdir().  This is the final paragraph before the ERRORS 
section.

It is easy to miss this paragraph which is relevant only to readdir().

Action:

Move the paragraph mentioned above to before the discussion of readdir_r(), so 
that all information pertinent to readdir() is in one place.