Commit 463ef40b authored by Reiner Herrmann's avatar Reiner Herrmann

Merge tag 'upstream/1.4'

Upstream version 1.4

# gpg: Signature made Thu 01 Sep 2016 07:30:43 PM CEST using RSA key ID CCF04928DB0EEAA7
# gpg: Good signature from "Reiner Herrmann <reiner@reiner-h.de>" [ultimate]
# Primary key fingerprint: 2F5D AF3F C1F7 93D9 4F3D  900C A721 DA05 5374 AA4F
#      Subkey fingerprint: D8F6 FA7D EA24 D90D 6EAC  733B CCF0 4928 DB0E EAA7
parents 6dfe50bd 7b92102c
......@@ -26,7 +26,7 @@ makeregress:
PYLINTOPTS = --rcfile=/dev/null --reports=n \
--msg-template="{path}:{line}: [{msg_id}({symbol}), {obj}] {msg}" \
--dummy-variables-rgx='^_'
SUPPRESSIONS = --disable="C0103,C0111,C0301,C0302,C0323,C1001,R0903,R0912,R0913,R0914,R0915,W0110,W0141,W0611,W0621"
SUPPRESSIONS = --disable="C0103,C0111,C0301,C0302,C0323,C1001,R0903,R0912,R0913,R0914,R0915,W0110,W0141,W0611,W0621,E0611"
pylint:
@pylint $(PYLINTOPTS) $(SUPPRESSIONS) deheader
......
deheader project news
1.4: 2016-09-01
Now runs polyglot under either Python 2 or Python 3
Added assert() to requirements.
1.3 @ 2016-01-12
When compilation fails, also try it directly inside subdirectories.
......
This diff is collapsed.
'\" t
.\" Title: deheader
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 01/12/2016
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 09/01/2016
.\" Manual: Development Tools
.\" Source: deheader
.\" Language: English
.\"
.TH "DEHEADER" "1" "01/12/2016" "deheader" "Development Tools"
.TH "DEHEADER" "1" "09/01/2016" "deheader" "Development Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
......@@ -31,7 +31,7 @@
deheader \- report which includes in C or C++ compiles can be removed
.SH "SYNOPSIS"
.HP \w'\fBdeheader\fR\ 'u
\fBdeheader\fR [\-h] [\-m\ \fIcommand\fR] [\-i\ \fIpattern\fR] [\-q] [\-r] [\-v] [\-x\ \fIpattern\fR] [\-V] [\fIfile\-or\-dir\fR]
\fBdeheader\fR [\-h] [\-m\ \fIcommand\fR] [\-b\ \fIbuilddir\fR] [\-i\ \fIpattern\fR] [\-q] [\-r] [\-v] [\-x\ \fIpattern\fR] [\-V] [\fIfile\-or\-dir\fR]
.SH "DESCRIPTION"
.PP
This tool takes a list of C or C++ sourcefiles and generates a report on which #includes can be omitted from them; also, what standard inclusions may be required for portability\&. The test, for each foo\&.c or foo\&.cc or foo\&.cpp, is simply whether "rm foo\&.o; make foo\&.o" returns a zero status (but the build command may be overridden)\&.
......@@ -57,6 +57,8 @@ On each test compile, the original sourcefile is moved to a name with an \&.orig
\fB\-r\fR
option was given and headers removed\&.
.PP
If the \-b option is given, it tells the program that generated \&.o files live in a file tree parallel to the source tree but rooted at the specified argument\&. If the argument is a relative path, it is interpreted relative to the directory in which deaheader is run\&.
.PP
If the first test compilation from the top\-level directory fails, deheader descends into the subdirectory of the source file and retries compiling inside there\&.
.PP
At verbosity level 0, only messages indicating removable headers are issued\&. At verbosity 1, test compilations are timed and progess indicated with a twirling\-baton prompt\&. At verbosity level 2, you get verbose progress messages on the analysis\&. At verbosity level 3, you see the output from the make and compilation commands\&.
......@@ -76,6 +78,11 @@ Display some help and exit\&.
Set the build command used for test compiles\&. Defaults to \*(Aqmake\*(Aq\&.
.RE
.PP
\-b
.RS 4
Set the build directory for object files\&.
.RE
.PP
\-i
.RS 4
Set a pattern for includes to be ignored\&. Takes a Python regular expression\&.
......
......@@ -21,6 +21,7 @@
<command>deheader</command>
<arg choice='opt'>-h </arg>
<arg choice='opt'>-m <replaceable>command</replaceable></arg>
<arg choice='opt'>-b <replaceable>builddir</replaceable></arg>
<arg choice='opt'>-i <replaceable>pattern</replaceable></arg>
<arg choice='opt'>-q </arg>
<arg choice='opt'>-r </arg>
......@@ -81,6 +82,11 @@ with an .orig suffix and restored on interrupt or after processing
with its original timestamp, unless the <option>-r</option> option was
given and headers removed.</para>
<para> If the -b option is given, it tells the program that generated
.o files live in a file tree parallel to the source tree but rooted
at the specified argument. If the argument is a relative path, it is
interpreted relative to the directory in which deaheader is run.</para>
<para>If the first test compilation from the top-level directory fails,
deheader descends into the subdirectory of the source file and retries
compiling inside there.</para>
......@@ -115,6 +121,12 @@ whatever build system you are using) is strongly recommended.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-b</term>
<listitem>
<para>Set the build directory for object files.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-i</term>
<listitem>
<para>Set a pattern for includes to be ignored.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment