From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f65.google.com (mail-wm1-f65.google.com [209.85.128.65]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 70deee3f for ; Thu, 11 Oct 2018 02:52:52 -0500 (EST) Received: by mail-wm1-f65.google.com with SMTP id i8-v6so7897579wmg.0 for ; Thu, 11 Oct 2018 00:52:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:subject:message-id:references:mime-version :content-disposition:content-transfer-encoding:in-reply-to :user-agent; bh=erYHiRmSBOXjmSwexJOo049PRrM/5OQYWZnkaLSYA8I=; b=oopVLEwO+P6d5a6mkAnMv811rtvoX8MB2bc2pTWVp1BstBRPuLQgm8gKwTRTT3Oreu BQmLYK5x9uHqJwjBPGnVAJtvBQJpaILTpI7RJhJfFE5H6XRcwBVlzdTWvRih+4wjbVnO GkLh7BNfFlNHlXFWVnhFdwZY9PU0ejmByyOS9X0uY8MrDEbz85SJU+Sp1FDwxVtqNPLs 19aQG3belkv62HLadAzf5K0iox7hiz+Lz8XG+IBp3NDqnVfNR3S76waVXvRZEn2KsoHw iRCtlZhy22MYdWuXh0mCWyhA0rto/8BXcG97myJf+E7OiM3DuIPgGMRuGBv8MZVhIjhq rh6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:subject:message-id:references :mime-version:content-disposition:content-transfer-encoding :in-reply-to:user-agent; bh=erYHiRmSBOXjmSwexJOo049PRrM/5OQYWZnkaLSYA8I=; b=ZbsYHMuknp/nLsxgP5+zRJ0xk9/LlPNvvvg9vfcttdcITaL2wvrOX3DbWd2fVuYZc/ wCHXkme0QffS+OTeWVYPQ9+5ekR4xTAPJKmAL/0fpiw0yJD4M+XQRiLii6fHll69IPhP 7WR/Sc3u8n6frqFwrHKoXTZqXVde5ZyQRS6RTmYhOhv5IRl6j4wYsSgutKxtBmXH3Jbo f4JJRyi0N5UgbVVp79GRQ8eVvdST9gct8gfQ1f264UGvIPexX7p6LOSzsmK6TDQ1QDMI SOKYrGCcPjOcGn6sCGXU3GeFhv8NjhjUCwOuTq70j1BFsZSWAwBA4hIXNyv8MrBGHohX QQwQ== X-Gm-Message-State: ABuFfogMFxWKyloSTnhzcXwDXoogQU37oxhgU3nFeLcH9toWfPAzzShA xb9GQOgDi97ZF9w9jxTKf5bbLmYP X-Google-Smtp-Source: ACcGV61IocH+NhwXsBy8u1GrjZpO7ayIza7DSLgHD84Ur50ofS4QjzIMhfaNRzJ1v5Vp59UUHbq2ow== X-Received: by 2002:a1c:6504:: with SMTP id z4-v6mr665524wmb.130.1539244369653; Thu, 11 Oct 2018 00:52:49 -0700 (PDT) Received: from pali ([2a02:2b88:2:1::5cc6:2f]) by smtp.gmail.com with ESMTPSA id 2-v6sm19012709wro.96.2018.10.11.00.52.48 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 11 Oct 2018 00:52:48 -0700 (PDT) Date: Thu, 11 Oct 2018 09:52:47 +0200 From: Pali =?utf-8?B?Um9ow6Fy?= To: discuss@mandoc.bsd.lv Subject: Re: mandoc & perl documentation Message-ID: <20181011075247.2jo4of7bkpvhkekm@pali> References: <20180913151226.oaon3nvlvgcqioau@pali> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20180913151226.oaon3nvlvgcqioau@pali> User-Agent: NeoMutt/20170113 (1.7.2) On Thursday 13 September 2018 17:12:26 Pali Rohár wrote: > Hello! > > In perl world is documentation for perl modules or perl scripts writing > in the POD format. Build process for perl scripts/modules then convert > POD documentation into manpages and install it into standard system > location. > > I looked at Debian manpages which uses mandoc for converting man pages > to HTML and basically documentation for perl modules is not good. > > For example this is HTMLized manpage for Email::Address::XS perl module: > https://manpages.debian.org/Email::Address::XS > > There is also converting tool which formats POD documentation directly > into HTML output. And for Email::Address::XS module is looks like: > https://metacpan.org/pod/Email::Address::XS > > So, I would like to ask, how can be HTML output generated from perl > manpages improved (process: POD --> mandoc --> HTML), so documentation > would be more close to the native HTML output (process: POD --> HTML)? > > I understand that something like syntax highlighting is not possible, > but if you look at differences, in HTML output from mandoc are broken > vertical spaces (some are totally missing) or missing all different font > families. > > If problem is in POD --> manpage converter (Pod::Man module), I can look > at it. But at the first I would need to know what mandoc is able to > process and what not. > Just to note, raw manpage (generated by Pod::Man) is available there: https://manpages.debian.org/Email::Address::XS.3pm.en.gz And viewing it on terminal does not case problems with vertical spaces like in HTML output. So it is problem in mandoc HTML generator? -- Pali Rohár pali.rohar@gmail.com -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv