Re: Code screens

[Bill Burns <BillDB -at- ILE -dot- COM>]

John writes:

> Question.  When you are placing a frame in your document that contains
> sample code, do you allow the page to break in the middle of the code
> and have it split between pages or do you make sure that if it can fit
> on one page, it all stays on the same page, even if it means having a
> large space of information at the bottom of the previous page.  In
> other
> words, do you treat it as a list or a graphic?
>
I don't wory about page breaks, since a piece of code can go on for
quite a while, depending on how many subprocedures it may have embedded
in it and how many routines have to be run. I DO worry about line length
and word wrap. For some code, distinguishing between a line break and a
piece of code that wouldn't fit on a single line is crucial. That said,
if the code is going to leave a single line at the top of the next page,
I try to adjust it to break more gracefully.

One question about your last query--do you really mean you're using
Arial to avoid alignment issues while formatting the code? I typically
use a monospaced typeface like Courier for this reason.

Bill Burns
Senior Technical Writer
ILE Communications Group
billdb -at- ile -dot- com


Posts: mailto:techwr-l -at- listserv -dot- okstate -dot- edu
Commands: mailto:listserv -at- listserv -dot- okstate -dot- edu (e.g. SIGNOFF TECHWR-L)
Archives: http://listserv.okstate.edu/archives/techwr-l.html,
	http://www.documentation.com/, or http://www.dejanews.com/
Subjects: JOB:, QUESTION:, SUMMARY:, ANNOUNCE:, or none of these.