Re3: Documenting executables

Did you really take a close look at POD::Usage as suggested by joefission?? I think this module does what you want, namely extract (part of) the pod of your script and print it out. This can be used instead of a usage sub. Take especially a look at the example at the end of the documentation - I think that does exactly what you were looking for.

Please correct me if I misunderstood what you are trying to do ...

-- Hofmator

Comment on Re3: Documenting executables

Replies are listed 'Best First'.
Re4: Documenting executables by perl::scribe (Sexton) on Aug 17, 2001 at 20:20 UTC
I did take a look at POD::Usage, but apparently I did not look hard enough. Thank you, Hofmator, for pointing out my ignorance! I converted the example script into an executable, ran it and what do you know...it worked. Thanks again to both of you. BTW, is that the way most of you do it? Greetings May Larry be with you!	[reply]
Documenting executables without original perl script present by perl::scribe (Sexton) on Mar 19, 2002 at 11:44 UTC
I've been fiddling about with POD::Usage again and I have noticed that this approach only seems to work if the original perl script is in the same directory as the executable. POD::Usage keeps looking for the original .pl file which can't be found. Anybody know of a way to remedy this? UPDATE I just read in the documentation that you can set the path to the pod input file, but I still think that's mighty inconvenient. I'm afraid there's no other way though, right? sigh Thanks! May Larry be with you	[reply]