From: Julian Phillips Date: Tue, 29 Jul 2008 19:00:55 GMT Subject: Re: Git Community Book Message-ID: In-Reply-To: <7vwsj4edm1.fsf@gitster.siamese.dyndns.org> On Tue, 29 Jul 2008, Junio C Hamano wrote: > "Scott Chacon" writes: > >>> >>> There is no license in the source code - what are the copying terms? >>> >> >> I copied in the COPYING file from Git - GPL2. >> >>> It is maybe somewhat unfortunate that this is in a different format that >>> the standard git choice asciidoc, but the formats do look rather similar >>> so I assume it should not be hard to even convert from one to another if >>> needed. >> >> I simply didn't want to get asciidoc working locally - it's always >> been a bit of a pain to compile (I've heard it referred to more than >> once as the only 'nightmare dependancy' in git), and I don't need to >> make man pages or anything, so it seemed Markdown would be a better >> choice for my output targets. There are a number of good Markdown >> interpreters and they're easy to get running. > > I personally like markdown, but doesn't your refusal to work with existing > practices pose a significant problem, unless: > > (0) you do not consider it a goal to keep the documentation shipped with > git and your book in sync; or > > (1) you have either markdown to asciidoc (or the other way around) > converter; the book is written in markdown, and its conversion back > to asciidoc is fed to Documentation as patches (or the other way > around); or > > (2) somebody tries to find markdown to manpage, and we convert > Documentation/ to markdown. Haven't used it personally, and without commenting on the "political" side of such an approach - there does exist at least one tool that claims to be able to convert from markdown to man: http://johnmacfarlane.net/pandoc/ > Or is this, "fork once and borrow reviewer's time, but never be able to > contribute back to the original text because the result is so different" > approach? > > -- > To unsubscribe from this list: send the line "unsubscribe git" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html > -- Julian --- [The French Riviera is] a sunny place for shady people. -- Somerset Maugham