David Ashley <[email protected]> wrote:

> The document looks outstanding!

It's certainly polished, in places.  I just looked at some pages at random
though and found one problem, where the shaded box around a syntax diagram
straddles a page break - for 5.18 SockRecv at the foot of page 24.

Similarly (though not as bad) see "7.2.16 state" at the foot of p55. 

And at the foot of p36 there's a "where" that's not connected with the text
it introduces.


I've never used XML or DocBook, but did long ago use IBM's DCF/Script
package, writing macros for quite complex 3-pass processing of documents
(where the macros did different things on different passes).  Script had
control words (dot commands) for bracketing sections of text that should not
be broken up, and others eg to force a page break if there was insufficient
space at the foot of one page to start a new section of a document.  (These
things only got used if one wrote macros that issued them with appropriate
arguments in appropriate places.)

The output from this system looks a lot like it's created nice looking text
but just poured it onto a series of pages without taking page-breaks into
account.


-- 
Jeremy Nicoll - my opinions are my own

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Oorexx-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-devel

Reply via email to