cvs commit: doc/en_US.ISO8859-1/books/handbook/disks chapter.sgml

[Wes Peters]

On Wednesday 07 May 2003 10:04, John Baldwin wrote:
> On 07-May-2003 David Schultz wrote:
> >
> > I don't think that there's any requirement that FreeBSD
> > documentation read like a Henry James novel.  Some people have
> > colorful writing styles that involve words such as
> > ``automagical'', ``moot'', and ``kludge'', and I'm not convinced
> > that this is a problem.  Documentation isn't my domain, so I won't
> > stick my nose into this any further, but unless our translators
> > and other non-native English speakers have major qualms about
> > this kind of detail, I do consider this to be gratuitous.
>
> Agreed.  automagical is a favorite word of several folks and does
> have a slightly different connotation from just 'automatic'. :)

In general, documentation sweeps to "clean up" somewhat colorful uses of 
language are not a good idea.  All whining about producing a 
professional product aside, most of us work on FreeBSD because it 
pleases us.  One of these days I'm going to go put the BUGS sections 
back in the AIO man pages and behead anyone who removes them again, for 
instance.

-- 
         "Where am I, and what am I doing in this handbasket?"

Wes Peters                                              wes at softweyr.com