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:Re: slashes, UNIX, and Windows From:Matt Ion <soundy -at- NEXTLEVEL -dot- COM> Date:Fri, 13 Jun 1997 01:28:50 -0800
On Thu, 12 Jun 1997 14:04:21 -0500, Chris Hamilton wrote:
>I'm writing documentation for a distributed development environment. It
>will run in UNIX and Windows environments. I have to show some
>configuration that includes paths. The problem with that is, slashes go
>one way in UNIX and the othe way in Windows. We're looking for a way to
>represent paths in a way that wouldn't be platform specific. It seems
>mutually exclusive.
>
>Does anyone have any ideas about a way to display this without
>specifying one operating system or another? (I don't think a tree view
>would work.)
And why not be platform-specific? How about an annotation, either as a
footnote, an entry in the glossary, an "IMPORTANT!" reminder at the
beginning - whatever is appropriate for your format - stating, perhaps,
that while examples shown are of the style used by one system, the
other system uses the opposite style.
Then again, most people who use Unix are familiar enough with the
command-line shell to know enough to realize that the slashes need to
be reversed, while your average Windows user thinks Unix is a new type
of candy bar. Using the Windows format of \backslashes\ (or should
that be, \backsl~1\?) is probably a safe enough way to go, with perhaps
a footnote or opening mention that forward slashes are used instead in
the Unix environment.
If you want to really confuse them, point out that OS/2 recognizes both
styles in pathnames (at least, the main command interpreter does - some
programs' command line options may not).
Your friend and mine,
Matt
<insert standard disclaimer here>
----------------------------------------------------------------------------
Of my friend, I can only say this:
Of all the souls I have encountered in my travels,
His was the most... human.
- Adm. James T. Kirk
Spock's Eulogy, Stardate 8141.6
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html