From owner-freebsd-doc Mon Oct 4 7:50:10 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id E1998154BC for ; Mon, 4 Oct 1999 07:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA82801; Mon, 4 Oct 1999 07:50:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from rucus.ru.ac.za (rucus.ru.ac.za [146.231.29.2]) by hub.freebsd.org (Postfix) with SMTP id 3368615517 for ; Mon, 4 Oct 1999 07:48:37 -0700 (PDT) (envelope-from nbm@rucus.ru.ac.za) Received: (qmail 50792 invoked by uid 1003); 4 Oct 1999 14:50:49 -0000 Message-Id: <19991004145049.50791.qmail@rucus.ru.ac.za> Date: 4 Oct 1999 14:50:49 -0000 From: nbm@rucus.ru.ac.za Reply-To: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/14118: article-ify programming-tools (last one) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 14118 >Category: docs >Synopsis: article-ify programming-tools (last one) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Oct 4 07:50:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Neil Blakey-Milner >Release: FreeBSD 3.0-STABLE i386 >Organization: Rhodes University Computer Users' Society >Environment: FreeBSD rucus.ru.ac.za 3.0-STABLE FreeBSD 3.0-STABLE #0: Tue Feb 9 22:52:23 GMT 1999 grahams@rucus.ru.ac.za:/usr/src/sys/compile/RUCUS-SMP i386 >Description: programming-tools article isn't. >How-To-Repeat: >Fix: cvs diff: Diffing . Index: article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/programming-tools/article.sgml,v retrieving revision 1.7 diff -u -r1.7 article.sgml --- article.sgml 1999/09/06 06:52:38 1.7 +++ article.sgml 1999/10/04 14:30:58 @@ -1,10 +1,10 @@ - - - - + +
+ + A User's Guide to FreeBSD Programming Tools @@ -31,10 +31,9 @@ coding in any detail. Most of the document assumes little or no previous programming knowledge, although it is hoped that most programmers will find something of value in it - - + - + Introduction<anchor id=foo> FreeBSD offers an excellent development environment. Compilers @@ -58,9 +57,9 @@ programming, although it does assume a basic competence with using Unix and a willingness to learn! - + - + Introduction to Programming A program is a set of instructions that tell the computer to do @@ -76,7 +75,7 @@ - + Interpreters With an interpreter, the language comes as an environment, where you @@ -107,9 +106,9 @@ programs that could be linked together in shell scripts to perform useful tasks. - + - + Interpreters available with FreeBSD Here is a list of interpreters that are available as - + - + Compilers Compilers are rather different. First of all, you write your @@ -248,10 +247,10 @@ it is possible to use Emacs for this purpose. This is discussed in . + - - + Compiling with <command>cc</command> This section deals only with the GNU compiler for C and C++, @@ -527,7 +526,7 @@ - + Common <command>cc</command> Queries and Problems Q. I am trying to write a program which uses the @@ -740,14 +739,14 @@ SIGABRT, there are several other signals which have a similar effect. + - - + Make - + What is <command>make</command>? When you're working on a simple program with only one or two source @@ -800,9 +799,9 @@ are often used for documentation files like README. - + - + Example of using <command>make</command> Here's a very simple make file: @@ -878,9 +877,9 @@ very useful here—it changes the date on a file without you having to edit it. - + - + FreeBSD Makefiles Makefiles can be rather complicated to write. Fortunately, @@ -951,9 +950,9 @@ complicated (and if you do look at them, make sure you have a flask of strong coffee handy!) - + - + More advanced uses of <command>make</command> Make is a very powerful tool, and can do much @@ -987,13 +986,13 @@ Emacs, do C-h i). + - - + Debugging - + The Debugger The debugger that comes with FreeBSD is called @@ -1026,9 +1025,9 @@ gdb and does not cover specialised topics such as debugging the kernel. - + - + Running a program in the debugger You'll need to have compiled the program with the @@ -1138,9 +1137,9 @@ information about the arguments passed to functions and where to go when it returns from a function call). - + - + Examining a core file A core file is basically a file which contains the complete @@ -1191,9 +1190,9 @@ a program crashes; in this case, the bazz() function was called from main(). - + - + Attaching to a running program One of the neatest features about gdb is @@ -1227,13 +1226,13 @@ PauseMode to 0, and wait for the sleep() call to return! + - - + Using Emacs as a Development Environment - + Emacs Unfortunately, Unix systems don't come with the kind of @@ -1354,9 +1353,9 @@ background, and is only really useful if you're on a system which doesn't have virtual terminals). - + - + Configuring Emacs Emacs does many wonderful things; some of them are built in, @@ -1379,9 +1378,9 @@ it's already running; it will read the commands from the file and (hopefully) give you a useful basic setup. - + - + A sample <filename>.emacs</filename> file Unfortunately, there's far too much here to explain it in detail; @@ -1720,9 +1719,9 @@ - + - + Extending the Range of Languages Emacs Understands Now, this is all very well if you only want to program in the @@ -1782,10 +1781,10 @@ my-scheme-mode-hook for a simple example that adds auto-indent). + - - + Further Reading @@ -1831,5 +1830,5 @@ - - + +
>Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message