diff --git a/en/docproj/docproj.sgml b/en/docproj/docproj.sgml index 28752ce2e7..6c5e508204 100644 --- a/en/docproj/docproj.sgml +++ b/en/docproj/docproj.sgml @@ -1,82 +1,82 @@ - + %includes; ]> - + &header;

Overview

Getting to grips with a new and complex operating system is always a difficult task, no matter how pretty the GUI is. FreeBSD is no different in this respect.

While there are a vast number of BSD Unix (and general Unix) books +

While there are a vast number of BSD Unix (and general &unix;) books available, FreeBSD has its own unique features, procedures and quirks.

In addition, FreeBSD will be the first exposure to a Unix-like operating system for many of its users, so the availability of high quality, accurate documentation is paramount.

The FreeBSD Documentation Project exists to help fill this gap. There are two ways in which this is undertaken:

Members of the Documentation Project write documentation and submit it for inclusion in the FreeBSD Documentation Set.
Members of the Documentation Project discuss and arrange the formatting and organisation of the FreeBSD Documentation Set.

Current projects

There are a number of projects currently in progress as part of the documentation effort. Please take the time to look over this list and see if there is anything you can help with.

Who we are, how to join

This page explains who makes up the Documentation Project, and how you can join.

The FreeBSD Documentation Set

This page outlines the components of the FreeBSD Documentation Set, and the sort of work that the Documentation Project does with them.

SGML and the Documentation Project

The project is trying to use SGML for the documentation. This page outlines how this is accomplished, and directs the interested reader to further SGML resources.

Submitting Documentation

Submitting documentation is the best way to become a part of the project, and help make FreeBSD easier to use. This page explains the best way to submit documentation so that it gets looked at as soon as possible.

Translation

Translations of the FreeBSD documentation, Web pages, Handbook, Manual pages and FAQ.

&footer diff --git a/en/docproj/sgml.sgml b/en/docproj/sgml.sgml index 5620fec830..c03d68fc1f 100644 --- a/en/docproj/sgml.sgml +++ b/en/docproj/sgml.sgml @@ -1,166 +1,166 @@ - + %includes; ]> &header;

The Documentation Project is trying to use SGML as the standard method of representing the documentation.

SGML is the Standard Generalised Markup Language.

In a nutshell (and apologies to any SGML purists in the audience that are offended) SGML is a language for writing other languages.

You have probably already used SGML, but you did not know it. HTML, the language that web pages are written in, has a formal description. That description is written in SGML. When you are writing HTML you are not writing SGML (per se), but you are using a language that is defined using SGML.

There are many, many markup languages that are defined using SGML. HTML is one of them. Another is called "LinuxDoc". As you can probably guess, it was originally created by the Linux documentation group to write their documentation, and the FreeBSD Documentation Project adopted it as well.

Another markup language defined using SGML is called "DocBook". This is a language designed specifically for writing technical documentation, and as such it has many tags (the things inside the <...>) to describe technical documentation related things.

For example, this is how you might write a brief paragraph in HTML (do not worry about the content, just look at the tags):

The system's passwords are stored in /etc/passwd. To edit this file you should use vipw. However, if you just want to add a new user you can use adduser.

]]>

The same paragraph, marked up using DocBook, looks like

The system's passwords are stored in
       /etc/passwd. To edit this file you should use
       vipw. However, if you just want to add a new user
       you can use adduser.
 ]]>

As you can see, DocBook is much more 'expressive' than HTML. In the HTML example the filename is marked up as being displayed in a 'typewriter' font. In the DocBook example the filename is marked up as being a 'filename', the presentation of the filename is not described.

There are a number of advantages to this more expressive form of markup:

It is not ambiguous or inconsistent.

You do not spend time thinking "Hmm, I need to show a filename, should I use 'tt', or 'b', or 'em'?"

Instead, you just use the right tag for the right job.

The conversion process from DocBook to other formats (HTML, - Postscript, and so on) makes sure that all <filename>'s are + PostScript®, and so on) makes sure that all <filename>'s are shown the same way.
You stop thinking about the presentation of your document, and instead concentrate on the content.
Because the documentation is not tied to any particular output format, the same documentation can be produced in many different - formats - plain text, HTML, Postscript, RTF, PDF and so on.

