update ccache man page for ccache-swig
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk@10988 626c5289-ae23-0410-ae9c-e8d60b6d4f22
This commit is contained in:
parent
ab29ac767a
commit
607f07d072
1 changed files with 27 additions and 20 deletions
|
|
@ -1,23 +1,24 @@
|
||||||
mailto(bugs@ccache.samba.org)
|
mailto(swig-devel see: http://www.swig.org/mail.html)
|
||||||
manpage(ccache)(1)(April 2002)()()
|
manpage(ccache-swig)(1)()()()
|
||||||
manpagename(ccache)(a fast compiler cache)
|
manpagename(ccache-swig)(a fast compiler cache)
|
||||||
manpagesynopsis()
|
manpagesynopsis()
|
||||||
|
|
||||||
ccache [OPTION]
|
ccache-swig [OPTION]
|
||||||
|
|
||||||
ccache <compiler> [COMPILER OPTIONS]
|
ccache-swig <compiler> [COMPILER OPTIONS]
|
||||||
|
|
||||||
<compiler> [COMPILER OPTIONS]
|
<compiler> [COMPILER OPTIONS]
|
||||||
|
|
||||||
manpagedescription()
|
manpagedescription()
|
||||||
|
|
||||||
ccache is a compiler cache. It speeds up re-compilation of C/C++ code
|
ccache-swig is a compiler cache. It speeds up re-compilation of C/C++/SWIG code
|
||||||
by caching previous compiles and detecting when the same compile is
|
by caching previous compiles and detecting when the same compile is
|
||||||
being done again.
|
being done again. ccache-swig is ccache plus support for SWIG. ccache
|
||||||
|
and ccache-swig are used interchangeably in this document.
|
||||||
|
|
||||||
manpagesection(OPTIONS SUMMARY)
|
manpagesection(OPTIONS SUMMARY)
|
||||||
|
|
||||||
Here is a summary of the options to ccache.
|
Here is a summary of the options to ccache-swig.
|
||||||
|
|
||||||
verb(
|
verb(
|
||||||
-s show statistics summary
|
-s show statistics summary
|
||||||
|
|
@ -32,7 +33,7 @@ verb(
|
||||||
|
|
||||||
manpageoptions()
|
manpageoptions()
|
||||||
|
|
||||||
These options only apply when you invoke ccache as "ccache". When
|
These options only apply when you invoke ccache as "ccache-swig". When
|
||||||
invoked as a compiler none of these options apply. In that case your
|
invoked as a compiler none of these options apply. In that case your
|
||||||
normal compiler options apply and you should refer to your compilers
|
normal compiler options apply and you should refer to your compilers
|
||||||
documentation.
|
documentation.
|
||||||
|
|
@ -42,7 +43,7 @@ dit(bf(-h)) Print a options summary page
|
||||||
|
|
||||||
dit(bf(-s)) Print the current statistics summary for the cache. The
|
dit(bf(-s)) Print the current statistics summary for the cache. The
|
||||||
statistics are stored spread across the subdirectories of the
|
statistics are stored spread across the subdirectories of the
|
||||||
cache. Using "ccache -s" adds up the statistics across all
|
cache. Using "ccache-swig -s" adds up the statistics across all
|
||||||
subdirectories and prints the totals.
|
subdirectories and prints the totals.
|
||||||
|
|
||||||
dit(bf(-z)) Zero the cache statistics.
|
dit(bf(-z)) Zero the cache statistics.
|
||||||
|
|
@ -73,21 +74,22 @@ enddit()
|
||||||
manpagesection(INSTALLATION)
|
manpagesection(INSTALLATION)
|
||||||
|
|
||||||
There are two ways to use ccache. You can either prefix your compile
|
There are two ways to use ccache. You can either prefix your compile
|
||||||
commands with "ccache" or you can create a symbolic link between
|
commands with "ccache-swig" or you can create a symbolic link between
|
||||||
ccache and the names of your compilers. The first method is most
|
ccache-swig and the names of your compilers. The first method is most
|
||||||
convenient if you just want to try out ccache or wish to use it for
|
convenient if you just want to try out ccache or wish to use it for
|
||||||
some specific projects. The second method is most useful for when you
|
some specific projects. The second method is most useful for when you
|
||||||
wish to use ccache for all your compiles.
|
wish to use ccache for all your compiles.
|
||||||
|
|
||||||
To install for usage by the first method just copy ccache to somewhere
|
To install for usage by the first method just copy ccache-swig to somewhere
|
||||||
in your path.
|
in your path.
|
||||||
|
|
||||||
To install for the second method do something like this:
|
To install for the second method do something like this:
|
||||||
verb(
|
verb(
|
||||||
cp ccache /usr/local/bin/
|
cp ccache-swig /usr/local/bin/
|
||||||
ln -s /usr/local/bin/ccache /usr/local/bin/gcc
|
ln -s /usr/local/bin/ccache-swig /usr/local/bin/gcc
|
||||||
ln -s /usr/local/bin/ccache /usr/local/bin/g++
|
ln -s /usr/local/bin/ccache-swig /usr/local/bin/g++
|
||||||
ln -s /usr/local/bin/ccache /usr/local/bin/cc
|
ln -s /usr/local/bin/ccache-swig /usr/local/bin/cc
|
||||||
|
ln -s /usr/local/bin/ccache-swig /usr/local/bin/swig
|
||||||
)
|
)
|
||||||
This will work as long as /usr/local/bin comes before the path to gcc
|
This will work as long as /usr/local/bin comes before the path to gcc
|
||||||
(which is usually in /usr/bin). After installing you may wish to run
|
(which is usually in /usr/bin). After installing you may wish to run
|
||||||
|
|
@ -257,7 +259,8 @@ clean operation too often.
|
||||||
|
|
||||||
manpagesection(CACHE COMPRESSION)
|
manpagesection(CACHE COMPRESSION)
|
||||||
|
|
||||||
By default ccache will compress all files it puts into the cache
|
By default on most platforms ccache will compress all files it puts
|
||||||
|
into the cache
|
||||||
using the zlib compression. While this involves a negligible
|
using the zlib compression. While this involves a negligible
|
||||||
performance slowdown, it significantly increases the number of files
|
performance slowdown, it significantly increases the number of files
|
||||||
that fit in the cache. You can turn off compression setting the
|
that fit in the cache. You can turn off compression setting the
|
||||||
|
|
@ -332,6 +335,8 @@ by Erik Thiele and I would like to thank him for an excellent piece of
|
||||||
work. See
|
work. See
|
||||||
url(http://www.erikyyy.de/compilercache/)(http://www.erikyyy.de/compilercache/)
|
url(http://www.erikyyy.de/compilercache/)(http://www.erikyyy.de/compilercache/)
|
||||||
for the Erik's scripts.
|
for the Erik's scripts.
|
||||||
|
ccache-swig is a port of the original ccache with support added for use
|
||||||
|
with SWIG.
|
||||||
|
|
||||||
I wrote ccache because I wanted to get a bit more speed out of a
|
I wrote ccache because I wanted to get a bit more speed out of a
|
||||||
compiler cache and I wanted to remove some of the limitations of the
|
compiler cache and I wanted to remove some of the limitations of the
|
||||||
|
|
@ -366,10 +371,12 @@ itemize(
|
||||||
manpageauthor()
|
manpageauthor()
|
||||||
|
|
||||||
ccache was written by Andrew Tridgell
|
ccache was written by Andrew Tridgell
|
||||||
url(http://samba.org/~tridge/)(http://samba.org/~tridge/)
|
url(http://samba.org/~tridge/)(http://samba.org/~tridge/).
|
||||||
|
ccache was adapted to create ccache-swig for use with SWIG by William Fulton.
|
||||||
|
|
||||||
If you wish to report a problem or make a suggestion then please email
|
If you wish to report a problem or make a suggestion then please email
|
||||||
bugs@ccache.samba.org
|
the SWIG developers on the swig-devel mailing list, see
|
||||||
|
url(http://www.swig.org/mail.html)(http://www.swig.org/mail.html)
|
||||||
|
|
||||||
ccache is released under the GNU General Public License version 2 or
|
ccache is released under the GNU General Public License version 2 or
|
||||||
later. Please see the file COPYING for license details.
|
later. Please see the file COPYING for license details.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue