From owner-freebsd-doc  Mon May 14 16:51: 4 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75])
	by hub.freebsd.org (Postfix) with ESMTP
	id 71FDA37B43E; Mon, 14 May 2001 16:50:59 -0700 (PDT)
	(envelope-from brdavis@odin.ac.hmc.edu)
Received: (from brdavis@localhost)
	by odin.ac.hmc.edu (8.11.0/8.11.0) id f4ENodv04461;
	Mon, 14 May 2001 16:50:39 -0700
Date: Mon, 14 May 2001 16:50:39 -0700
From: Brooks Davis <brooks@one-eyed-alien.net>
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: <20010514165039.A1938@Odin.AC.HMC.Edu>
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>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="u3/rZRmxL6MmkK24"
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <014a01c0dccf$5926cd30$0300a8c0@oracle>; from dougy@gargoyle.apana.org.au on Tue, May 15, 2001 at 09:41:04AM +1000
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


--u3/rZRmxL6MmkK24
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

[Please, please, please, but a real mailer that quotes properly.
Reading your message was truly painful.]

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

FreeBSD docs are written in a markup language called DocBook (they used
to be written in LinuxDoc.)  DocBook indicates what the text of the
document *is* rather then how it should look.  See the FreeBSD
Documentation Project Primer for more info:

http://www.freebsd.org/doc/en_US.ISO_8859-1/books/fdp-primer/

> No prob ..... theres at least a million areas where a simple
> screenshot would assist
> considerably.  What graphic formats are compatible though .....
> hopefully jpg & gif ??

PNG for screenshots and the like.  EPS for vector drawings (hopefully
we'll eventualy switch to SVG.)  I supposed JPG would be of for real
photos.

-- Brooks

--=20
Any statement of the form "X is the one, true Y" is FALSE.
PGP fingerprint 655D 519C 26A7 82E7 2529  9BF0 5D8E 8BE9 F238 1AD4

--u3/rZRmxL6MmkK24
Content-Type: application/pgp-signature
Content-Disposition: inline

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

iD8DBQE7AG9OXY6L6fI4GtQRAiKTAJ9SQaDvxMd5rxqHm8bAqwhYZz2GoACfaQZ+
1/Y1P9aU+s+fZRk7cN3qH6s=
=ZwVT
-----END PGP SIGNATURE-----

--u3/rZRmxL6MmkK24--

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