diff --git a/en/docs.sgml b/en/docs.sgml index f49b21df41..960eb5ba60 100644 --- a/en/docs.sgml +++ b/en/docs.sgml @@ -1,298 +1,347 @@ - + %includes; ]> - + &header; - - - - - - - -

FreeBSD in the Press

- -

Articles in the press about FreeBSD.

- - - -

Year 2000 Compatibility

- -

The FreeBSD project's current statement about its Year 2000 - compatibility.

- - - -

FreeBSD Real-Quick (TM) Newsletter - (RQN)

- -

A monthly (sometimes bi-weekly) newsletter announcing recent - developments in the FreeBSD arena. Subscribe to freebsd-announce to - receive this newsletter via e-mail.

- - - -

The FreeBSD Handbook

-

An evolving, comprehensive on-line resource for FreeBSD users. - Please address comments and contributions to <freebsd-doc@FreeBSD.org>.

- -

A Japanese translation of the handbook - (EUC encoding) is also available.

- - - -

The FreeBSD Porter's Handbook

- -

An evolving, comprehensive on-line resource for users interested - in creating and submitting a port for the Ports Collection. It - also provides some useful information for Ports committers. - Please address comments and contributions to doc@FreeBSD.org.

- - - -

Frequently Asked Questions (FAQ)

- -

If you have a question, chances are that someone else has had it too. - The most common of these questions (and answers) have been compiled here.

- -

&i.new; We now offer a Russian translation - and a Chinese translation of the FAQ.

- -

A Japanese translation of - the FAQ (EUC encoding) is also available.

- - - -

Tutorials

- -

Assorted documents about various aspects of FreeBSD, FreeBSD - software, and hardware. If you have comments or would like to - contribute a document, please contact us at freebsd-doc@FreeBSD.org.

- - - -

Additional Resources

+ -

www.FreeBSD.org is not the only place to get information on FreeBSD; - various independent efforts have also produced a great deal of useful - information about FreeBSD.

+

A wide variety of documentation is available for FreeBSD, on this web + site, on other web sites, and available over the counter.

- +

The FreeBSD FAQ
+ Frequently Asked Questions, and answers, covering all + aspects of FreeBSD.

- - -

Books

- -

Online documentation is useful, but any serious FreeBSD user should - consider getting some of the books listed here. Most books that cover - BSD systems apply well to FreeBSD.

+

The FreeBSD Handbook
+ A constantly evolving, comprehensive resource for FreeBSD + users.

+ +

Chapter 2 of "The + Design and Implementation of the 4.4BSD Operating System"
+ Donated by Addison-Wesley, provides a design overview of 4.4BSD, + from which FreeBSD was originally derived.

+ +

The Pedantic PPP + Primer
+ Everything you need to know about configuring PPP on + FreeBSD.

+ +

The Porter's Handbook
+ Essential reading if you plan on providing a port of a third + party piece of software.

+ +

The FreeBSD Documentation Project + Primer for New Contributors
+ Everything you need to know in order to start contributing to the + FreeBSD Documentation Project.

+ +

Articles

+ +

The Committer's + Guide
+ Introductory information for FreeBSD committers.

+ +

Dialup + firewalling with FreeBSD
+ How to set up a firewall using PPP and ipfw over a dialup link + with dynamically assigned IP addresses.

+ +

Creating a diskless X + server
+ How to create a diskless X server.

+ +

Fonts and FreeBSD
+ A description of the various font technologies in FreeBSD, and + how to use them with different programs.

+ +

Formatting media + on FreeBSD
+ How to slice, partition, and format fixed and removable media on + FreeBSD.

+ +

How to get the + best results from the FreeBSD-questions mailing list
+ Tips and tricks to help you maximise the chances of getting + useful information from the -questions mailing list.

+ +

An MH Primer
+ An introduction to using the MH mail reader on + FreeBSD.

+ +

Using FreeBSD with other + operating systems
+ How to install FreeBSD alongside one or more different operating + systems on the same computer.

+ +

