Re: Some reflections on using quickbook

Joel de Guzman wrote:
> Reece Dunn wrote:
> > Joel de Guzman wrote:
> > > Reece Dunn wrote:
> > > > 5.  Code fragments spanning multiple lines retain all whitespace, 
> > > > thus the code fragment:
> > > >
> > > > [For example:
> > > >   ``int foo()
> > > >     {
> > > >        std::cout << "bar" << std::endl;
> > > >     }``
> > > > ]
> > > >
> > > > gets incorrectly formatted w.r.t. spacing.
> >
> > Ideally, I'd like it to see the opening `` and note the number of 
> > whitespace before it (adding two for the `` marker) then removing that 
> > much whitespace from each subequent line, giving:
>
> Yeah. Acknowledged. I'll see if there's a nice way
> around this. I think this should be fixed in preparation
> to the planned Lit programming support with code stacks
> and all.

Cool! Thanks :).

> > The table row containing "Foo" will compile cleanly, but "Bar" will 
> > generate syntax errors (note the additional line spacing).
>
> Yep. Phrases, in general, cannot have double newlines,
> except if they are in a pre markup. It might be possible
> to allow double newlines in block_markup(s) because the
> closing bracket terminates it anyway. I'll see if that can
> be done.

Thanks.

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.

2.  windows.qbk

In this Windows batch file:

   @ECHO OFF
   set FOO=BAR

the '@' character is being replaced by '#'!

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.

- 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