source: branches/src-highlight/README

Last change on this file was 1100, checked in by Peter Johansson, 11 years ago

merge trunk to src-highlight

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
  • Property svn:mime-type set to text/x-trac-wiki
File size: 4.8 KB
RevLine 
[84]1$Id: README 1100 2010-06-13 17:28:19Z peter $
[26]2
[336]3= About svndigest =
4
[281]5svndigest is a tool to extract development information and statistics
[590]6from a subversion repository.  Svndigest is written in C++ and
7extracts repository history using the subversion API. The resulting
8report is written to a user specifiable directory in HTML format.
[84]9
[281]10See the file NEWS for the user-visible changes from previous releases.
11In addition, there have been bugs fixed.
[84]12
[281]13svndigest is free software. See the file COPYING for copying conditions.
[84]14
[466]15Directory `bin` contains main program and is location for svndigest
[806]16binary. Directory `m4` contains additional autotool macros
[612]17required for creating the build environment. Directory `doc` contains
18documentation mainly in file `readme.txt`. Most of the code can be
19found in directory `lib`. Directory `test` contains the code for tests
20and the test repository (see README.developer).
[84]21
[590]22
[336]23== Downloading ==
[221]24
[281]25svndigest can be obtained from
[185]26
[687]27  http://dev.thep.lu.se/svndigest/wiki/DownloadPage
[221]28
29
[336]30== Documentation ==
[185]31
[281]32For documentation see the file doc/readme.txt.
[185]33
[26]34
[590]35== Requirements ==
36
37 * Subversion development files, i.e., header files and program
38   libraries, version 1.4 or later.
39
40 * This item should not be an issue if item above is fulfilled; the
41   Apache Portable Runtime (APR) should be available if the subversion
42   API was successfully compiled. Subversion depends on APR and in
43   consequence, the dependency is inherited by svndigest.
44
[1100]45 * PLplot, http://plplot.sourceforge.net, is used to generate graphics
46   in the output. You can build svndigest without PLplot if you run
47   configure with `--without-plplot`.
[590]48
[1100]49 * pkg-config utility, http://pkg-config.freedesktop.org, is used to
50   query information about PLplot headers and libs. It is possible to
51   configure and build without pkg-config, but we recommend that you
52   have pkg-config available because it makes detection of PLplot much
53   more automatic and convenient.
54
[590]55 * A standard C++ compliant compiler with one extension: svndigest
56   must be compiled with a C++ compiler that supports 'long long'
57   types - GCC does this. This requirement arises from the fact that
58   one of the underlying libraries, APR, is using 'long long'. APR is
59   written in C and the C standard allows 'long long'.
60   Even though the source is compiled with the -pedantic flag (which
61   should catch the non C++ standard 'long long') there is another
62   flag to suppress 'long long' diagnostics, -Wno-long-long.
63
[1100]64=== Optional ===
[590]65
[1100]66 * src-highlite available from http://www.gnu.org/software/src-highlite
67
[590]68== Installing svndigest ==
69
70In file INSTALL you'll find the generic FSF install instructions. To
71compile and install svndigest you can follow the usual autotools path:
72
73 * `./configure`
74
75 * `make`
76
77 * Optionally, `make check` to run test programs. Some test programs
78   are not enabled by default and the disabled tests should only be
79   run by developers.
80
81 * `make install`
82
83The `./configure` script accepts a few options of interest for
[1100]84svndigest. You can provide `./configure` with APR, subversion, and
85PLplot API location information with `--with-apr=DIR`,
86`--with-svn=DIR`, and `--with-plplot=DIR, respectively.
[590]87
88If you grabbed the source from the subversion repository you need to
89run `./bootstrap` to setup autotools files (see README.developer).
90
91
[336]92== Development ==
[281]93
94The development of svndigest can be monitored through
95
[687]96  http://dev.thep.lu.se/svndigest
[281]97
98You can find most information concerning the development of svndigest at
99this site.
100
101
[336]102== Bug Reporting ==
[281]103
104You can report svndigest bugs on
105
[687]106  http://dev.thep.lu.se/svndigest/newticket
[281]107
[336]108Use user `svndigest` and password `svndigest`.
[281]109
110
[336]111== Subversion Access ==
[281]112
113The svndigest source repository is available via anonymous subversion
[386]114access, issue:
[281]115
[694]116  `svn checkout http://dev.thep.lu.se/svndigest/svn/trunk svndigest`
[281]117
[386]118See file README.developer for developer specific information. We make no
[281]119guarantees about the contents or quality of the latest code in the
120subversion repository: it is not unheard of for code that is known to
[386]121be broken to be committed to the repository. Use at your own risk.
[281]122
123
[336]124----------------------------------------------------------------------
[337]125{{{
[1100]126Copyright (C) 2005, 2006 Jari Häkkinen
127Copyright (C) 2007, 2008, 2009 Jari Häkkinen, Peter Johansson
[136]128
[687]129This file is part of svndigest, http://dev.thep.lu.se/svndigest
[136]130
[281]131svndigest is free software; you can redistribute it and/or modify it
132under the terms of the GNU General Public License as published by the
[693]133Free Software Foundation; either version 3 of the License, or (at your
[281]134option) any later version.
[136]135
[281]136svndigest is distributed in the hope that it will be useful, but
137WITHOUT ANY WARRANTY; without even the implied warranty of
138MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
139General Public License for more details.
[136]140
[281]141You should have received a copy of the GNU General Public License
[693]142along with svndigest. If not, see <http://www.gnu.org/licenses/>.
[337]143}}}
Note: See TracBrowser for help on using the repository browser.