.\" This -*- nroff -*- file has been generated from
.\" DocBook SGML with docbook-to-man on Debian GNU/Linux.
...\"
...\"	transcript compatibility for postscript use.
...\"
...\"	synopsis:  .P! <file.ps>
...\"
.de P!
\\&.
.fl			\" force out current output buffer
\\!%PB
\\!/showpage{}def
...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
.fl			\" prolog
.sy cat \\$1\" bring in postscript file
...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
.sp \\$2u	\" move below the image
..
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
.TH "gtkdoc-mktmpl" "1" 
.SH "NAME" 
gtkdoc-mktmpl \(em  GTK DocBook documentation generator. 
.SH "SYNOPSIS" 
.PP 
\fBgtkdoc-mktmpl\fP [ See below ]  
.SH "DESCRIPTION" 
.PP 
\fBgtkdoc-mktmpl\fP This creates or updates the 
template files which contain the manually-edited documentation. (A 
\fItemplate\fP is a simple text form which is 
filled in with the description of a function, macro, enum, or struct. 
For functions and macros it also contains fields for describing the 
parameters.) 
.PP 
This script reads in the existing templates, found in tmpl/*.sgml, 
moves these files to tmpl/*.sgml.bak, and then recreates the .sgml 
files according to the structure given in the file 
\fIMODULE\fP-sections.txt. 
.PP 
Any new templates added, or new function parameters, are marked 
with \fIFIXME\fP so you can do a grep to see 
which parts need updating. 
.PP 
Any templates which are no longer used (i.e. they are remove from 
\fIMODULE\fP-sections.txt) are placed in the file 
tmpl/\fIMODULE\fP-unused.txt. If they are 
included again later they are automatically copied back into position.  
If you are certain that these templates will never be used again you 
can delete them from \fIMODULE\fP-unused.txt. 
.PP 
Any parameters to functions which are no longer used are separated 
from the rest of the parameters with the line \fB<\fP!-- # Unused Parameters 
# -->. It may be that the parameter name has just been changed, in 
which case you can copy the description to the parameter with the new 
name. You can delete the unused parameter descriptions when no longer 
needed. 
.SH "EXAMPLE" 
.PP 
See /usr/share/doc/gtk-doc-tools/examples, for a makefile.am and a 
configure.in example file. 
.SH "AUTHOR" 
.PP 
This manual page was written by Christian Marillat marillat@debian.org for 
the \fBDebian GNU/Linux\fP system (but may be used by others). 
...\" created by instant / docbook-to-man, Wed 18 Jun 2003, 04:16