From owner-freebsd-doc Tue Feb 12 11: 3:47 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id CE69E37B404 for ; Tue, 12 Feb 2002 11:03:26 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g1CJ01C80594; Tue, 12 Feb 2002 11:00:01 -0800 (PST) (envelope-from gnats) Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200]) by hub.freebsd.org (Postfix) with ESMTP id 0E9C737B41F for ; Tue, 12 Feb 2002 10:52:13 -0800 (PST) Received: from pc4-card4-0-cust162.cdf.cable.ntl.com ([80.4.14.162] helo=rhadamanth.private.submonkey.net ident=mailnull) by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2) id 16ahzU-0002qN-00 for FreeBSD-gnats-submit@freebsd.org; Tue, 12 Feb 2002 18:49:20 +0000 Received: from setantae by rhadamanth.private.submonkey.net with local (Exim 3.34 #1) id 16ahzU-000Hwu-00 for FreeBSD-gnats-submit@freebsd.org; Tue, 12 Feb 2002 18:49:20 +0000 Message-Id: Date: Tue, 12 Feb 2002 18:49:20 +0000 From: Ceri Reply-To: Ceri To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/34884: Fixup of the Developer's Handbook, chapter 2 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 34884 >Category: docs >Synopsis: Fixup of the Developer's Handbook, chapter 2 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Feb 12 11:00:01 PST 2002 >Closed-Date: >Last-Modified: >Originator: Ceri >Release: FreeBSD 4.5-STABLE i386 >Organization: >Environment: System: FreeBSD rhadamanth.private.submonkey.net 4.5-STABLE FreeBSD 4.5-STABLE #0: Thu Feb 7 13:14:41 GMT 2002 setantae@rhadamanth.private.submonkey.net:/usr/obj/usr/src/sys/RHADAMANTH i386 >Description: Various markup patches (use of to close elements). Don't claim to have the latest perl. Update locations of some packages (gcl will be fixed later when the package actually builds - maintainer notified). Ceri >How-To-Repeat: >Fix: --- doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml.old Tue Feb 12 17:30:52 2002 +++ doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml Tue Feb 12 18:41:45 2002 @@ -144,7 +144,7 @@ for Visual Basic. The Bywater + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/bwbasic-2.20.tgz">Bywater Basic Interpreter and the Phil Cockroft's Basic Interpreter (formerly Rabbit @@ -163,7 +163,7 @@ languages that were popular at the time. Instead of being based on numbers, Lisp is based on lists; in fact the name is short for List Processing. - Very popular in AI (Artificial Intelligence) + Very popular in AI (Artificial Intelligence) circles. Lisp is an extremely powerful and sophisticated @@ -183,7 +183,7 @@ scripts; also often used on World Wide Web servers for writing CGI scripts. - The latest version (version 5) comes with FreeBSD. + Version 5.005_05 is supplied with FreeBSD. @@ -198,11 +198,11 @@ abstraction to be used in research work. FreeBSD has packages of the Elk + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/elk-3.0.3.tgz">Elk Scheme Interpreter, the MIT + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/mit-scheme-7.6.0.tgz">MIT Scheme Interpreter and the SCM + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/scm-5d4_1.tgz">SCM Scheme Interpreter. @@ -212,7 +212,7 @@ The + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/icon-9.4.0.tgz">The Icon Programming Language. @@ -222,7 +222,7 @@ Brian + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/ucblogo-4.6.tgz">Brian Harvey's LOGO Interpreter. @@ -232,7 +232,7 @@ The + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/lang/python-2.1.2.tgz">The Python Object-Oriented Programming Language @@ -373,13 +373,13 @@ cc is a front end that manages calling all these programs with the right arguments for you; simply typing - &prompt.user; cc foobar.c + &prompt.user; cc foobar.c will cause foobar.c to be compiled by all the steps above. If you have more than one file to compile, just do something like - &prompt.user; cc foo.c bar.c + &prompt.user; cc foo.c bar.c Note that the syntax checking is just that—checking the syntax. It will not check for any logical mistakes you may @@ -394,7 +394,7 @@ There are lots and lots of options for cc, which - are all in the man page. Here are a few of the most important + are all in the manual page. Here are a few of the most important ones, with examples of how to use them. @@ -412,8 +412,8 @@ - &prompt.user; cc foobar.c executable is a.out -&prompt.user; cc -o foobar foobar.c executable is foobar + &prompt.user; cc foobar.c executable is a.out +&prompt.user; cc -o foobar foobar.c executable is foobar @@ -552,7 +552,7 @@ code. Generally, you should try to make your code as portable as - possible, as otherwise you may have to completely re-write the + possible, as otherwise you may have to completely rewrite the program later to get it to work somewhere else—and who knows what you may be using in a few years time? @@ -607,8 +607,8 @@ g++ on FreeBSD. - &prompt.user; cc -o foobar foobar.cc -lg++ For FreeBSD 2.1.6 and earlier -&prompt.user; cc -o foobar foobar.cc -lstdc++ For FreeBSD 2.2 and later + &prompt.user; cc -o foobar foobar.cc -lg++ For FreeBSD 2.1.6 and earlier +&prompt.user; cc -o foobar foobar.cc -lstdc++ For FreeBSD 2.2 and later &prompt.user; c++ -o foobar foobar.cc @@ -1377,8 +1377,8 @@ on a few of the basic commands. Finally, if you find its text-based command-prompt style - off-putting, there is a graphical front-end for it xxgdb in the ports + off-putting, there is a graphical front-end for it (xxgdb) in the ports collection. This section is intended to be an introduction to using @@ -1460,16 +1460,16 @@ under certain conditions; type "show copying" to see the conditions. There is absolutely no warranty for GDB; type "show warranty" for details. GDB 4.13 (i386-unknown-freebsd), Copyright 1994 Free Software Foundation, Inc. -(gdb) break main Skip the set-up code -Breakpoint 1 at 0x160f: file temp.c, line 9. gdb puts breakpoint at main() -(gdb) run Run as far as main() -Starting program: /home/james/tmp/temp Program starts running - -Breakpoint 1, main () at temp.c:9 gdb stops at main() -(gdb) n Go to next line -This is my program Program prints out -(gdb) s step into bazz() -bazz (anint=4231) at temp.c:17 gdb displays stack frame +(gdb) break main Skip the set-up code +Breakpoint 1 at 0x160f: file temp.c, line 9. gdb puts breakpoint at main() +(gdb) run Run as far as main() +Starting program: /home/james/tmp/temp Program starts running + +Breakpoint 1, main () at temp.c:9 gdb stops at main() +(gdb) n Go to next line +This is my program Program prints out +(gdb) s step into bazz() +bazz (anint=4231) at temp.c:17 gdb displays stack frame (gdb) Hang on a minute! How did anint get to be @@ -1477,21 +1477,21 @@ 5 in main()? Let's move up to main() and have a look. - (gdb) up Move up call stack -#1 0x1625 in main () at temp.c:11 gdb displays stack frame -(gdb) p i Show us the value of i -$1 = 4231 gdb displays 4231 + (gdb) up Move up call stack +#1 0x1625 in main () at temp.c:11 gdb displays stack frame +(gdb) p i Show us the value of i +$1 = 4231 gdb displays 4231 Oh dear! Looking at the code, we forgot to initialise i. We meant to put - … + … main() { int i; i = 5; printf("This is my program\n"); -&hellip +&hellip but we left the i=5; line out. As we did not initialise i, it had whatever number @@ -1788,7 +1788,7 @@ quite big!). The best way to learn Emacs Lisp is to download the Emacs + URL="ftp://ftp.gnu.org/old-gnu/emacs/elisp-manual-19-2.4.tar.gz">Emacs Tutorial However, there is no need to actually know any Lisp to get @@ -2202,11 +2202,11 @@ .emacs and add a line for whizbang, such as: - … + … ("\\.lsp$" . lisp-mode) ("\\.wiz$" . whizbang-mode) ("\\.scm$" . scheme-mode) -… +… This means that Emacs will automatically go into whizbang-mode when you edit a file ending >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message