plotchangelog(1) - phpMan

Command: man perldoc info search(apropos)  


PLOTCHANGELOG(1)                     General Commands Manual                     PLOTCHANGELOG(1)

NAME
       plotchangelog - graph Debian changelogs

SYNOPSIS
       plotchangelog [options] changelog ...

DESCRIPTION
       plotchangelog  is  a  tool  to  aid  in visualizing a Debian changelog. The changelogs are
       graphed with gnuplot(1) , with the X axis of the graph denoting time of release and the  Y
       axis  denoting  the  Debian  version number of the package. Each individual release of the
       package is represented by a point, and the points are color coded to indicate who released
       that  version  of  the package. The upstream version number of the package can also be la-
       beled on the graph.

       Alternatively, the Y axis can be configured to display the size of the changelog entry for
       each  new  version.  Or  it  can be configured to display approximately how many bugs were
       fixed for each new version.

       Note that if the package is a Debian-specific package, the entire package version will  be
       used for the Y axis. This does not always work perfectly.

READING THE GRAPH
       The  general  outline  of a package's graph is typically a series of peaks, starting at 1,
       going up to n, and then returning abruptly to 1. The higher the peaks, the  more  releases
       the  maintainer made between new upstream versions of the package. If a package is Debian-
       only, it's graph will just grow upwards without ever falling (although a bug in this  pro-
       gram may cause it to fall sometimes, if the version number goes from say, 0.9 to say, 0.10
       - this is interpreted wrong...)

       If the graph dips below 1, someone made a NMU of the package and upgraded it to a new  up-
       stream  version,  thus  setting  the Debian version to 0. NMU's in general appear as frac-
       tional points like 1.1, 2.1, etc. A NMU can also be easily  detected  by  looking  at  the
       points  that represent which maintainer uploaded the package -- a solitary point of a dif-
       ferent type than the points before and after it is typically a NMU.

       It's also easy to tell by looking at the points when a package changes maintainers.

OPTIONS
       -l, --linecount
              Instead of using the Debian version number as the Y axis, use the number  of  lines
              in the changelog entry for each version.  Cannot be used together with --bugcount.

       -b, --bugcount
              Instead  of  using  the Debian version number as the Y axis, use the number of bugs
              that were closed by each changelog entry. Note that  this  number  is  obtained  by
              searching  for  "#dddd"  in  the changelog, and so it may be inaccurate.  Cannot be
              used together with --linecount.

       -c, --cumulative
              When used together with either --bugcount or  --linecount,  graphs  the  cumulative
              count rather than the count in each individual changelog entry.

       -v, --no-version
              Do not show upstream version labels. Useful if the graph gets too crowded.

       -m, --no-maint
              Do not differentiate between different maintainers of the package.

       -s file, --save=file
              Save the graph to file in PostScript format instead of immediately displaying it.

       -u, --urgency
              Use larger points when displaying higher-urgency package uploads.

       --verbose
              Output the gnuplot script that is fed into gnuplot (for debugging purposes).

       -gcommands, --gnuplot=commands
              This  allows you to insert gnuplot(1) commands into the gnuplot script that is used
              to generate the graph. The commands are placed after all initialization but  before
              the  final  plot command. This can be used to override the default look provided by
              this program in arbitrary ways. You can also use  things  like  "set  terminal  png
              color"  to  change the output file type, which is useful in conjunction with the -s
              option.

       --help Show a usage summary.

       --version
              Display version, author and copyright information.

       --noconf, --no-conf
              Do not read any configuration files (see below).

       changelog ...
              The changelog files to graph. If multiple files are specified they will all be dis-
              played  on  the same graph. The files may be compressed with gzip. Any text in them
              that is not in Debian changelog format will be ignored.

CONFIGURATION VARIABLES
       The two configuration files /etc/devscripts.conf and ~/.devscripts are sourced by a  shell
       in that order to set configuration variables.  The --no-conf option can be used to prevent
       reading these files.  Environment variable settings are ignored when  these  configuration
       files are read.  The currently recognised variables are:

       PLOTCHANGELOG_OPTIONS
              This is a space-separated list of options to always use, for example -l -b.  Do not
              include -g or --gnuplot among this list as it may be ignored; see the next variable
              instead.

       PLOTCHANGELOG_GNUPLOT
              These  are  gnuplot  commands which will be prepended to any such commands given on
              the command line.

SEE ALSO
       devscripts.conf(5)

AUTHOR
       Joey Hess <joey AT kitenet.net>

DEBIAN                                   Debian Utilities                        PLOTCHANGELOG(1)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-11-14 12:41 @3.233.242.216 CrawledBy CCBot/2.0 (https://commoncrawl.org/faq/)
Valid XHTML 1.0!Valid CSS!