The documentation is more 'intelligent', so more intelligent things can be done with it. For example, it becomes possible to automatically produce an index of the documentation that lists every command shown in the documentation.

If you are familiar with them, this is a bit like Microsoft Word +

If you are familiar with them, this is a bit like Microsoft® Word stylesheets, only vastly more powerful.

Of course, with this power comes a price;

Because the number of tags you can use is much larger, it takes longer to learn all of them, and how to use them effectively.

I found the best way to learn was to read the source to lots of example documents, seeing how other authors had written similar information.
The conversion process is not that simple.

Right now, the Project is still using LinuxDoc for the Handbook and the FAQ. That's changing, and in particular there's a project underway to convert the documentation to DocBook.

What if you don't know LinuxDoc/DocBook? Can you still contribute?

Yes you can. Quite definitely. Any documentation is better than no documentation. If you've got some documentation to contribute and it's not marked up in LinuxDoc or DocBook, don't worry.

Submit the documentation as normal. Someone else on the Project will grab your committed documentation, mark it up for you, and commit it. With a bit of luck they'll then send you the marked up text back. This is handy because you can do a "before and after" shot of the plain documentation and the marked up stuff, and hopefully learn a bit more about the markup in the process.

Obviously, this slows down the committing process, since your submitted documentation needs to be marked up, which may take an evening or too. But it will get committed.

More information about SGML and DocBook?

You should first read the Documentation Project Primer. This aims to be a comprehensive explanation of everything you need to know in order to work with the FreeBSD documentation.

This is a long document, split in to many smaller files. You can also view it as one large file.

http://www.oasis-open.org/cover/sgml-xml.html: The SGML/XML web page. Includes countless pointers to more information about SGML.
http://www-sul.stanford.edu/tools/tutorials/html2.0/gentle.html: The "Gentle Introduction to SGML". Recommended reading for anyone who wants to learn more about SGML from a beginners perspective.
http://www.oasis-open.org/docbook/: The DocBook DTD is maintained by OASIS. These pages are aimed users who are already comfortable with SGML, and who want to learn DocBook.

FreeBSD Documentation Project Home &footer; diff --git a/en/donations/donors.sgml b/en/donations/donors.sgml index 0e1c868d49..67d8d2fae8 100644 --- a/en/donations/donors.sgml +++ b/en/donations/donors.sgml @@ -1,675 +1,675 @@ - + %includes; %developers; ]> &header;

This page keeps a record of current hardware transactions taking place under the donations team. These are only completed or believed to be completed transactions. If something was offered but never shipped to anyone, please do not list it here. If you see any mistakes, please send an email to trhodes@FreeBSD.org so that I may correct it. Feel free to cc: donations@FreeBSD.org as well.

- +

