Attachment 6123 Details for Bug 14118 – file.diff

[patch] file.diff

file.diff (text/plain), 6.31 KB, created by nbm on 1999-10-04 15:50:00 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: nbm

Created: 1999-10-04 15:50:00 UTC

Size: 6.31 KB

patch

obsolete

>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 @@
> 
> 
> 
>-<!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&mdash;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>

Actions: View | Diff

Attachments on bug 14118: 6123