aboutsummaryrefslogtreecommitdiff
path: root/CCache/ccache.yo
diff options
context:
space:
mode:
authorWilliam S Fulton <wsf@fultondesigns.co.uk>2008-12-19 23:25:40 +0000
committerWilliam S Fulton <wsf@fultondesigns.co.uk>2008-12-19 23:25:40 +0000
commit607f07d07259562f7e9690f197b5eff987be20e0 (patch)
treeeffe24dc6a49e097d62c42ae8639b1644b7ebbaa /CCache/ccache.yo
parentab29ac767a5938de30c33b769a77e0c002dc15aa (diff)
downloadswig-607f07d07259562f7e9690f197b5eff987be20e0.tar.gz
update ccache man page for ccache-swig
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk@10988 626c5289-ae23-0410-ae9c-e8d60b6d4f22
Diffstat (limited to 'CCache/ccache.yo')
-rw-r--r--CCache/ccache.yo47
1 files changed, 27 insertions, 20 deletions
diff --git a/CCache/ccache.yo b/CCache/ccache.yo
index 34495ae6c..c5275ea59 100644
--- a/CCache/ccache.yo
+++ b/CCache/ccache.yo
@@ -1,23 +1,24 @@
-mailto(bugs@ccache.samba.org)
-manpage(ccache)(1)(April 2002)()()
-manpagename(ccache)(a fast compiler cache)
+mailto(swig-devel see: http://www.swig.org/mail.html)
+manpage(ccache-swig)(1)()()()
+manpagename(ccache-swig)(a fast compiler cache)
manpagesynopsis()
-ccache [OPTION]
+ccache-swig [OPTION]
-ccache <compiler> [COMPILER OPTIONS]
+ccache-swig <compiler> [COMPILER OPTIONS]
<compiler> [COMPILER OPTIONS]
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
-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)
-Here is a summary of the options to ccache.
+Here is a summary of the options to ccache-swig.
verb(
-s show statistics summary
@@ -32,7 +33,7 @@ verb(
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
normal compiler options apply and you should refer to your compilers
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
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.
dit(bf(-z)) Zero the cache statistics.
@@ -73,21 +74,22 @@ enddit()
manpagesection(INSTALLATION)
There are two ways to use ccache. You can either prefix your compile
-commands with "ccache" or you can create a symbolic link between
-ccache and the names of your compilers. The first method is most
+commands with "ccache-swig" or you can create a symbolic link between
+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
some specific projects. The second method is most useful for when you
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.
To install for the second method do something like this:
verb(
- cp ccache /usr/local/bin/
- ln -s /usr/local/bin/ccache /usr/local/bin/gcc
- ln -s /usr/local/bin/ccache /usr/local/bin/g++
- ln -s /usr/local/bin/ccache /usr/local/bin/cc
+ cp ccache-swig /usr/local/bin/
+ ln -s /usr/local/bin/ccache-swig /usr/local/bin/gcc
+ ln -s /usr/local/bin/ccache-swig /usr/local/bin/g++
+ 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
(which is usually in /usr/bin). After installing you may wish to run
@@ -257,7 +259,8 @@ clean operation too often.
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
performance slowdown, it significantly increases the number of files
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
url(http://www.erikyyy.de/compilercache/)(http://www.erikyyy.de/compilercache/)
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
compiler cache and I wanted to remove some of the limitations of the
@@ -366,10 +371,12 @@ itemize(
manpageauthor()
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
-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
later. Please see the file COPYING for license details.