* [RFC] Convert Documentation/ to asciidoc?
@ 2009-12-13 15:38 Diego Calleja
2009-12-13 17:29 ` Randy Dunlap
0 siblings, 1 reply; 3+ messages in thread
From: Diego Calleja @ 2009-12-13 15:38 UTC (permalink / raw)
To: linux-kernel
Git uses asciidoc, tools/perf/Documentation uses asciidoc... It seems
a good fit for Documentation/. Is there any objection against it?
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [RFC] Convert Documentation/ to asciidoc?
2009-12-13 15:38 [RFC] Convert Documentation/ to asciidoc? Diego Calleja
@ 2009-12-13 17:29 ` Randy Dunlap
2009-12-13 17:41 ` Matt Mackall
0 siblings, 1 reply; 3+ messages in thread
From: Randy Dunlap @ 2009-12-13 17:29 UTC (permalink / raw)
To: Diego Calleja; +Cc: linux-kernel, Matt Mackall
On Sun, 13 Dec 2009 16:38:55 +0100 Diego Calleja wrote:
> Git uses asciidoc, tools/perf/Documentation uses asciidoc... It seems
> a good fit for Documentation/. Is there any objection against it?
> --
I think I'd like to see it, but I can only say for sure after
I see the results. OTOH, Matt Mackall didn't care for it the
last time that this was brought up.
---
~Randy
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [RFC] Convert Documentation/ to asciidoc?
2009-12-13 17:29 ` Randy Dunlap
@ 2009-12-13 17:41 ` Matt Mackall
0 siblings, 0 replies; 3+ messages in thread
From: Matt Mackall @ 2009-12-13 17:41 UTC (permalink / raw)
To: Randy Dunlap; +Cc: Diego Calleja, linux-kernel
On Sun, Dec 13, 2009 at 09:29:30AM -0800, Randy Dunlap wrote:
> On Sun, 13 Dec 2009 16:38:55 +0100 Diego Calleja wrote:
>
> > Git uses asciidoc, tools/perf/Documentation uses asciidoc... It seems
> > a good fit for Documentation/. Is there any objection against it?
> > --
>
> I think I'd like to see it, but I can only say for sure after
> I see the results. OTOH, Matt Mackall didn't care for it the
> last time that this was brought up.
Mercurial adopted asciidoc early on, and our experience with it wasn't
great - it had many difficult to work around quirks. We eventually
built our own parser for a subset of 'restructured text' to generate
our help messages and build our docs.
I think if we're going to go down a mark-up road for Documentation/,
we're going to need to roll our own tool and make it aware of
kerneldoc and so forth.
--
Mathematics is the supreme nostalgia of our time.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2009-12-13 17:51 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2009-12-13 15:38 [RFC] Convert Documentation/ to asciidoc? Diego Calleja
2009-12-13 17:29 ` Randy Dunlap
2009-12-13 17:41 ` Matt Mackall
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®