%N pgpage %F $MIR/src/pgpage.f
%D Advance to new page
%B
      SUBROUTINE PGPAGE

 Advance plotter to a new page or panel, clearing the screen if
 necessary. If the "prompt state" is ON (see PGASK), confirmation is
 requested from the user before clearing the screen. If the view
 surface has been subdivided into panels with PGBEG or PGSUBP, then
 PGPAGE advances to the next panel, and if the current panel is the
 last on the page, PGPAGE clears the screen or starts a new sheet of
 paper.  PGPAGE does not change the PGPLOT window or the viewport
 (in normalized device coordinates); but note that if the size of the
 view-surface is changed externally (e.g., by a workstation window
 manager) the size of the viewport is changed in proportion.

 Arguments: none
