[perl #80246] Wish: provide a MIME type for POD files

# New Ticket Created by  Kristof Zelechovski 
# Please include the string:  [perl #80246]
# in the subject line of all future correspondence about this issue. 
# <URL: http://rt.perl.org/rt3/Ticket/Display.html?id=80246 >



This is a bug report for perl from giecrilj@stegny.2a.pl,
generated with the help of perlbug 1.39 running under perl 5.12.1.


-----------------------------------------------------------------
[Please describe your issue here]

When I open a POD file in Dolphin,
 such as /usr/share/doc/packages/apache2-mod_perl/docs/user/intro/overview.pod, it opens in a text editor. 
 This is a suboptimal way of reading documentation.  I would rather prefer an action to be run.
  However, I cannot define such an action because the perceived MIME type of the file is text/plain.

TO DO:
  1. Define a MIME type text/x-perldoc for POD files.  Install the definition in the shared MIME database.

<?xml version="1.0" encoding="utf-8"?>
<mime-type xmlns="http://www.freedesktop.org/standards/shared-mime-info" type="text/x-perldoc">
  <!--Created automatically by update-mime-database. DO NOT EDIT!-->
  <comment>Plain Old Documentation for PERL</comment>
  <glob pattern="*.pod"/>
</mime-type>

  2. Define a perldoc action to display the POD file formatted.

[Desktop Entry]
Exec=xditview '-resolution' '100' '| perldoc -onroff %F | groff -Z -X -TX100 -mandoc'
GenericName=Looks up Perl documentation in POD format
Icon=help-about
MimeType=text/x-perldoc;
Name=perldoc
StartupNotify=true
Type=Application

  3. Associate the type with the action.


[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
    category=install
    severity=wishlist
---
This perlbug was built using Perl 5.12.1 - Fri Jul 30 00:13:43 UTC 2010
It is being executed now by  Perl 5.12.1 - Fri Jul 30 00:09:43 UTC 2010.

Site configuration information for perl 5.12.1:

Configured by abuild at Fri Jul 30 00:09:43 UTC 2010.

Summary of my perl5 (revision 5 version 12 subversion 1) configuration:
   
  Platform:
    osname=linux, osvers=2.6.32, archname=x86_64-linux-thread-multi
    uname='linux build30 2.6.32 #1 smp 2010-01-06 16:07:25 +0100 x86_64 x86_64 x86_64 gnulinux '
    config_args='-ds -e -Dprefix=/usr -Dvendorprefix=/usr -Dinstallusrbinperl -Dusethreads -Di_db -Di_dbm -Di_ndbm -Di_gdbm -Duseshrplib=true -Doptimize=-fmessage-length=0 -O2 -Wall -D_FORTIFY_SOURCE=2 -fstack-protector -funwind-tables -fasynchronous-unwind-tables -g -Wall -pipe -Accflags=-DPERL_USE_SAFE_PUTENV'
    hint=recommended, useposix=true, d_sigaction=define
    useithreads=define, usemultiplicity=define
    useperlio=define, d_sfio=undef, uselargefiles=define, usesocks=undef
    use64bitint=define, use64bitall=define, uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='cc', ccflags ='-D_REENTRANT -D_GNU_SOURCE -DPERL_USE_SAFE_PUTENV -DDEBUGGING -fno-strict-aliasing -pipe -fstack-protector -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64',
    optimize='-fmessage-length=0 -O2 -Wall -D_FORTIFY_SOURCE=2 -fstack-protector -funwind-tables -fasynchronous-unwind-tables -g -Wall -pipe',
    cppflags='-D_REENTRANT -D_GNU_SOURCE -DPERL_USE_SAFE_PUTENV -DDEBUGGING -fno-strict-aliasing -pipe -fstack-protector'
    ccversion='', gccversion='4.5.0 20100604 [gcc-4_5-branch revision 160292]', gccosandvers=''
    intsize=4, longsize=8, ptrsize=8, doublesize=8, byteorder=12345678
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
    ivtype='long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='cc', ldflags =' -L/usr/local/lib64 -fstack-protector'
    libpth=/lib64 /usr/lib64 /usr/local/lib64
    libs=-lm -ldl -lcrypt -lpthread
    perllibs=-lm -ldl -lcrypt -lpthread
    libc=/lib64/libc-2.11.2.so, so=so, useshrplib=true, libperl=libperl.so
    gnulibc_version='2.11.2'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E -Wl,-rpath,/usr/lib/perl5/5.12.1/x86_64-linux-thread-multi/CORE'
    cccdlflags='-fPIC', lddlflags='-shared -L/usr/local/lib64 -fstack-protector'

Locally applied patches:
    

---
@INC for perl 5.12.1:
    /usr/lib/perl5/site_perl/5.12.1/x86_64-linux-thread-multi
    /usr/lib/perl5/site_perl/5.12.1
    /usr/lib/perl5/vendor_perl/5.12.1/x86_64-linux-thread-multi
    /usr/lib/perl5/vendor_perl/5.12.1
    /usr/lib/perl5/5.12.1/x86_64-linux-thread-multi
    /usr/lib/perl5/5.12.1
    .

---
Environment for perl 5.12.1:
    HOME=/home/krzysztof
    LANG=pl_PL.UTF-8
    LANGUAGE=
    LD_LIBRARY_PATH=/usr/lib64/mpi/gcc/openmpi/lib64
    LOGDIR (unset)
    PATH=/usr/lib64/mpi/gcc/openmpi/bin:/home/krzysztof/bin:/usr/local/bin:/usr/bin:/bin:/usr/bin/X11:/usr/X11R6/bin:/usr/games:/usr/lib/mit/bin:/usr/lib/mit/sbin
    PERL_BADLANG (unset)
    SHELL=/bin/bash

• [perl #80246] Wish: provide a MIME type for POD files by Kristof Zelechovski
• Re: [perl #80246] Wish: provide a MIME type for POD files by Leon Timmermans