subwin man page

[Neil Zanella]

Hello,

I think I have found a problem with the ncurses 5.1 subwindow man page
which says the following:

"When using this routine, it is necessary  to call touchwin or touchline
on orig before calling wrefresh on the subwindow."

This does not make much sense. I think the man page should say the
following instead:

"When using this routine, it is necessary  to call touchwin or touchline
on orig before calling wrefresh on the parent window."

Does everyone agree with me here? If not please provide me with a
counterexample of why I am wrong. And by the way, I have compared
with the Solaris XSI man page which is a little ambiguous but correct
in saying it is _often_ (but not always) necessary to call wrefresh
(without specifying wrefresh's argument):

"When using subwindows, it is often necessary to call 
touchwin(3XCURSES) before wrefresh(3XCURSES) to maintain
proper screen contents."

Perhaps to make the ncurses man page more clear I would add the following
which is most likely one of the intended uses of subwindows:

In general if the bottom level windows are created in such a way that
they do not overlap and if it is only the bottom level windows
that process input and get refreshed then there should be no reason to
call touchwin() or touchline() on parent windows. Everything should
work fine.

Comments are welcome.

Best Regards,

Neil