FreeBSD First + Steps
+ For people coming to FreeBSD and Unix for the first + time.

+ +

Programming + Tools on FreeBSD
+ A user's guide to the various tools for software development on + FreeBSD.

+ +

Zip-drives and + FreeBSD
+ How to format, mount, and use an Iomega Zip (SCSI, IDE, or + parallel) Drive on FreeBSD.

+ +

Manual pages

- - -

Manual Pages

-
FreeBSD
For release: 1.0, 1.1, 1.1.5.1, 2.0, 2.0.5, 2.1.0, 2.1.5, 2.1.6.1, 2.1.7.1, 2.2.1, 2.2.2, 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5.1, 4.0, 4.1, 4.2, 5.0-current, Ports.
Other Systems
Unix Seventh Edition (V7), 2.8BSD, 2.9.1BSD, 2.10BSD, 2.11BSD, 4.3BSD Reno, NET/2, 386BSD 0.1, 4.4BSD Lite2, Linux Slackware, NetBSD, OpenBSD, Plan 9, SunOS 4.x, SunOS 5.x, ULTRIX 4.2, and XFree86.
+ +

Other documentation

+ +

4.4BSD Documents: This is a + hypertext version of the 4.4BSD documents from + /usr/share/doc, where you will find the + documents on a FreeBSD machine (if you install the doc + distribution).

+ +

Info Documents: This is a + hypertext version of the Info documents from + /usr/share/info, where you will find + the Info documents on a FreeBSD machine (if you install the info + distribution).

- +

On other web sites

-

This service is provided courtesy of Wolfram Schneider.

+

Various independent efforts have also produced a great deal of useful + information about FreeBSD.

- - -

4.4BSD Documents

+

Books

-

If you like to read BSD manuals online, here is a hypertext version of - the 4.4BSD documents from /usr/share/doc, where you will find - the documents on a FreeBSD machine (if you install the doc distribution). -

- - + + +

Articles

+ + + + + +

Links

+ + + +

In the real world...

+ +

FreeBSD in the Press

+ +

Articles in the press about FreeBSD.

+ +

Additional resources

+ +

Year 2000 Compatibility

+ +

The FreeBSD project's current statement about its Year 2000 + compatibility.

+ +

FreeBSD Real-Quick (TM) Newsletter + (RQN)

+ +

A monthly (sometimes bi-weekly) newsletter announcing recent + developments in the FreeBSD arena. Subscribe to freebsd-announce to + receive this newsletter via e-mail.

+ +

The + Source Code

If you like digging your fingers into source code, here is a hypertext version of the FreeBSD kernel source. This is brought to you courtesy of Warren Toomey.

- - -

The FreeBSD Documentation - Project

- -

Daemon News

+

Daemon News

The industry leader in BSD news.

-

The FreeBSD 'zine

+

The FreeBSD 'zine

A monthly collection of easy to read (we hope) articles written by FreeBSD users and administrators just like you.

Like FreeBSD itself, this documentation is the product of a volunteer effort. The goals of the project are outlined here, as are the procedures for submitting corrections and new material.

-

The FreeBSD - Diary

+

The FreeBSD + Diary

The FreeBSD Diary is a collection of how-to entries aimed at UNIX novices. The aim is to provide a set of step-by-step guides to installing and configuring various ports.

&footer; diff --git a/en/docs/Makefile b/en/docs/Makefile new file mode 100644 index 0000000000..15316b6a68 --- /dev/null +++ b/en/docs/Makefile @@ -0,0 +1,14 @@ +# +# $FreeBSD$i +# +# Build the FreeBSD documentation *outside* of the www tree, and install it +# in to the right place as necessary. +# +# This assumes that you have the www/ and doc/ trees checked out beside +# one another -- this was always the case anyway, so there are no extra +# requirements here. +# + +all install clean: + echo foo + (cd ../../../doc/en_US.ISO_8859-1 && unset DESTDIR && ${MAKE} FORMATS=html-split DOCDIR=${DESTDIR}/data/docs ${.TARGET})