Re: NEW: sysutils/p5-Pod-Cpandoc
On Mon, Dec 23, 2013 at 04:05:15PM +0100, Ingo Schwarze wrote: Andrew Fresh wrote on Sun, Dec 22, 2013 at 06:24:17PM -0700: On Mon, Dec 23, 2013 at 01:32:54AM +0100, J'er'emie Courr`eges-Anglas wrote: I thought that this module only fetched data and fed it into our base pod formatter, but if it does more that may be a better choice indeed. As far as I know the above is correct. It overloads the standard Pod::Perldoc's -searchfor method and if it doesn't find a local document, pulls the module from metacpan into a temporary file and displays it. My point being that categorization makes most sense by purpose, and the purpose is to display manuals, and many tools to display manuals or prepare them for display live in textproc. I'd consider putting it below net because of the way it is technically working - opening a network connection to download some data - to be excessively formalistic. Devel is not only crowded, but misleading because the port is unusable for code development; it's puropose isn't even documentation development, but if it were, tools for documentation development live in textproc as well. Sysutils - well, merely displaying a manual is not really a task of system administration... I'm fine with textproc, I generally use pkg_add or cd /usr/ports/*/p5-Pod-Cpandoc so it doesn't really matter. Based on discussion and my thoughts, I would probably put it in net as primary due to the way it works, but also tagged sysutils as I think reading docs is part of system administration and the main piece of this port is /usr/local/bin/cpandoc. Again, l8rZ, -- andrew - http://afresh1.com Hey, I think I see a barn up ahead. -- The American Astronaut
Re: NEW: sysutils/p5-Pod-Cpandoc
Hi, Andrew Fresh wrote on Sun, Dec 22, 2013 at 06:24:17PM -0700: On Mon, Dec 23, 2013 at 01:32:54AM +0100, J'er'emie Courr`eges-Anglas wrote: I thought that this module only fetched data and fed it into our base pod formatter, but if it does more that may be a better choice indeed. As far as I know the above is correct. It overloads the standard Pod::Perldoc's -searchfor method and if it doesn't find a local document, pulls the module from metacpan into a temporary file and displays it. My point being that categorization makes most sense by purpose, and the purpose is to display manuals, and many tools to display manuals or prepare them for display live in textproc. I'd consider putting it below net because of the way it is technically working - opening a network connection to download some data - to be excessively formalistic. Devel is not only crowded, but misleading because the port is unusable for code development; it's puropose isn't even documentation development, but if it were, tools for documentation development live in textproc as well. Sysutils - well, merely displaying a manual is not really a task of system administration... But of course, you choose, you are the porters! :-) Ingo
Re: NEW: sysutils/p5-Pod-Cpandoc
Andrew Fresh and...@afresh1.com writes: I'm sure there must be something wrong as making this port this was too simple. But anyway , alias perldoc=cpandoc makes my life better. Looks fine. I wasn't actually sure where it should live, so please critic. At first I'd have put it in misc. devel and sysutils kinda make sense too, but devel is too crowded and putting it under sysutils sounded weird. Maybe misc devel sysutils? :) https://metacpan.org/release/SARTAK/Pod-Cpandoc-0.15 l8rZ, -- jca | PGP: 0x06A11494 / 61DB D9A0 00A4 67CF 2A90 8961 6191 8FBF 06A1 1494
Re: NEW: sysutils/p5-Pod-Cpandoc
Hi, Jérémie Courrèges-Anglas wrote on Mon, Dec 23, 2013 at 12:48:08AM +0100: Andrew Fresh and...@afresh1.com writes: I wasn't actually sure where it should live, so please critic. At first I'd have put it in misc. devel and sysutils kinda make sense too, but devel is too crowded and putting it under sysutils sounded weird. Maybe misc devel sysutils? :) I'd suggest textproc only with no secondary category. Along with asciidoc, docbook, groff, gtk-doc, info2html, linuxdoc, markdown, naturaldocs, p5-Pod-POM, p5-Pod-Spell, p5-Pod-Tests, pilot_makedoc, pinfo, py-HappyDoc, py-docutils, py-epydoc, rman, txt2man, ... Yours, Ingo
Re: NEW: sysutils/p5-Pod-Cpandoc
Ingo Schwarze schwa...@usta.de writes: Hi, Jérémie Courrèges-Anglas wrote on Mon, Dec 23, 2013 at 12:48:08AM +0100: Andrew Fresh and...@afresh1.com writes: I wasn't actually sure where it should live, so please critic. At first I'd have put it in misc. devel and sysutils kinda make sense too, but devel is too crowded and putting it under sysutils sounded weird. Maybe misc devel sysutils? :) I'd suggest textproc only with no secondary category. Along with asciidoc, docbook, groff, gtk-doc, info2html, linuxdoc, markdown, naturaldocs, p5-Pod-POM, p5-Pod-Spell, p5-Pod-Tests, pilot_makedoc, pinfo, py-HappyDoc, py-docutils, py-epydoc, rman, txt2man, ... I thought that this module only fetched data and fed it into our base pod formatter, but if it does more that may be a better choice indeed. Looking forward to see this included! Yours, Ingo -- jca | PGP: 0x06A11494 / 61DB D9A0 00A4 67CF 2A90 8961 6191 8FBF 06A1 1494
Re: NEW: sysutils/p5-Pod-Cpandoc
On Mon, Dec 23, 2013 at 01:32:54AM +0100, J'er'emie Courr`eges-Anglas wrote: I thought that this module only fetched data and fed it into our base pod formatter, but if it does more that may be a better choice indeed. As far as I know the above is correct. It overloads the standard Pod::Perldoc's -searchfor method and if it doesn't find a local document, pulls the module from metacpan into a temporary file and displays it. l8rZ, -- andrew - http://afresh1.com What are the unsurpassable real world weaknesses in OpenBSD, that you know of? -- Kevin Chadwick ma1l1i...@yahoo.co.uk Lots of fake people attacking the project on the mailing lists makes them a poor resource for users. -- Theo de Raadt dera...@cvs.openbsd.org
NEW: sysutils/p5-Pod-Cpandoc
I'm sure there must be something wrong as making this port this was too simple. But anyway , alias perldoc=cpandoc makes my life better. I wasn't actually sure where it should live, so please critic. https://metacpan.org/release/SARTAK/Pod-Cpandoc-0.15 l8rZ, -- andrew - http://afresh1.com Hey! It compiles! Ship it! p5-Pod-Cpandoc-0.15-port.tar.gz Description: application/tar-gz