From mboxrd@z Thu Jan 1 00:00:00 1970 From: Thomas Petazzoni Date: Fri, 5 Aug 2011 10:22:51 +0200 Subject: [Buildroot] [RFC] Using AsciiDoc for the Buildroot manual In-Reply-To: <87ipqcmhf7.fsf@macbook.be.48ers.dk> References: <20110805083926.257f81bc@skate> <87ipqcmhf7.fsf@macbook.be.48ers.dk> Message-ID: <20110805102251.7a293244@skate> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: buildroot@busybox.net Le Fri, 05 Aug 2011 09:44:12 +0200, Peter Korsgaard a ?crit : > Thomas> For the first part, I guess the "make release" target can be > Thomas> extended to generate the documentation and then include it into > Thomas> the tarball, but I think this is something to be discussed with > Thomas> Peter. > > Indeed. For releases I think atleast the text and single-html version > should get included in the tarball. So, should we extend the release to target to uncompress the tarball after it has been generated by git archive, generate the documentation, add it to the release directory, and re-create the tarball? Or is there a better way? > We also need to setup something with > a git hook to regenerate (some of) the documentation on the server > whenever any of the source files changes. Currently the website is > simply a git checkout managed from cron on the server, and there's no > asciidoc on the server, but presumably that's just a question about > asking the osuosl.org guys for it. In order to move forward on this, can we start discussing this with the osuosl.org people? > Well, so far I've only heard positive feedback, so I would say: Go for > it! Great! Thomas -- Thomas Petazzoni, Free Electrons Kernel, drivers, real-time and embedded Linux development, consulting, training and support. http://free-electrons.com