summaryrefslogtreecommitdiffstats
path: root/docs/en/xml/conventions.xml
blob: 707146551ecca9f6edb70baed51b353f56d085dc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?xml version="1.0"?>
<!-- This Source Code Form is subject to the terms of the Mozilla Public
     License, v. 2.0. If a copy of the MPL was not distributed with this
     file, You can obtain one at http://mozilla.org/MPL/2.0/.

     This Source Code Form is "Incompatible With Secondary Licenses", as
     defined by the Mozilla Public License, v. 2.0.
-->
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                      "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
    <!ENTITY % myents SYSTEM "bugzilla.ent">
    %myents;
]>

<section id="conventions">
  <title>Document Conventions</title>

  <para>This document uses the following conventions:</para>

  <caution>
    <para>This is a caution. Make sure to read this to not be in trouble!</para>
  </caution>

  <tip>
    <para>This is a hint or tip, especially about some configuration tweaks.</para>
  </tip>

  <note>
    <para>This is just a note, for your information.</para>
  </note>

  <warning>
    <para>This is a warning, something you should take care of.</para>
  </warning>

  <para>
    A filename or a path to a filename is displayed like this:
    <filename>/path/to/filename.ext</filename>
  </para>

  <para>
    A command to type in the shell is displayed like this:
    <command>command --arguments</command>
  </para>

  <para>bash$ represents a normal user's prompt under bash shell</para>

  <para>bash# represents a root user's prompt under bash shell</para>

  <para>
    A word which is in the glossary will appear like this:
    <glossterm linkend="gloss-bugzilla">Bugzilla</glossterm>
  </para>

  <para>
    A sample of code is illustrated like this:
    <programlisting>
First Line of Code
Second Line of Code
...
    </programlisting>
  </para>

  <para>
    This documentation is maintained in DocBook 4.2 XML format.
    Changes are best submitted as plain text or XML diffs, attached
    to a bug filed in the <ulink url="&bzg-bugs;">Bugzilla Documentation</ulink>
    component.
  </para>
</section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-always-quote-attributes:t
sgml-auto-insert-required-elements:t
sgml-balanced-tag-edit:t
sgml-exposed-tags:nil
sgml-general-insert-case:lower
sgml-indent-data:t
sgml-indent-step:2
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
sgml-minimize-attributes:nil
sgml-namecase-general:t
sgml-omittag:t
sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
sgml-shorttag:t
sgml-tag-region-if-active:t
End:
-->