summaryrefslogtreecommitdiffstats
path: root/kdoctools/man-template.docbook
blob: 8c95b5b91e2961b3918a35a34a2260d50c54a739 (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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY % English "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<title>TDE User Guide</title>
<author><personname>
<firstname><!-- --Your first name-- --></firstname>
<surname><!-- --Your last name-- --></surname>
</personname>
<affiliation><address><email><!-- --Your email address-- --></email></address></affiliation></author>
<date><!-- --Date when this manpage was written, in the ISO 8601 format
'yyyy-mm-dd'-- --></date>
<productname>Trinity Desktop Environment</productname>
</refentryinfo>

<refmeta>
<refentrytitle><command><!-- --The command this page is about-- --></command></refentrytitle>
<manvolnum><!-- --The section this page should be in-- --></manvolnum>
</refmeta>

<refnamediv>
<refname><command><!-- --The command this page is about-- --></command></refname>
<refpurpose><!-- --Very brief description, suitable for 'whatis'-- --></refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command><!-- --The command this page is about-- --></command>
<arg choice="req"><!-- --Required command specific options-- --></arg>
<arg choice="opt"><!-- --Optional command specific options-- --></arg>
<arg choice="opt">TDE Generic Options</arg>
<arg choice="opt">Qt Generic Options</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para><!-- --Description of the app, what it's for, what it does and doesn't
do.-- --> </para>

</refsect1>

<refsect1>
<title>Options</title>
<para>App options, in a variablelist</para>

</refsect1>

<!-- --The Following sections are optional, but recommended if they are
applicable.-- -->

<refsect1>
<title>Environment</title>
<para><!-- --Environment variablesars that affect this command, how to set
them, who sets them, how they affect it, probably in a variablelist.  Only for
man sections 1, 6, 7 and 8-- --></para>
</refsect1>

<refsect1>
<title>Files</title>
<para><!-- --Files used by this command (eg, rc files, locations of caches
etc.)  who puts them there, how they are configured, and if it's safe
to remove them, probably in a variablelist.-- --></para>
</refsect1>

<refsect1>
<title>See Also</title>
<para><!-- --foo(1)-style references, use a simplelist for these-- --></para>

<para>More detailed user documentation is available from <ulink
url="help:/<!-- --commandname-- -->">help:/<!-- --command-- --></ulink>
(either enter this <acronym>URL</acronym> into &konqueror;, or run
<userinput><command>khelpcenter</command>
<parameter>help:/<!-- --command-- --></parameter></userinput>).</para>

<para>There is also further information available at <!-- --link to
website if applicable-- --></para>
</refsect1>

<refsect1>
<title>Examples</title>
<para><!-- -- Give examples on how to use the program with different parameters
here, don't forget to explain what each invocation does exactly. Be verbose,
many users find this the most useful part of the documentation! -- --></para>
</refsect1>

<refsect1>
<title>Standards</title>

<para><!-- --If the app adheres to any particular standards or RFC's, note
them here.-- --> </para>
</refsect1>

<refsect1>
<title>History</title>
<para><!-- --Programs derived from other sources sometimes have this, or you
might keep a modification log here.  If the log gets overly long or detailed,
consider maintaining it in a separate file, though.-- -->
</refsect1>

<refsect1>
<title>Bugs</title>
<para><!-- --Things that cause specific errors, so that people may avoid it,
or at least will be prepared for it.-- -->
</para>
</refsect1>

<refsect1>
<title>Restrictions</title>
<para><!-- --Bugs you don't plan to fix. :-)-- --></para>
</refsect1>

<refsect1>
<title>Authors</title>
<para><!-- --Author information of the developer and man page writer.-- --></para>
</refsect1>

</refentry>