diff --git a/en/docs/Makefile b/en/docs/Makefile new file mode 100644 index 0000000000..37bee50e70 --- /dev/null +++ b/en/docs/Makefile @@ -0,0 +1,12 @@ +# $FreeBSD: www/en/community/Makefile,v 1.16 2004/05/05 07:56:31 josef Exp $ + +.if exists(../Makefile.conf) +.include "../Makefile.conf" +.endif +.if exists(../Makefile.inc) +.include "../Makefile.inc" +.endif + +DOCS= books.sgml man.sgml webresources.sgml + +.include "${WEB_PREFIX}/share/mk/web.site.mk" \ No newline at end of file diff --git a/en/docs/books.sgml b/en/docs/books.sgml new file mode 100644 index 0000000000..b5353c6895 --- /dev/null +++ b/en/docs/books.sgml @@ -0,0 +1,445 @@ + + + + %navincludes; + %includes; + + + +]> + + +&header; + +

On this site

+ +

All the documentation on this site can be downloaded in a variety of + different formats (HTML, Postscript, PDF, and more) and compression + schemes (BZip2, Zip) from the FreeBSD FTP site.

+ +

This documentation is provided and maintained by the FreeBSD Documentation Project, and we are + always looking for people to contribute new documentation and maintain + existing documentation.

+ +

Books

+ +

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

+ +

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

+ +

The + FreeBSD Developer's Handbook (developers-handbook)
+ For people who want to develop software for FreeBSD (and not + just people who are developing FreeBSD itself).

+ +

The + FreeBSD Architecture Handbook (arch-handbook)
+ For FreeBSD system developers. This book covers the + architectural details of many important FreeBSD kernel + subsystems.

+ +

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

+ +

The PMake Tutorial + (pmake)
+ A tutorial for the make utility. This book is essential + reading for anyone who wants to understand all the details of using + make of reading and writing makefiles.

+ +

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

+ +

Chapter + 8 of "The FreeBSD Corporate Networker's Guide" + (corp-net-guide)
+ Donated by Addison-Wesley, provides an in-depth look at using + FreeBSD to provide printing services to Windows, NT, and Novell + hosts.

+ +

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

+ +

Articles

+ + + +

The + Roadmap for 5-STABLE (5-roadmap)
+ Describes medium-term development and release engineering + plans leading to the 5-STABLE branch point.

+ +

Integration + of Checkpoint VPN-1/Firewall-1 and FreeBSD IPsec + (checkpoint)
+ How to configure Checkpoint VPN-1/Firewall-1 and FreeBSD + IPsec.

+ +

The + Committer's Guide (committers-guide)
+ Introductory information for FreeBSD committers.

+ +

Console + Server Tutorial (console-server)
+ How to setup a FreeBSD based console server with a cheap + multi-port serial card.

+ +

Contributing + to FreeBSD (contributing)
+ How to contribute to the FreeBSD Project.

+ +

The + List of FreeBSD Contributors (contributors)
+ A list of organizations and individuals who have helped + enhance FreeBSD.

+ +

Setting up a + CVS repository - The FreeBSD way (cvs-freebsd)
+ How to set up a CVS repository that uses the same CVSROOT + infrastructure as the FreeBSD project.

+ +

CVSup + Advanced Points (cvsup-advanced)
+ An article with some tips about the subtleties of + CVSup.

+ +

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

+ +

Creating + a diskless X server (diskless-x)
+ How to create a diskless X server.

+ +

The Euro symbol + on FreeBSD (euro)
+ How to configure FreeBSD and related applications to display the + new Euro symbol.

+ +

Explaining + BSD (explaining-bsd)
+ An answer to the question ``What is BSD?''

+ +

FreeBSD + From Scratch (fbsd-from-scratch)
+ How to automatically compile, install and configure a system from + scratch (i.e. to an empty file system), including your favorite + ports.

+ +

Filtering + Bridges (filtering-bridges)
+ Configuring firewalls and filtering on FreeBSD hosts acting as + bridges rather than routers.

+ +

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

+ +

Formatting + media on FreeBSD (formatting-media)
+ How to slice, partition, and format fixed and removable media on + FreeBSD.

+ +

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

+ +

Working with Hats + (hats)
+ A committer's guide to working with ``hats'' (other + committers with authority over specific areas of + FreeBSD).

