Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Tom Wijsman
On Wed, 25 Sep 2013 20:15:57 +0200 Michał Górny wrote: > Dnia 2013-09-25, o godz. 14:38:14 > Tom Wijsman napisał(a): > > > On Wed, 25 Sep 2013 08:36:56 +0200 > > Martin Gysel wrote: > > > > > Am 24.09.2013 19:49, schrieb hasufell: > > > > I wonder if it would make any sense to take the effort

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Tom Wijsman
On Wed, 25 Sep 2013 20:07:42 +0200 Michał Górny wrote: > Dnia 2013-09-25, o godz. 14:29:52 > Tom Wijsman napisał(a): > > > > > > 3) adding some more ugly awful magic that will make binary > > > > > packages even less useful. > > > > > > > > For binary packages a choice has to be made; trying t

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Michał Górny
Dnia 2013-09-25, o godz. 14:38:14 Tom Wijsman napisał(a): > On Wed, 25 Sep 2013 08:36:56 +0200 > Martin Gysel wrote: > > > Am 24.09.2013 19:49, schrieb hasufell: > > > I wonder if it would make any sense to take the effort to convert > > > markdown docs to html format before installing them. >

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Michał Górny
Dnia 2013-09-25, o godz. 14:29:52 Tom Wijsman napisał(a): > > > > 3) adding some more ugly awful magic that will make binary > > > > packages even less useful. > > > > > > For binary packages a choice has to be made; trying to solve things > > > for binary packages is like discussing something t

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread hasufell
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I lost interest. -BEGIN PGP SIGNATURE- Version: GnuPG v2.0.20 (GNU/Linux) Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBAgAGBQJSQttjAAoJEFpvPKfnPDWzRXYIAIQKnHSRoChJ/gHd56KxaaW+ KGYQG9xW/OAO68qiubRW/1YK6vMRfWk9k/6m/pw

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Tom Wijsman
On Wed, 25 Sep 2013 08:36:56 +0200 Martin Gysel wrote: > Am 24.09.2013 19:49, schrieb hasufell: > > I wonder if it would make any sense to take the effort to convert > > markdown docs to html format before installing them. > > > > following that logic we should also consider converting all man

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Tom Wijsman
On Wed, 25 Sep 2013 09:57:26 +0200 Michał Górny wrote: > Dnia 2013-09-25, o godz. 00:30:27 > Tom Wijsman napisał(a): > > > On Wed, 25 Sep 2013 00:07:15 +0200 > > Michał Górny wrote: > > > > Why do I need a browser, a PDF reader and a Markdown viewer and > > possibly more clients to read my do

Re: [gentoo-dev] markdown docs like README.md

2013-09-25 Thread Michał Górny
Dnia 2013-09-25, o godz. 00:30:27 Tom Wijsman napisał(a): > On Wed, 25 Sep 2013 00:07:15 +0200 > Michał Górny wrote: > > Why do I need a browser, a PDF reader and a Markdown viewer and > possibly more clients to read my documentation in a formatted way? And why do I need a special HTML-formatt

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Martin Gysel
Am 24.09.2013 19:49, schrieb hasufell: > I wonder if it would make any sense to take the effort to convert > markdown docs to html format before installing them. > following that logic we should also consider converting all man and info pages to html... it doesn't make any sense... simply provid

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Kent Fredric
On 25 September 2013 12:33, Tom Wijsman wrote: > The existence of a tool does not exclude that an ebuild cannot use it; > so, I agree with your paragraph but that doesn't necessarily mean we can > apply this in an ebuild context. > I guess I can agree I would be amenable to a scenario where you

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Tom Wijsman
On Wed, 25 Sep 2013 11:27:50 +1200 Kent Fredric wrote: > On 25 September 2013 10:30, Tom Wijsman wrote: > > > If I want to browse all documentation with a browser, just going to > > something like file:///usr/share/doc and read them all in the same > > style (using an extension like Stylebot or

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Kent Fredric
On 25 September 2013 10:30, Tom Wijsman wrote: > If I want to browse all documentation with a browser, just going to > something like file:///usr/share/doc and read them all in the same > style (using an extension like Stylebot or so); then it would be neat > if Gentoo could bring them down to th

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Tom Wijsman
On Wed, 25 Sep 2013 00:07:15 +0200 Michał Górny wrote: > Dnia 2013-09-24, o godz. 23:50:20 > Tom Wijsman napisał(a): > > > Principle or not, we shouldn't force our users down a particular > > way to reading them; as that's not what our meta-distribution > > stands for. > > We shouldn't either

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread heroxbd
hasufell writes: > I wonder if it would make any sense to take the effort to convert > markdown docs to html format before installing them. I'd rather leave it alone, as markdown is more readable than html, IMHO. Anyway, when we read html in the console, it's converted back to plan text.

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Michał Górny
Dnia 2013-09-24, o godz. 23:50:20 Tom Wijsman napisał(a): > On Tue, 24 Sep 2013 22:15:15 +0200 > Michał Górny wrote: > > > Dnia 2013-09-24, o godz. 19:49:33 > > hasufell napisał(a): > > > > > I wonder if it would make any sense to take the effort to convert > > > markdown docs to html format

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Tom Wijsman
On Tue, 24 Sep 2013 22:15:15 +0200 Michał Górny wrote: > Dnia 2013-09-24, o godz. 19:49:33 > hasufell napisał(a): > > > I wonder if it would make any sense to take the effort to convert > > markdown docs to html format before installing them. > > What for? The point of markups like Markdown is

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Tom Wijsman
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Tue, 24 Sep 2013 18:56:33 +0100 Ciaran McCreesh wrote: > hasufell wrote: > > I wonder if it would make any sense to take the effort to convert > > markdown docs to html format before installing them. > > Aren't there thirty seven different incom

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread hasufell
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 09/24/2013 10:15 PM, Michał Górny wrote: > Dnia 2013-09-24, o godz. 19:49:33 hasufell > napisał(a): > >> I wonder if it would make any sense to take the effort to >> convert markdown docs to html format before installing them. > > What for? The p

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Michał Górny
Dnia 2013-09-24, o godz. 19:49:33 hasufell napisał(a): > I wonder if it would make any sense to take the effort to convert > markdown docs to html format before installing them. What for? The point of markups like Markdown is for the text to be readable as plain text. Converting it to HTML goes

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Tom Wijsman
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Tue, 24 Sep 2013 19:49:33 +0200 hasufell wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > I wonder if it would make any sense to take the effort to convert > markdown docs to html format before installing them. Converting them to HTM

Re: [gentoo-dev] markdown docs like README.md

2013-09-24 Thread Ciaran McCreesh
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Tue, 24 Sep 2013 19:49:33 +0200 hasufell wrote: > I wonder if it would make any sense to take the effort to convert > markdown docs to html format before installing them. Aren't there thirty seven different incompatible formats all called "markdow

[gentoo-dev] markdown docs like README.md

2013-09-24 Thread hasufell
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I wonder if it would make any sense to take the effort to convert markdown docs to html format before installing them. I see two possibilities: 1. Create one or two eutils functions like "domd": will go through all viable implementations like markdow