'\" t
.\"     Title: \fBfixincludes\fR
.\"    Author: Ben Burton <bab@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: April 7, 2003
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "\FBFIXINCLUDES\FR" "1" "April 7, 2003" "[FIXME: source]" "[FIXME: 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"
fixincludes \- Reduce the number of #includes in KDE source files
.SH "SYNOPSIS"
.HP \w'\fBfixincludes\fR\ 'u
\fBfixincludes\fR [\fB\-v, \-\-verbose\fR] [\fB\-e, \-\-experimental\fR] [\fB\-m, \-\-modify\fR] [\fB\fIfile\fR\fR] [\fB\-\-help\fR]
.SH "DESCRIPTION"
.PP
\fBfixincludes\fR
tries to reduce the number of #includes in C++ source files\&. Much of it\*(Aqs processing is specific to
KDE
sources and so it might not work so well with sources for non\-KDE
applications\&.
.PP
The following problems are identified by
\fBfixincludes\fR:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Including headers that are no longer supported but which exist for compatibility with older Qt/KDE versions;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Including the same file multiple times\&.
.RE
.PP
There is also an experimental mode which tries removing each #include one at a time (with a few exceptions) to see whether the source still compiles\&. Note that this experimental mode will modify the original sources\&.
.PP
By default the sources will not be modified; the identified problems will simply be written to standard output\&.
.PP
The list of C++ sources to examine should be given on the command\-line\&. If no files are given, all C++ sources in or beneath the current directory will be examined (with the exception of directories whose
Makefile\&.am
contains
\fB\-UQT_NO_COMPAT\fR
or
\fB\-UKDE_NO_COMPAT\fR)
.PP
This utility is part of the KDE Software Development Kit\&.
.SH "OPTIONS"
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Verbose mode\&. Additional debugging output is written to standard output\&.
.RE
.PP
\fB\-e, \-\-experimental\fR
.RS 4
Experimental mode, as described above in detail\&. Note that this option implies
\fB\-\-modify\fR\&.
.RE
.PP
\fB\-m, \-\-modify\fR
.RS 4
As well as writing messages to standard output, actually modify the original sources to fix any problems that were found\&.
.RE
.SH "AUTHORS"
.PP
\fBfixincludes\fR
was written by Dirk Mueller
<mueller@kde\&.org>\&.
.SH "AUTHOR"
.PP
\fBBen Burton\fR <\&bab@debian\&.org\&>
.RS 4
Author.
.RE