{ "content": [ { "type": "text", "text": "# PLOTCHANGELOG (man)\n\n## NAME\n\nplotchangelog - graph Debian changelogs\n\n## SYNOPSIS\n\nplotchangelog [options] changelog ...\n\n## DESCRIPTION\n\nplotchangelog is a tool to aid in visualizing a Debian changelog. The changelogs are graphed\nwith gnuplot(1) , with the X axis of the graph denoting time of release and the Y axis denot‐\ning the Debian version number of the package. Each individual release of the package is rep‐\nresented by a point, and the points are color coded to indicate who released that version of\nthe package. The upstream version number of the package can also be labeled on the graph.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **READING THE GRAPH**\n- **OPTIONS** (10 subsections)\n- **CONFIGURATION VARIABLES**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "PLOTCHANGELOG", "section": "", "mode": "man", "summary": "plotchangelog - graph Debian changelogs", "synopsis": "plotchangelog [options] changelog ...", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-l", "long": "--linecount", "arg": null, "description": "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." }, { "flag": "-b", "long": "--bugcount", "arg": null, "description": "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." }, { "flag": "-c", "long": "--cumulative", "arg": null, "description": "When used together with either --bugcount or --linecount, graphs the cumulative count rather than the count in each individual changelog entry." }, { "flag": "-v", "long": "--no-version", "arg": null, "description": "Do not show upstream version labels. Useful if the graph gets too crowded." }, { "flag": "-m", "long": "--no-maint", "arg": null, "description": "Do not differentiate between different maintainers of the package." }, { "flag": "-s", "long": null, "arg": null, "description": "Save the graph to file in PostScript format instead of immediately displaying it." }, { "flag": "-u", "long": "--urgency", "arg": null, "description": "Use larger points when displaying higher-urgency package uploads." }, { "flag": "", "long": "--verbose", "arg": null, "description": "Output the gnuplot script that is fed into gnuplot (for debugging purposes)." }, { "flag": "-g", "long": null, "arg": null, "description": "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." }, { "flag": "", "long": "--version", "arg": null, "description": "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." } ], "examples": [], "see_also": [ { "name": "devscripts.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/devscripts.conf/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 13, "subsections": [] }, { "name": "READING THE GRAPH", "lines": 15, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-l --linecount", "lines": 3, "flag": "-l", "long": "--linecount" }, { "name": "-b --bugcount", "lines": 5, "flag": "-b", "long": "--bugcount" }, { "name": "-c --cumulative", "lines": 3, "flag": "-c", "long": "--cumulative" }, { "name": "-v --no-version", "lines": 2, "flag": "-v", "long": "--no-version" }, { "name": "-m, --no-maint", "lines": 2, "flag": "-m", "long": "--no-maint" }, { "name": "-s --save=", "lines": 2, "flag": "-s" }, { "name": "-u --urgency", "lines": 2, "flag": "-u", "long": "--urgency" }, { "name": "--verbose", "lines": 2, "long": "--verbose" }, { "name": "-g --gnuplot=", "lines": 8, "flag": "-g" }, { "name": "--version", "lines": 10, "long": "--version" } ] }, { "name": "CONFIGURATION VARIABLES", "lines": 14, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "plotchangelog - graph Debian changelogs\n", "subsections": [] }, "SYNOPSIS": { "content": "plotchangelog [options] changelog ...\n", "subsections": [] }, "DESCRIPTION": { "content": "plotchangelog is a tool to aid in visualizing a Debian changelog. The changelogs are graphed\nwith gnuplot(1) , with the X axis of the graph denoting time of release and the Y axis denot‐\ning the Debian version number of the package. Each individual release of the package is rep‐\nresented by a point, and the points are color coded to indicate who released that version of\nthe package. The upstream version number of the package can also be labeled on the graph.\n\nAlternatively, the Y axis can be configured to display the size of the changelog entry for\neach new version. Or it can be configured to display approximately how many bugs were fixed\nfor each new version.\n\nNote that if the package is a Debian-specific package, the entire package version will be\nused for the Y axis. This does not always work perfectly.\n", "subsections": [] }, "READING THE GRAPH": { "content": "The general outline of a package's graph is typically a series of peaks, starting at 1, going\nup to n, and then returning abruptly to 1. The higher the peaks, the more releases the main‐\ntainer made between new upstream versions of the package. If a package is Debian-only, it's\ngraph will just grow upwards without ever falling (although a bug in this program may cause\nit to fall sometimes, if the version number goes from say, 0.9 to say, 0.10 - this is inter‐\npreted wrong...)\n\nIf the graph dips below 1, someone made a NMU of the package and upgraded it to a new up‐\nstream version, thus setting the Debian version to 0. NMU's in general appear as fractional\npoints like 1.1, 2.1, etc. A NMU can also be easily detected by looking at the points that\nrepresent which maintainer uploaded the package -- a solitary point of a different type than\nthe points before and after it is typically a NMU.\n\nIt's also easy to tell by looking at the points when a package changes maintainers.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-l --linecount", "content": "Instead of using the Debian version number as the Y axis, use the number of lines in\nthe changelog entry for each version. Cannot be used together with --bugcount.\n", "flag": "-l", "long": "--linecount" }, { "name": "-b --bugcount", "content": "Instead of using the Debian version number as the Y axis, use the number of bugs that\nwere closed by each changelog entry. Note that this number is obtained by searching\nfor \"#dddd\" in the changelog, and so it may be inaccurate. Cannot be used together\nwith --linecount.\n", "flag": "-b", "long": "--bugcount" }, { "name": "-c --cumulative", "content": "When used together with either --bugcount or --linecount, graphs the cumulative count\nrather than the count in each individual changelog entry.\n", "flag": "-c", "long": "--cumulative" }, { "name": "-v --no-version", "content": "Do not show upstream version labels. Useful if the graph gets too crowded.\n", "flag": "-v", "long": "--no-version" }, { "name": "-m, --no-maint", "content": "Do not differentiate between different maintainers of the package.\n", "flag": "-m", "long": "--no-maint" }, { "name": "-s --save=", "content": "Save the graph to file in PostScript format instead of immediately displaying it.\n", "flag": "-s" }, { "name": "-u --urgency", "content": "Use larger points when displaying higher-urgency package uploads.\n", "flag": "-u", "long": "--urgency" }, { "name": "--verbose", "content": "Output the gnuplot script that is fed into gnuplot (for debugging purposes).\n", "long": "--verbose" }, { "name": "-g --gnuplot=", "content": "This allows you to insert gnuplot(1) commands into the gnuplot script that is used to\ngenerate the graph. The commands are placed after all initialization but before the\nfinal plot command. This can be used to override the default look provided by this\nprogram in arbitrary ways. You can also use things like \"set terminal png color\" to\nchange the output file type, which is useful in conjunction with the -s option.\n\n--help Show a usage summary.\n", "flag": "-g" }, { "name": "--version", "content": "Display version, author and copyright information.\n\n--noconf, --no-conf\nDo not read any configuration files (see below).\n\nchangelog ...\nThe changelog files to graph. If multiple files are specified they will all be dis‐\nplayed on the same graph. The files may be compressed with gzip. Any text in them that\nis not in Debian changelog format will be ignored.\n", "long": "--version" } ] }, "CONFIGURATION VARIABLES": { "content": "The two configuration files /etc/devscripts.conf and ~/.devscripts are sourced by a shell in\nthat order to set configuration variables. The --no-conf option can be used to prevent read‐\ning these files. Environment variable settings are ignored when these configuration files\nare read. The currently recognised variables are:\n\nPLOTCHANGELOGOPTIONS\nThis is a space-separated list of options to always use, for example -l -b. Do not\ninclude -g or --gnuplot among this list as it may be ignored; see the next variable\ninstead.\n\nPLOTCHANGELOGGNUPLOT\nThese are gnuplot commands which will be prepended to any such commands given on the\ncommand line.\n", "subsections": [] }, "SEE ALSO": { "content": "devscripts.conf(5)\n", "subsections": [] }, "AUTHOR": { "content": "Joey Hess \n\n\n\nDEBIAN Debian Utilities PLOTCHANGELOG(1)", "subsections": [] } } } }