http://qs1969.pair.com?node_id=405800


in reply to pmdesc2 - lists modules with description

The speed improvement is great, but pmdesc2 has still some flaws:
(1) Version numbers with more than one separating point (sub-subversion) will be converted into control characters.
(2) DOS-terminated files are not handled correctly (no description found).
(3) The extracted description is not limited to a maximal length, so faulty docs are slurped in completely.
(4) Some modules are split into a pm-file and an accompanying pod-file which leads to double entries.
I rewrote parts of the script and called it pmdesc3. It overcomes the above mentioned flaws. Output can be sorted and formated. It has a POD included. pmdesc3 is part of the VIM-plugin perl-support.vim (script # 556) and can be found at http://vim.sourceforge.net/scripts/script.php?script_id=556

Replies are listed 'Best First'.
Re^2: pmdesc2 - lists modules with description
by Aristotle (Chancellor) on Jul 16, 2006 at 05:52 UTC

    I rewrote parts of the script and called it pmdesc3. It overcomes the above mentioned flaws. Output can be sorted and formated. It has a POD included. pmdesc3 is part of the VIM-plugin perl-support.vim (script # 556) and can be found at http://vim.sourceforge.net/scripts/script.php?script_id=556

    Oh dear. Let me quote MJD’s File of Good Advice…

    #11911 You wrote the same thing twice here. The cardinal rule of programming is that you never ever write the same thing twice.

    Copy-pasting bits all over the code is not a good idea.

    In any case, I’ve fixed your complaints and posted a new version at lspm — list names and descriptions of Perl modules in a directory. It doesn’t have sorting, because I don’t see the point of implementing that as an option that won’t work on systems where you can pipe output to another process anyway, but it does address all the problems you brought up and adds a bonus feature too. The output should be more readily parsable, as well, although it doesn’t look the same as in your version.

    Makeshifts last the longest.