Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 15 May 2001 10:13:26 +0100
From:      Nik Clayton <nik@freebsd.org>
To:        Doug Young <dougy@gargoyle.apana.org.au>
Cc:        Nik Clayton <nik@freebsd.org>, Sue Blake <sue@welearn.com.au>, freebsd-docs@freebsd.org, Rahul Siddharthan <rsidd@physics.iisc.ernet.in>, Kathy Quinlan <katinka@magestower.com>, N6REJ <n6rej@tcsn.net>
Subject:   Re: (was) I'm leaving, now something like "anti official docs rant" :)
Message-ID:  <20010515101325.E22370@catkin.nothing-going-on.org>
In-Reply-To: <014a01c0dccf$5926cd30$0300a8c0@oracle>; from dougy@gargoyle.apana.org.au on Tue, May 15, 2001 at 09:41:04AM %2B1000
References:  <002b01c0db54$e0febaa0$5599ca3f@disappointment> <20010513171444.E26123@welearn.com.au> <00f401c0db7e$ff3ca2a0$fe00a8c0@kat.lan> <20010513122623.I97034@lpt.ens.fr> <20010514084709.A68348@welearn.com.au> <024b01c0dc05$b1314fc0$0300a8c0@oracle> < <20010514182156.A22370@catkin.nothing-going-on.org> <014a01c0dccf$5926cd30$0300a8c0@oracle>

next in thread | previous in thread | raw e-mail | index | archive | help

--n+lFg1Zro7sl44OB
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Tue, May 15, 2001 at 09:41:04AM +1000, Doug Young wrote:
> I'll need the source (presumably you're using LinuxDoc) and all the
> images.
>=20
> Whats "LinuxDoc" ?? ..... I'll have it known that I've never been
> guilty of using stuff from linux :). I write mostly in either W2K / notep=
ad
> or Solaris / StarOffice & then change the .txt extension to .html when
> I'm finished

Fine.  The look of the document (and the navigation) were reminiscent of
some automatic HTML converters, so I'd assumed you'd used those.

If you could tar up the whole lot and send it to me, that'd be great.

> The following documents feature diagrams:
>=20
> http://www.freebsd.org/doc/en_US.ISO_8859-1/books/design-44bsd/index.h
> tml
> http://www.freebsd.org/doc/en_US.ISO_8859-1/books/corp-net-guide/index
> .html
>=20
> When I remember to turn it on in the build, so will
>=20
> http://www.freebsd.org/doc/en_US.ISO_8859-1/articles/vm-design/index.h
> tml
>=20
> Praise be !!!!!!!! ..... the official docs might even make it into the
> 19th century someday
> if you keep that up :) The mind doth boggle how you got those past the
> old guard.

As far as the doc. project goes, I *am* the old guard.

> Some of us just don't have the artistic skills.  If you would like to
> submit a picture or diagram to go with any of the documentation,
> please
> do so, preferably using send-pr.
>=20
> No prob ..... theres at least a million areas where a simple
> screenshot would assist
> considerably.  What graphic formats are compatible though .....
> hopefully jpg & gif ??

Depends on the nature of the graphic.  If it's a screen shot, or similar
image, please send in GIFs, PNGs, or high quality JPEGs.  Do not do any
compression of the JPEGs, since the doc. infrastructure will do that=20
automatically, as necessary.

If it's line art, like a network diagram, or similar, then either send
EPS, or, if you used a package like xfig to do the diagrams, send in the
original .xfig file (or whatever).

> Or that it's better served by the asking the XFree86 people?
>=20
> Maybe ..... I would have thought that applications included as a
> "standard" package / port should receive more than a token coverage
> in the docs, but I guess its not as it everyone hasn't sufficient=20
> more specifically FreeBSD stuff to mess with.=20

Documentation doesn't magically appear.  People need to write it.
No one is paid to write it, so people write what they feel comfortable
talking about.

I, for one, know very little about the ins and outs of video cards on X.

> yeah well I guess at $AU400 per unit it b****y well should work !!!!!!

Emigrate.  It was about GBP 150 when I bought it, and that was four
years ago.

> I had in mind more "common or garden" variety things like S3 Virge /=20
> Tseng ET4000 & ET 6000 / ATI Rage Pro / etc that regular folk can=20
> afford without taking out a mortgage on the house.

So I went to=20

    http://sunsite.doc.ic.ac.uk/XFree86/4.0.2/index.html

which is my nearest mirror of the XFree86 site.  Links there include

    * Driver Status for XFree86 4.0.2
    * Information for S3 ViRGE users
    * ATI Adapters README file

and more.  All of which contains information about the supported or
unsupported state of a myriad of graphics cards.

N
--=20
FreeBSD: The Power to Serve             http://www.freebsd.org/
FreeBSD Documentation Project           http://www.freebsd.org/docproj/

          --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---

--n+lFg1Zro7sl44OB
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.5 (FreeBSD)
Comment: For info see http://www.gnupg.org

iEYEARECAAYFAjsA8zUACgkQk6gHZCw343VCdgCdF7GKj/uNwI9rkbyLjFfqH4oo
uYkAnROSoq8WXN75Ajj9p41xl1JBPZKW
=whHF
-----END PGP SIGNATURE-----

--n+lFg1Zro7sl44OB--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010515101325.E22370>