TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:"This Multi-Line Actually Is One Line" graphics? From:"techwrl-list-only -at- doitall -dot- com" <techwrl-list-only -at- doitall -dot- com> To:TECHWR L <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 06 Aug 2003 15:55:27 -0400
Techwrl-ers,
There some cases for code snippets and configuration files that I must show
example lines and there is no way that all lines will fit one line within
the manual.
Yes, there are MANY cases that can I can finesse so there is no problem. For
instance, simplifying the example or changing variable names in examples to
be shorter. In some computer languages, white space is *ignored* so I can
safely show the second half of the line on the next physical line and there
is no big deal.
But some computer languages and systems DO care about the type of white
space and moving the second half of a line to the next line makes it
syntactically invalid!
Also, some configuration ".ini" file lines must be quite long for our
product and cannot contain new line characters at all!
1) Is there a True Standard (either typographically, graphically, or
descriptively) for this type of cases where it *cannot* be avoided?
2) If I were to want to use a special symbol for "this wraps to the next
line in the example, but not in the real thing", are there STANDARD symbols
or at least non-ugly ones that people can send to me or point me to? :-)
I would include this symbol in my Typographical Conventions section at the
beginning, and also make intratextual comments about it where appropriate
and not too clunky style-wise.
Any URLs or books on this subject would be appreciated.
Thoughts?
-- JX
P.S. Please assume for the context of this question that I cannot go to
landscape mode, change the font or font size, or change the basic page
layout.