Date: 4 Oct 1999 14:50:49 -0000 From: nbm@rucus.ru.ac.za To: FreeBSD-gnats-submit@freebsd.org Subject: docs/14118: article-ify programming-tools (last one) Message-ID: <19991004145049.50791.qmail@rucus.ru.ac.za>
next in thread | raw e-mail | index | archive | help
>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 @@ <!-- $FreeBSD: doc/en_US.ISO_8859-1/articles/programming-tools/article.sgml,v 1.7 1999/09/06 06:52:38 peter Exp $ --> <!-- The FreeBSD Documentation Project --> -<!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V3.0//EN"> -<book> -<bookinfo> -<bookbiblio> +<!DOCTYPE ARTICLE PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN"> +<article> + +<artheader> <title>A User's Guide to FreeBSD Programming Tools</title> <authorgroup> @@ -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</para></abstract> -</bookbiblio> -</bookinfo> +</artheader> -<chapter> +<sect1> <title>Introduction<anchor id=foo></title> <para>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!</para> -</chapter> +</sect1> -<chapter> +<sect1> <title>Introduction to Programming</title> <para>A program is a set of instructions that tell the computer to do @@ -76,7 +75,7 @@ -<sect1> +<sect2> <title>Interpreters</title> <para>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.</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Interpreters available with FreeBSD</title> <para>Here is a list of interpreters that are available as <ulink @@ -209,9 +208,9 @@ </variablelist> </para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Compilers</title> <para>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 <xref linkend="emacs">.</para> +</sect2> </sect1> -</chapter> -<chapter> +<sect1> <title>Compiling with <command>cc</command></title> <para>This section deals only with the GNU compiler for C and C++, @@ -527,7 +526,7 @@ </varlistentry> </variablelist> -<sect1> +<sect2> <title>Common <command>cc</command> Queries and Problems</title> <para>Q. I am trying to write a program which uses the @@ -740,14 +739,14 @@ <symbol>SIGABRT</symbol>, there are several other signals which have a similar effect.</para> +</sect2> </sect1> -</chapter> -<chapter> +<sect1> <title>Make</title> -<sect1> +<sect2> <title>What is <command>make</command>?</title> <para>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 <filename>README</filename>.</para></footnote></para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Example of using <command>make</command></title> <para>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.</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>FreeBSD Makefiles</title> <para>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!)</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>More advanced uses of <command>make</command></title> <para><command>Make</command> is a very powerful tool, and can do much @@ -987,13 +986,13 @@ <application>Emacs</application>, do <userinput>C-h i</userinput>).</para> +</sect2> </sect1> -</chapter> -<chapter id="debugging"> +<sect1 id="debugging"> <title>Debugging</title> -<sect1> +<sect2> <title>The Debugger</title> <para>The debugger that comes with FreeBSD is called @@ -1026,9 +1025,9 @@ <command>gdb</command> and does not cover specialised topics such as debugging the kernel.</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Running a program in the debugger</title> <para>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).</para></note> -</sect1> +</sect2> -<sect1> +<sect2> <title>Examining a core file</title> <para>A core file is basically a file which contains the complete @@ -1191,9 +1190,9 @@ a program crashes; in this case, the <function>bazz()</function> function was called from <function>main()</function>.</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Attaching to a running program</title> <para>One of the neatest features about <command>gdb</command> is @@ -1227,13 +1226,13 @@ <symbol>PauseMode</symbol> to <literal>0</literal>, and wait for the <function>sleep()</function> call to return!</para> +</sect2> </sect1> -</chapter> -<chapter id="emacs"> +<sect1 id="emacs"> <title>Using Emacs as a Development Environment</title> -<sect1> +<sect2> <title>Emacs</title> <para>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).</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>Configuring Emacs</title> <para>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.</para> -</sect1> +</sect2> -<sect1> +<sect2> <title>A sample <filename>.emacs</filename> file</title> <para>Unfortunately, there's far too much here to explain it in detail; @@ -1720,9 +1719,9 @@ </screen> </example> -</sect1> +</sect2> -<sect1> +<sect2> <title>Extending the Range of Languages Emacs Understands</title> <para>Now, this is all very well if you only want to program in the @@ -1782,10 +1781,10 @@ <function>my-scheme-mode-hook</function> for a simple example that adds <function>auto-indent</function>).</para> +</sect2> </sect1> -</chapter> -<chapter> +<sect1> <title>Further Reading</title> <itemizedlist> @@ -1831,5 +1830,5 @@ </itemizedlist> -</chapter> -</book> +</sect1> +</article> >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19991004145049.50791.qmail>