Re: Some reflections on using quickbook

Reece Dunn wrote:
> Joel de Guzman wrote:
> > Reece Dunn wrote:

> Some other things I have noticed...
>
> 1.  If I have
>
> [section foo]
> [section bar]
> [endsect]
>
> quickbook will compile it ok, but xsltproc fails with:
>
> bin/msvc-7.1/release/bbv2.xml:640: parser error : Opening and ending tag 
> mismatch: section line 40 and article
>   </article>
>             ^
>
> 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.

> 2.  windows.qbk
>
> In this Windows batch file:
>
>    @ECHO OFF
>    set FOO=BAR
>
> the '@' character is being replaced by '#'!

Because @ is not valid c++ code. Use [pre stuff] instead

> 3.  shell.qbk
>
> In this shell script:
>
>    # do something
>    export FOO=BAR
>
> the '#' character isn't changed, but the block is treated like a C++ 
> fragment (with syntax highlighting) which I would like to disable.

Ditto. Use [pre stuff] instead. Or, if you are adventurous,
you might want to add a syntax highlighter for that. It's not
difficult.

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

Cheers,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net



-------------------------------------------------------
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