| version 1.3, 2002/12/16 11:48:38 |
version 1.4, 2002/12/17 22:34:01 |
|
|
| <!-- $Platon: Platon.SK/doc-projects/soft-doc-sys/en/user-doc-systems.sgml,v 1.2 2002/12/11 18:16:12 nepto Exp $ --> |
<!-- $Platon: Platon.SK/doc-projects/soft-doc-sys/en/user-doc-systems.sgml,v 1.3 2002/12/16 11:48:38 nepto Exp $ --> |
| |
|
| <chapter id="user-doc-sys"> |
<chapter id="user-doc-sys"> |
| <title>User-oriented software documentation systems</title> |
<title>User-oriented software documentation systems</title> |
| Line 59 while the <acronym>XML</> version uses t |
|
| Line 59 while the <acronym>XML</> version uses t |
|
| |
|
| The basic document looks like this: |
The basic document looks like this: |
| |
|
| <example> |
<example id="user-doc-sys.basic-example"> |
| <title>The basic <productname>DocBook</productname> <acronym>SGML</> document</title> |
<title>The basic <productname>DocBook</productname> <acronym>SGML</> document</title> |
| <programlisting><![CDATA[ |
<programlisting><![CDATA[ |
| <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ ]> |
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ ]> |
| Line 91 class=StartTag>sect3</>, <SGMLtag class= |
|
| Line 91 class=StartTag>sect3</>, <SGMLtag class= |
|
| grouped with the <SGMLtag class=StartTag>part</> tag. Similarly, more books can |
grouped with the <SGMLtag class=StartTag>part</> tag. Similarly, more books can |
| be grouped into one compact unit using the <SGMLtag class=StartTag>set</> tag. |
be grouped into one compact unit using the <SGMLtag class=StartTag>set</> tag. |
| |
|
| <example> |
<example id="user-doc-sys.structure-example"> |
| <title>The basic division of the <productname>DocBook</> <acronym>SGML</> document</title> |
<title>The basic division of the <productname>DocBook</> <acronym>SGML</> document</title> |
| <programlisting><![CDATA[ |
<programlisting><![CDATA[ |
| <chapter><title>Title of the first chapter</title> |
<chapter><title>Title of the first chapter</title> |
| Line 116 constant names, function names, commands |
|
| Line 116 constant names, function names, commands |
|
| well as e-mail addresses or links to web pages. It is possible to create |
well as e-mail addresses or links to web pages. It is possible to create |
| records, tables, insert pictures, etc. |
records, tables, insert pictures, etc. |
| |
|
| <example> |
<example id="user-doc-sys.advanced-example"> |
| <title>Illustration of some <productname>DocBook</> <acronym>SGML</> tags</title> |
<title>Illustration of some <productname>DocBook</> <acronym>SGML</> tags</title> |
| <programlisting><![CDATA[ |
<programlisting><![CDATA[ |
| <filename>/etc/passwd</filename> |
<filename>/etc/passwd</filename> |