Peter,
I am not sure if by a brief note, you mean the ps docs under
$GISBASE/mapgen/docs. If not, maybe try looking at those documents.
As far as your map definition file, you create that by running the command
make.mapdef
This defines the layout of your map composition on the page.
Stan