FROM	ITEM	TO	STATUS
`nsayer`	4-port Zynx 'dc' NIC	jlemon	Unknown
`Sebastian Trahm <inthisdefiance@gmx.net>`	Packet Engines G-NICII 1000SX/PCI	will	Received
`donxc <donald.creel@verizon.net>`	ATI Rage Pro 128	anholt	Shipped
`Stephen Hoover <shoover@442spot.com>`	Pentium III 1GHz 133FSB, 512MB PC133 RAM, Asus TUSL2-C motherboard (815EP chipset), Intel 82559 (PILA8460B) 10/100 NIC, 52X CD-ROM, floppy, case w/250W power supply w/case fan	kris	Received
`Salvatore Denaro <sdenaro@speakeasy.net>`	512MB DDR ECC DIMM	obrien	Received
`Frank Nikolajsen <frank@warpspace.com>`	Three 533MHz 21164A CPU PC164SX (AlphaPC) motherboards	Ports Cluster (obrien/peter)	Received
`William Gnadt <wgnadt@rri-usa.org>`	PCMCIA CD-ROM drive (Addonics), USB 1.1 HD enclosure w/850MB HD	imp, bsd	CD-ROM shipped to imp, HD enclosure shipped to bsd
`William Gnadt <wgnadt@rri-usa.org>`	Seagate Cheetah 10K RPM 9GB UW-SCSI HD Model: ST19101W / 68-pin connector, new dual-fan HD cooler	dannyboy	Received
`William Gnadt <wgnadt@goliath.rri-usa.org>`	Dell Inspiron 3000 laptop (Pentium 266MHz, 64MB RAM, floppy and CD-ROM drives, docking station, PCMCIA Ethernet/modem card, extra power supply -- good condition	imp	Received
`William Gnadt <wgnadt@goliath.rri-usa.org>`	PCMCIA cards: "New Media" 28.8 modem (unknown model #), Linksys 33.6 LANmodem (model PCMLM36), Linksys combo ethernet card (model EC2T), 3COM 3C905B Ethernet 10/100B-T network adapter (PCI)	PCMCIA cards to imp, 3COM nic to silby	PCMCIA cards shipped. 3COM nic shipped.
`William Gnadt <wgnadt@goliath.rri-usa.org>`	2.5" laptop HDs: Toshiba HDD2714 - 1443MB Toshiba HDD2731 - 1083MB	darrenr	Awaiting Shipment
`William Gnadt <wgnadt@goliath.rri-usa.org>`	68-pin M-M SCSI cable 1 meter (brand new)	mwlucas	Received
`Simon Chang <schang@quantumslipstream.net>`	Dual Pentium Pro 200MHz (both CPUs and VRMs included), 128 MB of RAM 10-GB IDE hard disk drive, IDE CD-ROM drive, one old 3Com 3C509B-TPO network card	will	Received
`gj`	pc164 (Alpha)	sos	Received
`Michael Hembo <hembo@micron.dk>`	4 * 512 MB PC133 SIMM (for ftp.FreeBSD.org)	jesper	Received
`trhodes`	40GB IDE HDD	rwatson	Received
`jesper on behalf of TDC Tele Danmark`	AlphaStation 255/233	sos	Received
`<Aaron.Schroeder@qg.com>`	384MB RAM for an AlphaStation 500	wilko	Received
`DEC/Compaq`	AS2100 SMP	trevor	Received
`Compaq (on behalf of wilko)`	DS10	murray, obrien, package cluster	Received
`HP (on behalf of wilko)`	AlphaServer 1000A	markm	Received
`Rolf Huisman`	Abit BP6 dual CPU mainboard	wilko	Received
`Stefan Molnar <stefan@csudsu.com>`	Sun X6540A dual-channel Symbios 53C876 SCSI card (w/FCode)	jake	Received
`obrien`	Hitachi ATAPI CDR-7730 cdrom drive	sos	Received
`obrien`	DEC Alpha PWS 2MB B-cache module	gallatin	Received
`obrien`	fxp(4), xl(4), pcn(4), dc(4) NIC's; Adaptec AHA-2940UW; Sun HD/68-pin UW-SCSI cable	jake	Received
`obrien`	KVM Switch	kris	Received
`obrien`	several AMD Athlon Slot-A 8[05]0 MHz CPUs	gshapiro,gj,fjoe,wilko,mdodd	wilko, mdodd, gshapiro received; fjoe shipped thru wilko; others pending
`obrien`	AMD Athlon Slot-A 800 MHz CPU + Gigabyte GA-7IXE motherboard + 256 MB RAM	kris	Received
`obrien`	2x550 MHz Pentium-III system with 256MB RAM, CDROM, multiple NIC's	scottl	Received
`obrien`	nVidia GeForce2 Pro, GeForce 256, Riva TNT2, Riva TNT AGP video cards. nVidia GeForce2 MX400, MX200, TNT2 PCI video cards.	mdodd	Received
`obrien`	Sun SPARCengine AXi "Panther" 300MHz UltraSparc-IIi with 256MB RAM, 9GB SCSI UW disk	FreeBSD.org cluster	Received
`obrien`	Sun Ultra-1 with 128MB RAM, CDROM, 2GB SCA disk	scottl	Received
`obrien`	two fxp(4), one pcn(4) Ethernet cards	rwatson	Received
`obrien`	AMD Slot-A 900 MHz CPU + Gigabyte GA-7IXE motherboard + 128MB RAM + 10 GB and 8 GB IDE disks + 3Com 905c-TX + nVidia GeForce2 GTS 64MB AGP video card	jake	Received
`obrien`	Matrox G400 AGP dual-head, 2x Celeron socket-370 366, Athlon 900 Slot-A, DIMMs	wilko	Received
`obrien`	Adaptec 3940UW	njl	Received
`gordont`	Sun Ultra-2 SMP 400 MHz with 1GB RAM, 2x 4GB SCA disks	jake	Received
`gordont`	Sun Ultra-2 200 MHz with 512MB RAM, 2GB SCA disk	obrien	Received
`Nick Jeffrey <nick@jeffrey.com>`	2x 9GB SCA SCSI disks	jake	Received
`kan`	Matrox Millenium II PCI video card	nsouch	Received
`wilko`	Winbond ISDN card	hm	Received
`wilko`	21264/550 EV6 Alpha CPU	obrien	Received
`wilko`	Athlon 850 Slot-A, 64MB DIMM	fjoe	Received
`unfurl`	2x550 MHz 440GX Pentium-III	rwatson	To be shipped
`NcFTP Software / Mike Gleason <mgleason@ncftp.com>`	NcFTPd Server site license for FreeBSD.org	jesper	Received
`Michael Dexter`	Yamaha SCSI CDRW drive	wilko	Received
`wilko`	Cologne Chip Design PCI ISDN card and Compaq ISA ISDN card	hm	Received
`William Gnadt <wgnadt@rri-usa.org>`	IBM Travelstar DJSA-210 Laptop Hard Drive, 10.06GB	jesper	Received
`mbr`	10 Gigabyte Hard Disk Drive	sos	Awaiting Shipment
`The Open Group`	Single UNIX Specification (Version 3) books and CD-ROMs.	Single &unix; Specification (Version 3) books and CD-ROMs.	mike (and -standards)	Received
`William Gnadt <wgnadt@rri-usa.org>`	SoundBlaster 128 PCI	mike	Received
`Matt Douhan <mdouhan@fruitsalad.org>`	Two Sony AIT-1 tape drives	will	Received
`William Gnadt <wgnadt@rri-usa.org>`	Toshiba MK6411MAT, 6495MB	des	Received
`HP (on behalf of wilko)`	AlphaServer 1000A	phk	Received
`brueffer`	SMC Etherpower II (tx) NIC	mux	Received
`Mike Tancsa, Sentex`	2 remote machines: releng4.sentex.ca: Intel Celeron CPU 2.00GHz (2000.35-MHz 686-class CPU) real memory = 528416768 (516032K bytes), 19595MB QUANTUM FIREBALLP LM20.5 UDMA66 releng5.sentex.ca: Intel Pentium III/Pentium III Xeon/Celeron (866.38-MHz 686-class CPU) real memory = 796852224 (759 MB), 19595MB QUANTUM FIREBALLP LM20.5 UDMA66	FreeBSD Security Team (nectar)	In use
`Mike Tancsa <mike@sentex.net>`	IBM smart cards (PCMCIA and serial port)	des	Received
`fenner`	AST FourPort/XN ISA serial card	jwd	Received
`Ryan Petersen <rpetersen@4imprint.com>`	Sun Microsystems Sparc Ultra 5	FreeBSD.org cluster	Received
`Chris Knight <chris@e-easy.com.au>`	56K PCMCIA Data/Fax modem	trhodes	Received
`wes`	Dual processor motherboard for Intel Celerons	des	Received
`Craig Rodrigues <rodrigc@attbi.com>`	ATI Graphics Xpression PCI 2 MB	nsouch	Received
`Gregory P. Smith <greg@electricrain.com>`	DEC Alpha PC164SX mobo+CPU, 2x 64MB ECC DIMM's, UW SCSI controller, 10/100 NIC	FreeBSD.org cluster	Received
`gallatin`	Alpha 433au system	will	Received
`Brian Cunnie <brian@cunnie.com>`	DDS-3 scsi tape drive (12GB raw/24GB compr), SCSI terminator, SCSI cable (50-pin hi-density single-ended), and several DDS-3 tapes.	kris	Received
`unfurl`	Dual Pentium 550MHz system	rwatson	Received
`Niles Ingalls <niles@atheos.net>`	Sun AXI motherboard/CPU 360Mhz with a pci video card.	obrien	Unknown (I'll ask obrien)
`James Pace <jepace@pobox.com>`	HP Omnibook 4000 ct 4/100, and an HP Omnibook 5000 cts 5/90 model 1200	imp	Received
`murray`	Hard copy of Docbook: The Definite Guide	ceri	Received
`Christoph Franke <Franke.Christoph@gmx.de>`	1.5GB SyJet	gj	Received
`Christoph Franke <Franke.Christoph@gmx.de>`	IBM DDRS-39130 SCSI LVD/SE Harddisk	des	Received
`Christoph Franke <Franke.Christoph@gmx.de>`	IBM DDRS-34560 SCSI SE Harddisk, Plextor PX-20TSi SCSI CDROM Drive	ru	Received
`Christoph Franke <Franke.Christoph@gmx.de>`	IOMEGA Zip Drive SCSI 100 MB (incl. 2 Medias)	phk	Shipped
`ETEK, Chalmers`	Compaq XP1000: DECchip 21264A-9 667MHz, 640MB RAM	obrien	Received
`ceri`	A well-supported 4 serial port PCI card	wilko	Received
`Mike Ray`	MIPS R4000 Microprocessor User's Manual	jmallett	Received
`wilko Ray`	3 FC disks	phk	Received
`HP (on behalf of wilko)`	AlphaServer 4100	ticso	Received
`HP (on behalf of wilko)`	AlphaStation 200	ceri	Received
`Brian Cunnie <brian@cunnie.com>`	40+gb IDE drive	eric	Received
`Jared_Valentine@3com.com`	crypto devices (pci, pcmcia, cardbus cards, CPUs with builtin crypto+support, 3Com 3CR990, 3CRFW102/103 PC Cards w/ 3DES	sam	Shipped?
`Jared_Valentine@3com.com`	3Com XJack Wireless PC Card	imp	Shipped?
`Jared_Valentine@3com.com`	A 3Com 3XP Typhoon/Sidewinder txp(4) card	will	Shipped?
`Jared_Valentine@3com.com`	A "xl"-supported Cardbus NIC (575/656 series)	arved	Shipped?
`HP (on behalf of wilko)`	AlphaServer 4100	Fruitsalad.org; for KDE development	Received
`David Leimbach >leimy2k@mac.com<`	One SATA controller	sos	Shipped?
`David Leimbach >leimy2k@mac.com<`	G3 (blue and white) for the PPC project	obrien	Shipped?

&footer; diff --git a/en/gnome/index.xsl b/en/gnome/index.xsl index 563fcb5d4e..7da3279afe 100644 --- a/en/gnome/index.xsl +++ b/en/gnome/index.xsl @@ -1,214 +1,214 @@ - + - +

GNOME on FreeBSD
· GNOME on FreeBSD Home
· Installation Instructions for GNOME 1.4
· Installation Instructions for GNOME 2.2
· Available Applications
· How to Help
· Reporting a Bug
· Screenshots
· Contact Us

Documentation
· GNOME 1.4 FAQ
· GNOME 2.2 FAQ
· Creating Ports
· Known Issues with GNOME 2.2 on FreeBSD

Resources
· GNOME Project
· GNOME Office
· GNOME on GNU/Darwin

Related Projects
· KDE Project
· KDE on FreeBSD
· CDE (commercial)

What is GNOME?

The GNOME project was born as an effort to create an entirely free desktop environment for free systems. From the start, the main objective of GNOME has been to provide a user-friendly suite of applications and an easy-to-use desktop. The FreeBSD GNOME Project strives to bring GNOME to the FreeBSD user.

As with most GNU programs, GNOME has been designed to run on all modern Unix-like operating systems. Through the efforts of the FreeBSD GNOME Project and countless volunteers, those operating systems include FreeBSD.

The GNOME project has expanded its objectives over the past few months to include addressing a number of problems in the existing - Unix infrastructure.

+ infrastructure.

The GNOME project acts as an umbrella. The major components of GNOME are:

The GNOME desktop: An easy to use window-based environment for users.
The GNOME development platform: A rich collection of tools, libraries, and components to develop powerful applications on Unix.
The GNOME Office: A set of office productivity applications.

State of the port

We currently support 4.x and 5-CURRENT FreeBSD systems for GNOME 1.4 and 2.2. Anything prior to FreeBSD 4.6 is not supported. Most of GNOME has been ported to FreeBSD; however, there is plenty left to do!

FreeBSD GNOME News
Latest update: ,
· newsflash.html#

More...

GNOME Project News
·
More...