Using MAN1PODS

Hi, folks

Accordingly with the documentation of MakeMaker:

   MAN1PODS

     Hashref of pod-containing files. MakeMaker will default this to all
     EXE_FILES files that include POD directives. The files listed here
     will be converted to man pages and installed as was requested at
     Configure time.

I found out this documentation quite difficult to understand.
The code I got working was:

	MAN1PODS            => {
		'src/jspell.pod'      => 'blib/man1/jspell.1',
		'src/jspellaff.pod'   => 'blib/man1/jspellaff.1',
		'src/jbuild.pod'      => 'blib/man1/jbuild.1',
		'scripts/jspell-dict' => 'blib/man1/jspell-dict.1',
	},

and I think this is the correct usage.

My question is:
  - shouldn't it be just
	MAN1PODS            => {
		'src/jspell.pod'      => 'jspell.1',
		'src/jspellaff.pod'   => 'jspellaff.1',
		'src/jbuild.pod'      => 'jbuild.1',
		'scripts/jspell-dict' => 'jspell-dict.1',
	},
    as we know they are man1pods, and thus should be placed on blib/man1?

  - and, shouldn't we have an example on the documentation? I discovered
    the correct way after five tries :)

Cheers
ambs


-- 
Alberto Simões - Departamento de Informática - Universidade do Minho
                  Campus de Gualtar - 4710-057 Braga - Portugal