Displaying 18 results from an estimated 18 matches for "boostbook".
2010 Aug 20
2
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...nverter from html to quickbook for a
simple and quick conversion.
On Wed, Aug 18, 2010 at 4:55 PM, David A. Greene <greened at obbligato.org> wrote:
> OvermindDL1 <overminddl1 at gmail.com> writes:
>>> It would be a great contribution if someone could port the
>>> BoostBook/QuickBook build to make and completely divorce it from Boost
>>> proper. It's a tool a lot of projects could really use, IMHO.
>>
>> QuickBook itself uses Boost.Spirit as the parser and the regex engine
>> inside Boost, to separate that from Boost 'would' be...
2010 Aug 20
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
AMDG
OvermindDL1 wrote:
> On Wed, Aug 18, 2010 at 5:03 PM, Chris Lattner <clattner at apple.com> wrote:
>
>> On Aug 18, 2010, at 4:01 PM, David A. Greene wrote:
>>
>>> And the fact that Boostbook knows how to import Doxygen XML output is a
>>> killer feature. Having a hardcopy of the Doxygen reference can be
>>> really useful.
>>>
>>> I agree with Chris that at the moment, BoostBook/QuickBook is too hard
>>> to set up. I'm certainly not abo...
2010 Aug 18
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Aug 18, 2010, at 4:01 PM, David A. Greene wrote:
> And the fact that Boostbook knows how to import Doxygen XML output is a
> killer feature. Having a hardcopy of the Doxygen reference can be
> really useful.
>
> I agree with Chris that at the moment, BoostBook/QuickBook is too hard
> to set up. I'm certainly not about to use bcp magic and litter my
>...
2010 Aug 18
2
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...ore
> prevalent than Sphinx and more well known. The useful thing about
> quickbook over Sphinx is it is designed for C++ project documentation
> in a variety of formats, from html pages, single html document, pdf,
> man pages, straight docbook, etc...
What he said.
And the fact that Boostbook knows how to import Doxygen XML output is a
killer feature. Having a hardcopy of the Doxygen reference can be
really useful.
I agree with Chris that at the moment, BoostBook/QuickBook is too hard
to set up. I'm certainly not about to use bcp magic and litter my
workspace with it. Get it pac...
2010 Aug 17
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Tue, Aug 17, 2010 at 4:06 PM, David A. Greene <greened at obbligato.org> wrote:
> OvermindDL1 <overminddl1 at gmail.com> writes:
>
>> On Tue, Aug 10, 2010 at 1:09 PM, David A. Greene <greened at obbligato.org> wrote:
>>> BoostBook/QuickBook is really cool but I found it nearly impossible to
>>> use outside of the Boost tree. In other words, a few years ago, at
>>> least, it was intimately tied to the Boost project. That may have
>>> changed recently, I don't know.
>>
>> What of it...
2010 Aug 17
4
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Tue, Aug 17, 2010 at 11:09 PM, David A. Greene <greened at obbligato.org> wrote:
> Please do. 7z is not supported on Linux.
Does not this work?
http://packages.debian.org/lenny/p7zip-full
Eugene
2010 Aug 12
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Mon, Aug 9, 2010 at 11:29 PM, Michael Spencer <bigcheesegs at gmail.com> wrote:
> You are right that BoostBook is targeted directly for large C++
> projects, and I seriously considered BoostBook for this project, but
> ran into a few road blocks.
>
> * It's tightly integrated into boost and makes quite a few assumptions
> about that.
What assumptions is that?
On Mon, Aug 9, 2010 at 11:...
2010 Aug 10
3
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...t; #. Finish moving over the docs.
>> #. Finish Sphinxifying them.
>
> Can this be done incrementally? It would be great to start with one doc (like LangRef) and make it really really good and get the infrastructure right, then move on to other docs (which others might help out with).
BoostBook is a simplification of DocBook, with many things specific
for C/C++ source. it can pull in parts of a source file so the doc
examples always show examples of code that is actually tested, it has
proper links to source code files, can integrate with doxygen with a
bit of work, can export to html, p...
2010 Aug 10
8
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...thing
>> running smoothly.
>
> I strongly support this. I've been interested in moving the documentation over to a better system for a long time, but the only decent one I've known about was docbook, which is ... a bit more complicated than I hoped we'd need. :-)
That and BoostBook are all I had heard of either until Daniel popped
into the conversation and mentioned Sphinx.
===================================================================================================
I will also use this space to reply to OvermindDL1 instead of writing
two emails.
You are right that B...
2010 Aug 15
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...apter's in there, but the rest are empty, I just
included them to let all the links work.
If there is a specific example that you want demonstrated, just say.
To build the example yourself, just put the two qbk files and the
Jamroot in a directory, make sure you have boost's quickbook and
boostbook built, then just do:
/path/to/bjam
and it will build the multi-part html by default, or of course do:
/path/to/bjam -n
to see what it is doing instead, which basically involves just
creating a system-customized link to the dtd and xsl and such
directories in boostbook (if LLVM used this then yo...
2010 Aug 10
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Aug 8, 2010, at 11:29 PM, Michael Spencer wrote:
>
> What Do You Think?
> ------------------
>
> I realize that changing the documentation format is non-trivial, but I believe
> that the benefits are worth the effort. If we go forward with this I will finish
> the first two points above and work to integrate doxygen and keep everything
> running smoothly.
I strongly
2010 Aug 09
5
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
Moving the LLVM Documentation to Sphinx
=======================================
As a few of you that are on IRC already know, I have experimented with moving
the LLVM documentation over to `Sphinx <http://sphinx.pocoo.org/index.html>`__
from the current html form. I have moved almost all of the content over and have
begun "Sphinxifying" the documentation to correct links and make
2010 Aug 15
1
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
...l the links work.
>>>
>>> If there is a specific example that you want demonstrated, just say.
>>>
>>> To build the example yourself, just put the two qbk files and the
>>> Jamroot in a directory, make sure you have boost's quickbook and
>>> boostbook built, then just do:
>>> /path/to/bjam
>>> and it will build the multi-part html by default, or of course do:
>>> /path/to/bjam -n
>>> to see what it is doing instead, which basically involves just
>>> creating a system-customized link to the dtd and x...
2010 Aug 17
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Tue, Aug 17, 2010 at 5:25 PM, Chris Lattner <clattner at apple.com> wrote:
>
> On Aug 17, 2010, at 3:42 PM, OvermindDL1 wrote:
>
>>
>> On Tue, Aug 17, 2010 at 4:09 PM, David A. Greene <greened at obbligato.org> wrote:
>>> OvermindDL1 <overminddl1 at gmail.com> writes:
>>>
>>>> Correction, even the zip by itself is too big,
2010 Aug 17
3
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Aug 17, 2010, at 3:42 PM, OvermindDL1 wrote:
>
> On Tue, Aug 17, 2010 at 4:09 PM, David A. Greene <greened at obbligato.org> wrote:
>> OvermindDL1 <overminddl1 at gmail.com> writes:
>>
>>> Correction, even the zip by itself is too big, here is the 7z, if
>>> someone wants a giant zip, I can host it somewhere...
>>
>> Please do. 7z
2008 Dec 10
2
[LLVMdev] Using ReST for documentation
> Can you compare ReST to docbook? We've talked about using docbook for
> a long time. What are the pros and cons of each?
I have no experience with DocBook, but it seems that since it is XML-based it
should also suffer from verbosity issues. For example, the Boost project, which
originally used plain DocBook, decided to build a new ReST-like documentation
format[1] on top of it.
[1]
2008 Dec 10
0
[LLVMdev] Using ReST for documentation
I have to give a vote for Boosts QuickBook as well. Nicely made
system with a few code related features (considering it is used for
documenting C++ libraries).
2010 Aug 12
0
[LLVMdev] [RFC] Moving to Sphinx for LLVM and friends documentation (with partial implementation (in both 10pt and 12pt font)).
On Thu, Aug 12, 2010 at 5:28 PM, Aaron Gray <aaronngray.lists at gmail.com> wrote:
> Can you do a quickish test and example, of LLVM doc using BoostBook ?
> I don't want to vote on group quite yet for political reasons.
> +1
> Aaron
I could, but it may take a little bit, time is something I do not have
currently, but as long as someone keeps poking/reminding me daily then
I shall.