diff --git a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml index aff71edf08..a1fa0711a7 100644 --- a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO_8859-1/books/fdp-primer/overview/chapter.sgml,v 1.5 2000/07/07 18:38:23 dannyboy Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml,v 1.6 2001/04/17 16:16:18 nik Exp $ --> @@ -166,7 +166,99 @@ Every one is welcome to join the FDP. There is no minimum FreeBSD Ports system or &man.pkg.add.1;. - + + + + Quick Start + + If you just want to get going, and feel confident you can pick + things up as you go along, follow these instructions. + + + + Install the textproc/docproj + meta-port. + + &prompt.root; cd /usr/ports/textproc/docproj +&prompt.root; make JADETEX=no install + + + + Get a local copy of the FreeBSD doc tree. + Either use CVSup in checkout mode to do this, or + get a full copy of the CVS repository locally. + + If you have the CVS repository locally then as a minimum you + will need to checkout the doc/share, and + doc/en_US.ISO8859-1/share + directories. + + &prompt.user; cvs checkout doc/share +&prompt.user; cvs checkout doc/en_US.ISO8859-1/share + + If you have plenty of disk space then you could check out + everything. + + &prompt.user; cvs checkout doc + + + + If you are preparing a change to an existing book or article, + check it out of the repository as necessary. If you are planning on + contributing a new book or article then use an existing one as a + guide. + + For example, if you want to contribute a new article about + setting up a VPN between FreeBSD and Windows 2000 you might do the + following. + + + + Check out the articles + directory. + + &prompt.user; cvs checkout doc/en_US.ISO8859-1/articles + + + + Copy an existing article to use as a template. In this + case, you have decided that your new article belongs in a + directory called vpn-w2k. + + &prompt.user; cd doc/en_US.ISO8859-1/articles +&prompt.user; cp -r committers-guide vpn-w2k + + + + If you wanted to edit an existing document, such as the the FAQ, + which is in doc/en_US.ISO8859-1/books/faq you + would check it out of the repository like this. + + &prompt.user; cvs checkout doc/en_US.ISO8859-1/books/faq + + + + Edit the .sgml files using your editor of + choice. + + + + Test the markup using the lint target, + and convert the document to other formats for review. + + &prompt.user; make lint +&prompt.user; make FORMAT=format + + Where format is one of + html, html-split, + txt, or rtf + + + + Submit your changes using &man.send-pr.1;. + + +