Re: Screen-text sample-code

Subject: Re: Screen-text sample-code
From: Kevin McLauchlan <kevinmcl -at- magma -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 27 Jan 2003 20:59:45 -0500


On Monday 27 January 2003 15:58, Mandy Kinne wrote:
> Jan asked about fitting screen text in a
> narrowish column ... Dick suggesting a number
> of ways to conquer the problem, including:
>
> - breaking lines yourself
>
> Tedious, but I've done it using a backslash as
> the last character before the "natural" line
> break - add spaces to line the backslash up
> with the right hand margin, as it would appear
> in a console window and some text editors (vi,
> emacs). Don't forget to let your readers know
> what the backslash is in the Text Conventions
> section in the intro.

Yeah, well.... in the mix of stuff that gets (currently)
my mono-font treatment is the command-line command
with filespec... ya don't wanna be inserting extra "\" or
"/" or "-" characters into a commandline that needs to
be letter-perfect.
(Speaking of which, when all your steps are grammatically
correct, and end with periods, and then you have a
step that ends with a command, what do y'all do?
In most OSes, a trailing period means something.)

The code that I'm usually reproducing has "//" as
the "everything after this point in the line is comment"
indicator. But then, by convention, the comments begin
at a particular tab. I usually shrink the tab settings, in
order to make as much as possible fit, but what usually
happens is that I end up with something // that looks
// annoyingly
// similar
// to this.

(All the "//" should have been vertically aligned, if
your tabs are like my tabs...)

> > 1. Put the tabular matter in a figure and
> > turn the figure on the page--make a landscape
> > page, in other words.
>
> As a reader, I shudder to think of having to
> deal with a landscaped page or section ... I
> avoid this unless, well, it can't be avoided,
> as with wide tables that simply can't be made
> narrower.

Well, as a reader, I don't like it, but I still prefer it
to being required to page to some appendix in
order to view what's referred to in the main text.

An idea that I may resurrect is to use triple-wide
pages in the appendix. The first section is blank,
while the table or illustration is on the second and
third panels. When the page is folded out, the
entire table or illustration is visible, even when
the book is open to a different page.
It works very well, but has the drawbacks of
requiring special (expensive) folding and positioning,
and it makes the printed document thicker. It's also
not a good solution for onscreen PDF viewing...

> > 2. If the tabular matter is numeric, use a
> > narrow version of your text font rather than
> > your monospace font. Numerals are monospace
> > by design, so you can use a condensed font
> > and everything will still line up. Actually,
> > as long as you are setting to tabs, it
> > doesn't really matter whether the tabular
> > material is all numeric or not. The tabs will
> > still align.
>
> A good suggestion, although I'd like to add
> that I replace tab stops with spaces to get
> things to line up properly. First, I replace
> the tab stops in one line to get the columns to
> line up properly, usually a line with the
> longest content in the columns. Then I search
> and replace the tabs with the magic number of
> spaces.

Why? The whole point of tabs is that they line
up, regardless of individual character widths and
font quirks. Besides, there are always headings
for the numeric bits, and those are not "monospace
by design" as he suggested.

> > 3. Manually make the ditches between columns
> > narrower. You are under no obligation to
> > maintain default tab settings that apply in a
> > terminal emulation window.
>
> True, true, but the caveat to fooling with the
> formatting is that it adds extra work to
> document maintenance: you have to make your
> manual changes each time you import the code,
> assuming there are major changes. If there are
> going to be changes often, I'd go with either
> of Dick's next suggestions: put the samples in
> a figure or an appendix.

Probably I can work out something with a rotated
table (if the rotation doesn't ruin anything), cuz
then I might be able to just import other people's
code without touching it.

But that will be something to figure out in OpenOffice.
I keep trying to leave Frame and Word behind,
so I don't need to keep adding more techniques
that I have to leave behind... :-)

/kevin

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A new book on Single Sourcing has been released by William Andrew
Publishing: _Single Sourcing: Building Modular Documentation_
is now available at: http://www.williamandrew.com/titles/1491.html.

Help Authoring Seminar 2003, coming soon to a city near you! Attend this
educational and affordable one-day seminar covering existing and emerging
trends in Help authoring technology. See http://www.ehelp.com/techwr-l2.

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
Re: Screen-text sample-code: From: Mandy Kinne

Previous by Author: Re: dialog versus dialog box revisited
Next by Author: Re: Screen-text sample-code
Previous by Thread: Re: Screen-text sample-code
Next by Thread: Re: Screen-text sample-code


What this post helpful? Share it with friends and colleagues:


Sponsored Ads