+ +

Mirroring FreeBSD + (hubs) +
The all in one guide for mirroring the FreeBSD website, + CVSup servers, FTP servers, and more.

+ +

Independent + Verification of IPsec Functionality in FreeBSD + (ipsec-must)
+ A method for experimentally verifying IPsec + functionality.

+ +

Java, and + Jakarta Tomcat (java-tomcat)
+ Information on setting up Java and Jakarta Tomcat on a FreeBSD + system.

+ +

FreeBSD on Laptops + (laptop)
+ Information about running FreeBSD on a laptop.

+ +

FreeBSD: An Open Source Alternative to Linux + (linux-comparison)
+ A white paper explaining the differences between Linux + and FreeBSD.

+ +

Frequently + Asked Questions About The FreeBSD Mailing Lists + (mailing-list-faq)
+ How to best use the mailing lists, such as how to help + avoid frequently-repeated discussions.

+ +

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

+ +

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

+ +

FreeBSD + First Steps (new-users)
+ For people coming to FreeBSD and &unix; for the first + time.

+ +

Pluggable + Authentication Modules (pam)
+ A guide to the PAM system and modules under + FreeBSD.

+ +

Package + building procedures (portbuild)
+ Describes the approach used by the FreeBSD port + manager team to regularly build ports into packages. + It describes the portbuild cluster, as well as the tools + needed to do incremental, experimental, and official release + package builds.

+ +

FreeBSD + Problem Report Handling Guidelines (pr-guidelines)
+ Recommended practices for handling FreeBSD problem + reports.

+ +

Writing + FreeBSD Problem Reports (problem-reports)
+ How to best formulate and submit a problem report to the + FreeBSD Project.

+ +

PXE booting + FreeBSD (pxe)
+ How to create an Intel PXE server using FreeBSD, and how to + configure a FreeBSD client to boot from a PXE server.

+ +

FreeBSD as + a greylist mail server (relaydelay)
+ Implementing a greylist mail server on FreeBSD + using Sendmail, MySQL, Perl and the relaydelay + software. This is an excellent method to use in the + fight against spam.

+ +

FreeBSD + Release Engineering (releng)
+ Describes the approach used by the FreeBSD release + engineering team to make production quality releases of the + FreeBSD Operating System. It describes the tools available + for those interested in producing customized FreeBSD releases + for corporate rollouts or commercial productization.

+ +

FreeBSD + Release Engineering for Third Party Packages + (releng-packages)
+ Describes the approach used by the FreeBSD + release engineering team to produce a high quality package set + suitable for official FreeBSD release media. This document is + a work in progress, but eventually it will cover the process + used to build a clean package set on the FreeBSD.org "Ports + Cluster", how to configure any other set of machines as a + ports cluster, how to split up the packages for the release + media, and how to verify that a package set is + consistent.

+ +

Serial + and UART devices (serial-uart)
+ Detailed information about the use of serial ports on FreeBSD, + including several multi-port serial cards.

+ +

FreeBSD + and Solid State Devices (solid-state)
+ The use of solid state disk devices in FreeBSD.

+ +

Storage Devices + (storage-devices)
+ Detailed information about using storage devices with FreeBSD, + including ESDI disks, and SCSI disks, tape drives, and CDROM + drives.

+ +

Choosing the + FreeBSD Version That Is Right For You (version-guide)
+ How to decide which version of FreeBSD is right for your + needs. Topics include the releases, branches, the difference + between -CURRENT and -STABLE, and the current scheduling goals + of the project.

+ +

Bootstrapping + Vinum: A Foundation for Reliable Servers (vinum)
+ A gentle introduction to failure-resilient servers and + step-by-step instructions for building one with Vinum.

+ +

Design + elements of the FreeBSD VM system (vm-design)
+ An easy to follow description of the design of the FreeBSD + virtual memory system.

+ +

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

+ + +

On other web sites

+ +

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

+ +

Books

+ + + +

Articles

+ + + + + +&footer; + + + \ No newline at end of file diff --git a/en/docs/man.sgml b/en/docs/man.sgml new file mode 100644 index 0000000000..6b9da60d41 --- /dev/null +++ b/en/docs/man.sgml @@ -0,0 +1,89 @@ + + + + %navincludes; + %includes; + + +]> + + +&header; + +
+
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, + 4.3, + 4.4, + 4.5, + 4.6, + 4.7, + 4.8, + 4.9, + 4.10, + 4.11, + 4.X-STABLE, + 5.0, + 5.1, + 5.2, + 5.2.1, + 5.3, + 5.X-STABLE, + 6.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, + HP-UX, + Linux, + NetBSD, + OpenBSD, + Darwin, + Plan 9, + SunOS 4.X, + SunOS 5.X, + ULTRIX 4.2, + and XFree86. +
+
+ +&footer; + + + \ No newline at end of file diff --git a/en/docs/webresources.sgml b/en/docs/webresources.sgml new file mode 100644 index 0000000000..d989b99ef5 --- /dev/null +++ b/en/docs/webresources.sgml @@ -0,0 +1,106 @@ + + + + %navincludes; + %includes; +]> + + +&header; + +

Links

+ + + +

In the real world...

+ +

FreeBSD in the Press

+ +

Articles in the press about FreeBSD.

+ +

Newsgroups

+ +

The following newsgroups contain discussion pertinent to + FreeBSD users:

+ + + +

Additional resources

+ +

Year 2000 Compatibility

+ +

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

+ +

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.

+ +

Daemon News

+ +

The industry leader in BSD news.

+ +

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 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.

+ +

The O'Reilly Network BSD + Dev Center

+ +

The BSD Dev Center includes two regular columns on FreeBSD, + featuring tips and tutorials.

+ +

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).

+ +&footer; + + + \ No newline at end of file diff --git a/en/support/Makefile b/en/support/Makefile new file mode 100644 index 0000000000..8eaa1f2115 --- /dev/null +++ b/en/support/Makefile @@ -0,0 +1,12 @@ +# $FreeBSD: www/en/support/Makefile,v 1.16 2004/05/05 07:56:31 josef Exp $ + +.if exists(../Makefile.conf) +.include "../Makefile.conf" +.endif +.if exists(../Makefile.inc) +.include "../Makefile.inc" +.endif + +DOCS= bugreports.sgml webresources.sgml + +.include "${WEB_PREFIX}/share/mk/web.site.mk" \ No newline at end of file diff --git a/en/support/bugreports.sgml b/en/support/bugreports.sgml new file mode 100644 index 0000000000..0bd4d7f6d9 --- /dev/null +++ b/en/support/bugreports.sgml @@ -0,0 +1,67 @@ + + + + %navincludes; + %includes; +]> + + +&header; + +

Problem Report Database

+ +

Current FreeBSD problem reports are tracked using the GNATS + database.

+ +

A FreeBSD problem report (PR) is not necessarily a bug with FreeBSD + itself. In some cases it may be reporting a mistake in the + documentation (which could be a simple typo). In other cases it may + be a 'wishlist' item that the submitter would like to see incorporated + in to FreeBSD. In many cases a PR contains a port which has been + prepared for inclusion in the FreeBSD + Ports and Packages collection.

+ +

Problem reports start 'open', and are closed as the issue they report + is resolved. In addition, each PR is assigned a unique tracking ID + to ensure that it is not lost. Many FreeBSD changes include the + tracking ID of the PR that prompted the change.

+ + + +

Problem reports may also be submitted to the development team using the + send-pr(1) command on a FreeBSD system, + or by sending an email message to freebsd-bugs@FreeBSD.org. + Please note that send-pr is preferred + since messages sent to the mailing list are not tracked as + official problem reports, and may get lost in the noise!

+ +

Before submitting a problem report, you might find it useful to + read the Writing + FreeBSD Problem Reports article. This article describes + when you should submit a problem report, what you are expected + to include in one, and what the best way to submit your problem + report is. Some useful background information is also contained + in the Problem + Report Handling Guidelines article.

+ +&footer; + + + \ No newline at end of file diff --git a/en/support/webresources.sgml b/en/support/webresources.sgml new file mode 100644 index 0000000000..37b87be85e --- /dev/null +++ b/en/support/webresources.sgml @@ -0,0 +1,101 @@ + + + + %navincludes; + %includes; +]> + + +&header; + + + + + +

General &unix; Information

+ + + + + +

The X Window System

+ + + + + +

Hardware

+ + + + + +

Related Operating System Projects

+ + + +&footer; + + + \ No newline at end of file