Re: Some reflections on using quickbook

Joel de Guzman wrote:
> Reece Dunn wrote:
> > Joel de Guzman wrote:
> > > Reece Dunn wrote:
>
> > which can be confusing. Ideally, quickbook should fail if the 
> > [section]...[endsect] markers don't match up.
>
> Are you sure Qbk did not give you an error or warning at least?
> I wrote a section matching code there. Even the post processor
> will not succeed if there is an unmatched tag.

Using the latest (CVS) version of quickbook with:

[article Foo]
[section Introduction]
[endsect]
[section Geting Started]
 [section Downloading]
 [endsect]
 [section Building From Source]
 [endsect]

gives...

...found 195 targets...
...updating 3 targets...
quickbook.quickbook-to-boostbook bin\msvc-7.1\release\bbv2.xml
Generating Output File: bin\msvc-7.1\release\bbv2.xml
Warning: Quickbook version undefined. Version 1.1 is assumed
xslt-xsltproc bin\msvc-7.1\release\bbv2.docbook
bin/msvc-7.1/release/bbv2.xml:19: parser error : Opening and ending tag 
mismatch: section line 11 and article
  </article>
            ^
bin/msvc-7.1/release/bbv2.xml:20: parser error : Premature end of data 
in tag article line 3

  ^
unable to parse bin\msvc-7.1\release\bbv2.xml

...so it looks like your section matching logic is broken :(. I have 
also noticed that if there is an error, quickbook does not fail (and 
thus xsltproc is started).

Other things that should fail:

   [section foo]
   ``
   [endsect]
   [section bar]
   ['oops!
   [endsect]

> > the '@' character is being replaced by '#'!
>
> Because @ is not valid c++ code. Use [pre stuff] instead

Ok.

> Hmmm.... maybe we ought to have a source mode == none.

That would help :).

Thanks,
- Reece



-------------------------------------------------------
SF.Net email is sponsored by:
Tame your development challenges with Apache's Geronimo App Server. Download
it for free - -and be entered to win a 42" plasma tv or your very own
Sony(tm)PSP.  Click here to play: http://sourceforge.net/geronimo.php
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs