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: Documenting Code/Why Is It So Ugly? From:"Huber, Mike" <mrhuber -at- SOFTWARE -dot- ROCKWELL -dot- COM> Date:Tue, 2 Mar 1999 15:55:08 -0500
> From: Rebecca Merck [mailto:Rebecca -dot- Merck -at- ONESOFT -dot- COM]
...
> The really great news is that for most programming languages, the
> spacing is absolutely irrelevant.
Mostly irrelevant. In VB, it is relevant most of the time.
In C, it is relevant for pre-processor commands.
In most languages, a string can't be broken across lines.
So ask the programmer. Few things bother a programmer more than code that won't work when entered exactly as it appears in the manual.
---
Office:
mike -dot- huber -at- software -dot- rockwell -dot- com
Home:
nax -at- execpc -dot- com