summaryrefslogtreecommitdiffstats
path: root/doc/man/scripts/fixkdeincludes.1
blob: 6c5bea18300772a4947effc4a7604557e79f474d (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
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH FIXTDEINCLUDES 1 "January 31, 2004"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
fixkdeincludes \- reduce the number of #includes in TDE source files
.SH SYNOPSIS
.B fixkdeincludes
[ \fB\-v, \-\-verbose\fP ]
[ \fB\-e, \-\-experimental\fP ]
[ \fB\-m, \-\-modify\fP ]
[ \fIfile\fP ... ]
.br
.B fixkdeincludes \-\-help
.SH DESCRIPTION
\fBfixkdeincludes\fP tries to reduce the number of #includes in C++ source
files.  Much of its processing is specific to TDE sources and so it
might not work so well with sources for non-TDE applications.
.PP
The following problems are identified by fixkdeincludes:
.PP
.RS
Including headers that are no longer supported but which exist for
compatibility with older Qt/KDE versions;
.PP
Including the same file multiple times;
.PP
Using #include <...> instead of #include "...".
.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
\fIMakefile.am\fP contains \-UTQT_NO_COMPAT or \-UTDE_NO_COMPAT).
.PP
This utility is part of the TDE Software Development Kit.
.SH OPTIONS
.TP
\fB\-v, \-\-verbose\fP
Verbose mode.  Additional debugging information is written to standard output.
.TP
\fB\-e, \-\-experimental\fP
Experimental mode, as described above in detail.  Note that this option
implies \fB\-\-modify\fP.
.TP
\fB\-m, \-\-modify\fP
As well as writing messages to standard output, actually modify the
original sources to fix any problems that were found.
.SH AUTHOR
fixkdeincludes was written by Dirk Mueller <mueller@kde.org>.
.br
This manual page was prepared by Ben Burton <bab@debian.org>
for the Debian GNU/Linux system (but may be used by others).