'\" t
.\"     Title: \fBmeinproc4\fR
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2008-10-03
.\"    Manual: KDE User's Manual
.\"    Source: 0.01.01
.\"  Language: English
.\"
.TH "\FBMEINPROC4\FR" "8" "2008\-10\-03" "0.01.01" "KDE User's Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
meinproc4 \- KDE translator for XML
.SH "SYNOPSIS"
.HP \w'\fBmeinproc4\fR\ 'u
\fBmeinproc4\fR [\-\-help] [Generic\-options] [Qt\-options] [KDE\-options] [\-\-cache\fI\ file\fR] [\-\-check] [\-\-htdig] [\-\-srcdir] [\-\-param\ \fIkey\fR=\fIvalue\fR] [[[\-o] | [\-\-output]]\fI file\fR] [\-\-stdout] [\-\-stylesheet\fI\ xsl\fR] docbook_file
.SH "DESCRIPTION"
.PP
\fBmeinproc4\fR
converts DocBook files to HTML\&.
.SH "GENERIC OPTIONS"
.PP
.PP
\fB\-\-author\fR
.RS 4
Show author information\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Show help about options\&.
.RE
.PP
\fB\-\-help\-all\fR
.RS 4
Show all options\&.
.RE
.PP
\fB\-\-help\-kde\fR
.RS 4
Show KDE specific options\&.
.RE
.PP
\fB\-\-help\-qt\fR
.RS 4
Show Qt specific options\&.
.RE
.PP
\fB\-\-license\fR
.RS 4
Show license information\&.
.RE
.PP
\fB\-v\fR\fB\-\-version\fR
.RS 4
Show version information
.RE
.SH "APPLICATION OPTIONS"
.PP
\fB\-\-cache\fR \fIfile\fR
.RS 4
Create a cache file for the document
.RE
.PP
\fB\-\-check\fR
.RS 4
Check the document for validity
.sp
.if n \{\
.RS 4
.\}
.nf
The output can be a bit daunting, since one small mistake can cause a cascade of errors\&. 
The trick is to look at the first error, fix that error, save the file, and run \fBmeinproc4\fR again\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-htdig\fR
.RS 4
Create a ht://dig compatible index
.RE
.PP
\fB\-o\fR, \fB\-\-output\fR\fI file\fR
.RS 4
Output whole document to
\fIfile\fR\&.
.RE
.PP
\fB\-\-stdout\fR
.RS 4
Output whole document to stdout\&.
.RE
.PP
\fB\-\-stylesheet\fR \fIxsl\fR
.RS 4
Stylesheet to use
.RE
.PP
\fB\-\-srcdir\fR \fIdir\fR
.RS 4
Set the root directory to look for kdelibs
.RE
.PP
\fB\-\-param\fR key=value
.RS 4
Set parameters to pass to the stylesheet\&.
.RE
.SH "USAGE"
.PP
The most common way to run
\fBmeinproc4\fR
is simply as
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBmeinproc4\fR\fR\fB \fR\fB\fIdocbook\-file\fR\fR\fB
\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIdocbook\-file\fR
is usually index\&.docbook\&. This command creates HTML pages from the DocBook file\&. Note that these pages are only viewable in KDE\-based browsers (like Konqueror)\&.
.PP
If you need to view the HTML output in another browser (for example, if you\*(Aqre placing it on line), use
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBmeinproc4\fR\fR\fB \-\-stylesheet \fR\fB\fIstylesheet\-name\fR\fR\fB \fR\fB\fIdocbook\-file\fR\fR\fB
\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIstylesheet\-name\fR
is the full path to one of the XSL stylesheets in $KDEDIR/share/apps/ksgmltools/customization\&. To produce output suitable for the web, you can use
\fBkde\-web\&.xsl\fR
or
\fBkde\-chunk\-online\&.xsl\fR\&. See the README file in that directory for more details\&.
.SH "SEE ALSO"
.PP
\fIkdeoptions\fR(7),
\fIqtoptions\fR(7)
.SH "BUGS"
.PP
There are probably tons of bugs\&. Use
\m[blue]\fBbugs\&.kde\&.org\fR\m[]\&\s-2\u[1]\d\s+2
to report them\&.
.SH "NOTES"
.IP " 1." 4
bugs.kde.org
.RS 4
\%http://bugs.kde.org
.RE