From 3cd86ca149224dbf53ee43dd9f8cd2e702d49043 Mon Sep 17 00:00:00 2001 From: Nicholas Guriev Date: Thu, 27 Apr 2017 18:47:40 +0300 Subject: New initial commit I can't understand which a commit corresponds to the version 0.6.27+nmu7 so I'm making a new one with all files taken from unstable repository. --- debian/NEWS | 23 ++ debian/README.Debian | 227 +++++++++++ debian/changelog | 897 +++++++++++++++++++++++++++++++++++++++++ debian/compat | 1 + debian/control | 26 ++ debian/copyright | 25 ++ debian/cron.monthly | 28 ++ debian/cron.weekly | 26 ++ debian/dhelp.lintian-overrides | 4 + debian/dirs | 7 + debian/menu | 6 + debian/postinst | 194 +++++++++ debian/prerm | 110 +++++ debian/rules | 23 ++ debian/scripts/files.sh | 139 +++++++ debian/scripts/httpd.sh | 265 ++++++++++++ debian/scripts/info.sh | 84 ++++ debian/source/format | 1 + debian/stamp-makefile-check | 0 19 files changed, 2086 insertions(+) create mode 100644 debian/NEWS create mode 100644 debian/README.Debian create mode 100644 debian/changelog create mode 100644 debian/compat create mode 100644 debian/control create mode 100644 debian/copyright create mode 100755 debian/cron.monthly create mode 100755 debian/cron.weekly create mode 100644 debian/dhelp.lintian-overrides create mode 100644 debian/dirs create mode 100644 debian/menu create mode 100755 debian/postinst create mode 100755 debian/prerm create mode 100755 debian/rules create mode 100644 debian/scripts/files.sh create mode 100644 debian/scripts/httpd.sh create mode 100644 debian/scripts/info.sh create mode 100644 debian/source/format create mode 100644 debian/stamp-makefile-check (limited to 'debian') diff --git a/debian/NEWS b/debian/NEWS new file mode 100644 index 0000000..bb47dd7 --- /dev/null +++ b/debian/NEWS @@ -0,0 +1,23 @@ +dhelp (0.6.21) unstable; urgency=low + + The coverage of supported web servers has been considerably expanded. + /usr/share/doc/dhelp/README.Debian contains instructions for those web + servers that require a manual step of configuration after installation + of dhelp. + + -- Georgios M. Zarkadas Fri, 04 May 2012 01:33:22 +0300 + +dhelp (0.6.20) unstable; urgency=low + + Indexing of new documents is now performed after the end of installation + procedure, as a background process. Thus, there are no more delays during + installation for systems with large number of registered documents. + + -- Georgios M. Zarkadas Mon, 03 Oct 2011 02:45:30 +0300 + +dhelp (0.5.25) unstable; urgency=low + + /etc/dhelp is obsolete now. It used to be contain browser configuration + information. Now dhelp uses sensible-browser. + + -- Esteban Manchado Velázquez Sat, 20 Oct 2007 15:08:17 +0200 diff --git a/debian/README.Debian b/debian/README.Debian new file mode 100644 index 0000000..8e444e4 --- /dev/null +++ b/debian/README.Debian @@ -0,0 +1,227 @@ +1. Debian Online Help fetures +============================================== + +Debian Online Help builds an index of all documentation in your system that +is registered with doc-base (and updates it when new packages are installed). +You can view this index with any web browser in two possible modes: + +1. Offline, using the file:// protocol. Just use the command: + + file:///usr/share/doc/HTML/index.html + +2. Online, by installing a web server of your choice and opening the URL: + + http://localhost/doc/HTML/index.html + +You can start Debian Online Help using the command `dhelp'. It will detect +if you are using a web server and start in online mode, else it will start +in offline mode. + +You can search for documentation relating to a particular query string using +the command `dhelp ', or use the search form if you have a web +server installed. + +Debian Online Help tries hard to not carry with it excessive dependencies +in order to allow you to accommodate any software setup without bringing in +unneeded components. All optional components will be used if found, but the +core functionality will still be provided if they are missing. If they get +installed in the future, they will be available at the next index update. + +The list below summarizes the available functionality in any possible setup. +Note that browsing offline through the file:/// protocol, as well as using +search through the `dhelp ' command remain functional in _all_ +cases. + +-- No web server installed: + + Only offline mode works. Online mode and CGI scripts do not. + If you do not wish to install even a web browser, you can still use the + `html2text' package to view the text of the index pages from the console. + +-- A web server that does not support CGI is installed: + + Offline and online modes work (web server may need manual configuration, + cf. section 1 below). CGI scripts do not work (ie the links to man and + info pages, the online mode's links to the documentation and the search + web form). + +-- A web server that supports CGI is installed, but man2html/info2www aren't + + Offline and online modes work, as well as the the online mode's links to + the documentation and the search web form. The links to man/info pages + are inactive. + +-- A web server that supports CGI as well as man2html/info2www are installed + + The full functionality of Debian Online Help is available. + + +2. Configuring dhelp to work with a web server +============================================== + +Debian Online Help comes pre-configured for quite a few web servers that +support aliases. If this is your case, then no further actions are needed +(you may have to issue the command `dpkg-reconfigure dhelp' in case you +are installing the web server _after_ dhelp has been installed). + +For some web servers though that support aliases and for all web servers +that do not support them, it is required to do a few actions by hand in +order to finish dhelp configuration. + +The following tables summarize the situation and gives instructions for +dhelp configuration with each web server: + +Table #1: Web servers that _do not_ require manual configuration +------------------------------------------------------------------------------ +boa : The default boa configuration has the /doc alias enabled. +------------------------------------------------------------------------------ +lighttpd : A configuration snippet is installed during dhelp installation. +------------------------------------------------------------------------------ +mathopd : The default mathopd configuration has the /doc alias enabled. +------------------------------------------------------------------------------ + +Table #2: Web servers that _may_ require manual configuration +------------------------------------------------------------------------------ +apache2 : A configuration snippet is installed during dhelp installation. + + For newer versions of the package (squeeze: >=2.2.16-6+squeeze7, + wheezy: >=2.2.22-4, all: >=2.4.1) you will have to enable the + /doc alias manually due to CVE-2012-0216. + + Action : Uncomment the `Alias /doc/ ...' line inside the installed dhelp + configuration snippet for apache2. Its path depends on apache2 + version. + < 2.4 : /etc/apache2/conf.d/dhelp.conf + >= 2.4 : /etc/apache2/conf-available/dhelp.conf +------------------------------------------------------------------------------ + +Table #3: Web servers that _do_ require manual configuration +------------------------------------------------------------------------------ +bozohttpd : Does not support aliases. Action : cf. [1] below. +------------------------------------------------------------------------------ +micro-httpd : Does not support aliases. Action : cf. [1] below. +------------------------------------------------------------------------------ +mini-httpd : Does not support aliases. Action : cf. [1] below. +------------------------------------------------------------------------------ +monkey : Does not support aliases. + + [1] Action : Create a symlink named `doc' to `/usr/share/doc', inside + the web server's document root (Debian default is /var/www). + The command to create it is: + + ln -s /usr/share/doc /var/www/doc +------------------------------------------------------------------------------ +nginx : The default nginx configuration has the /doc alias enabled, but + the server does not support CGI scripts by default. + + Action : Install the `fcgiwrap' package and copy the following line to + the `server {...}' block of the default virtual site (its path + is: /etc/nginx/sites-available/default): + + include /usr/share/doc/fcgiwrap/examples/nginx.conf +------------------------------------------------------------------------------ +yaws : An example configuration file for dhelp is provided at + `/usr/share/dhelp/config/yaws-dhelp.conf', but is not installed + in `/etc/yaws/conf.avail' because yaws does not allow overlayed + directives. + In addition, the cgi scripts coming with dhelp cannot work as is + because they lack the `.cgi' extension. + + Action : Use the supplied dhelp configuration snippet to manually edit + your configuration. To support the dhelp cgi scripts you need + to create a wrapper erlang appmode and edit the configuration + to load it. +------------------------------------------------------------------------------ + +Any web server not listed in the tables above will most probably require +manual configuration. The recipy in [1], above, will work with any web +server, so this is the first thing to try. + +The dhelp configuration snippets provided at /usr/share/dhelp/config, as +`-dhelp.conf' for each web server, list additional information +in case you would like to create a custom dhelp configuration. + + +3. Notes about indexing in dhelp +================================ + +3.1 How the indexer is run +========================== + +The scheduling of the indexer process was completely redesigned in version +0.6.20, in order to solve the problem that the policy of index-when-installing- +packages creates (namely long delays in the overall installation of packages +when the size of installed documentation grows). + +Now dhelp indexes even during installation, but in a deferred way. That is, +registration of new documents or even the pool-rebuild (issued by the commands + + dhelp_parse -a + +and + + dhelp_parse -r + +respectively) does not start the indexer but instead writes the filenames of +the documents to be indexed in a cache list. This list is later reopened +(by a Dpkg post-install trigger) and fed to the indexer through a background +running process. + +Note that the indexing during install is incremental by default, in order to +finish the indexing quicker. This does not hurt overall searching capabilities +since the index will be fully rebuilt anyway by the weekly cron job. + +If for any reason the indexer does not run and you are left with a non-empty +cache file (it is located in /var/lib/dhelp/pending.list) you can start the +indexer manually, issuing the command: + + sudo dhelp_parse -i + +To force reindexing of all the currently installed documentation you can +either issue the sequence of commands: + + sudo dhelp_parse -r + sudo dhelp_parse -i + +or call the weekly cron job directly: + + sudo /etc/cron.weekly/dhelp + +To force (incremental) reindexing of certain packages you can use the utility +provided in the examples/ directory. You should use it like this: + + sudo ruby /usr/share/doc/dhelp/examples/index_package_doc.rb ... + + +3.2 Error reporting +=================== + +Up to version 0.6.19 error messages generated during indexing by the format +conversion tools where copied verbatim to the indexers error report. That +resulted in lengthy and hard to understand messages from the weekly cron job +in the cases where a package had registered a document that could not be +converted. + +From version 0.6.20 and later, raw conversion error messages are hidden from +the indexer's error report; instead the full filename of the offending file is +printed, so that the source of the error can easily identified. You can then +manually try to convert the file in order to see the exact errors generated. + + +3.3 Log files +============= + +From version 0.6.20 and above, the Dpkg post-install trigger as well as the +weekly cron job generate a log file with the output from the indexer process +inside directory /var/lib/dhelp/tmp. + +The log filename contains the date that the process started as its first +component. If something does not work as expected, you can search for logs +with non-zero file size and view their content. + +A monthly cron job deletes all but the five last logs, in order to keep under +control the size they occupy. + + +-- Esteban Manchado Velázquez +-- Georgios M. Zarkadas diff --git a/debian/changelog b/debian/changelog new file mode 100644 index 0000000..ced1272 --- /dev/null +++ b/debian/changelog @@ -0,0 +1,897 @@ +dhelp (0.6.21+nmu7) unstable; urgency=medium + + * Non-maintainer upload. + * Properly orphan the package. + + -- Ondřej Surý Wed, 07 Dec 2016 11:15:51 +0100 + +dhelp (0.6.21+nmu6) unstable; urgency=medium + + * Non-maintainer upload. + * Fix "Fails to build the index when invalid UTF-8 is met": + apply patch from Daniel Getz: + + Load files as UTF-8, regardless of $LANG + (Closes: #768127) + + -- gregor herrmann Fri, 12 Dec 2014 22:02:20 +0100 + +dhelp (0.6.21+nmu5) unstable; urgency=medium + + * Non-maintainer upload. + * Update French program translation (Closes: #684664) + * Update Russian program translation (Closes: #688667) + * Update German program translation (Closes: #689063) + * Add Danish program translation (Closes: #689644) + * Add Italian program translation (Closes: #689920) + * Add Portugese program translation (Closes: #724781) + + -- Helge Kreutzmann Thu, 02 Oct 2014 12:38:19 +0200 + +dhelp (0.6.21+nmu4) unstable; urgency=low + + * Non-maintainer upload. + * Add support for newer ruby versions (Closes: #734523, #732916) + * Cache 'Dpkg.status' calls to not affect performance on every system + upgrade (Closes: #712621) + * Handle correctly arguments passed to '-a' and '-d' options + * Fix error when 'dhelp_parse' is called without arguments + * Fix Ruby warnings + * Change the encoding of Ruby files to UTF-8 + + -- David Suárez Sun, 18 May 2014 13:18:39 +0200 + +dhelp (0.6.21+nmu3) unstable; urgency=low + + * Non-maintainer upload. + * Fix apache2 2.4 issues: install different config files into + /etc/apache2/conf.d and /etc/apache2/conf-available (for versions 2.2 + and 2.4 respectively), and call apache2-maintscript-helper with + correct parameters (Closes: #718588) + + -- Julian Gilbey Sun, 22 Sep 2013 11:07:22 +0100 + +dhelp (0.6.21+nmu2) unstable; urgency=low + + * Non-maintainer upload. + * Change build and runtime dependency from libgettext-ruby1.8 to + ruby-gettext. Closes: #707686 + + -- gregor herrmann Fri, 17 May 2013 17:58:05 +0200 + +dhelp (0.6.21+nmu1) unstable; urgency=low + + * Non-Maintainer Upload + * Dropped the declaration of dependence on ruby-commandline, which was + already done on the code + + -- Gunnar Wolf Mon, 02 Jul 2012 12:16:40 -0500 + +dhelp (0.6.21) unstable; urgency=low + + * New maintainer: Georgios M. Zarkadas (Closes: #650441). + * Support other web servers in addition to apache2 (Closes: #669041). + * Support apache2 packaging transition for version 2.4 (Closes: #669758). + * Support new ruby packaging policy transition for Wheezy. + * Use OptionParser instead Commandline::Application (Closes: #678055). + Thanks Gunnar Wolf. + * Support new layout of man2html cgi scripts for Wheezy. + * Keep supporting previous policies/layouts, either during build time or + during runtime, to aid backporting. + * Man and info pages links are activated only if associated packages are + installed on the system. + * Subsections now show in the sections list only if section is selected. + * New color, styles and icons themes. + * Package installation now does not fail if cache data cannot be generated + during install. + * Fix some minor lintian warnings. + * Bump Standards-Version to 3.9.3. + + -- Georgios M. Zarkadas Tue, 12 June 2012 21:50:00 +0300 + +dhelp (0.6.20) unstable; urgency=low + + [ Georgios M. Zarkadas ] + * New co-maintainer: Georgios M. Zarkadas . + * Fix incomprehensible error messages in dhelp cron output; now the + document's filename is reported (Closes: #561883). + * Fix unsorted documents in the section index; they are now sorted + on title (Closes: #567889). + * Fix running the indexer on each individual package install; now the + indexing is deferred until the end of installation (Closes: #615900). + * Fix removing an unrelated directory from the postrm script; this + legacy code has now been removed (Closes: #642273). + * Added Greek translation (Closes: #641917). + * Bump Standards-Version to 3.9.1. + + [ Esteban Manchado Velázquez ] + * Sponsor the upload :-) + + -- Esteban Manchado Velázquez Thu, 13 Oct 2011 00:08:15 +0200 + +dhelp (0.6.19) unstable; urgency=low + + * Fix URI escaping (Closes: #583349). Thanks John Gruenenfelder. + * Bump Standards-Version to 3.8.4. + + -- Esteban Manchado Velázquez Sun, 30 May 2010 20:04:19 +0200 + +dhelp (0.6.18) unstable; urgency=low + + * Change xpdf-utils dependency to poppler-utils (Closes: #550656). Thanks + Moritz Muehlenhoff. + + -- Esteban Manchado Velázquez Sun, 08 Nov 2009 14:47:55 +0100 + +dhelp (0.6.17) unstable; urgency=low + + * Take into account index files when registering directories. + * Added Indonesian translation (thanks Atoz Chevara). + * Match 'localhost' instead of IPs in Apache config files (Closes: #526010). + Thanks Stefano Zacchiroli. + + -- Esteban Manchado Velázquez Sun, 03 May 2009 17:15:05 +0200 + +dhelp (0.6.16) unstable; urgency=low + + * Include Apache configuration file to limit dhelp CGI access to localhost. + * dhelp_fetcher: Don't give hints about which files exist in the filesystem + * Be smarter about indexing: check if the documents are already registered, + and only index if they weren't. This will skip indexing for package + upgrades, but will keep it for installation of new packages. + * Follow symlinks when indexing. + * Add a simple verbose option to dhelp_parse. + * Take the package version from the changelog, instead of checking that the + version in the changelog and the one in the Makefile are in sync. This + avoids FTBFS for binary-only NMUs (Closes: #521910). + + -- Esteban Manchado Velázquez Sun, 05 Apr 2009 18:48:01 +0200 + +dhelp (0.6.15) unstable; urgency=low + + * Don't depend on libdb4.2-ruby1.8 (transitional package) (Closes: #496682). + Thanks Thomas Viehmann and Scott Kitterman. + * Capitalise all sections properly (Closes: #502557). + * Fix encoding issues. Assume UTF-8 locale though (Closes: #491971). + * Change WordThreshold to 50000. It's better for low memory machines, and + both dwww and man2html are using that setting (Closes: #471558). Thanks + Stellan Klebom. + * Fix issues flagged by lintian: Depend on ${misc:Depends} (because of + debhelper), call dhelp_parse without using absolute paths and bump + Standards-Version to 3.8.1. + + -- Esteban Manchado Velázquez Tue, 17 Mar 2009 19:01:58 +0100 + +dhelp (0.6.14) unstable; urgency=low + + * Fix stupid typo for the previous fix, that made the weekly cron job not + being able to regenerate the documentation (Closes: #502813). + * Make the utility for indexing documentation a bit more robust, so it can + cope with existing, but empty, indexes. + + -- Esteban Manchado Velázquez Mon, 20 Oct 2008 22:31:06 +0200 + +dhelp (0.6.13) unstable; urgency=low + + * Not index documents on upgrade, to prevent dhelp blocking the + upgrade for hours (Closes: #487722). + * Add some small utilities to index by hand, because of the above change. + + -- Esteban Manchado Velázquez Thu, 02 Oct 2008 00:50:47 +0200 + +dhelp (0.6.12) unstable; urgency=low + + * Switch from pstotext to pdftotext from xpdf-utils for PDF files. It + seems much more reliable (less "random" errors when parsing documents). + Hopefully closes: #475655. + * Use /var/lib/dhelp/tmp instead of /var/tmp for temporary files, to avoid + possible security issues (thanks Laurent Bonnaud). + + -- Esteban Manchado Velázquez Wed, 23 Jul 2008 01:49:55 +0200 + +dhelp (0.6.11) unstable; urgency=low + + * Don't panic even if the document doesn't declare any files (???). Also add + some useful debug information if that happens (Closes: #490577). + * Bump Standards-Version to 3.8.0. + + -- Esteban Manchado Velázquez Sun, 20 Jul 2008 20:14:22 +0200 + +dhelp (0.6.10) unstable; urgency=low + + * Handle nil in uri_escape (hopefully closes: #487722). + + -- Esteban Manchado Velázquez Tue, 24 Jun 2008 23:39:03 +0200 + +dhelp (0.6.9) unstable; urgency=low + + * Update French translation (Closes: #481069). Thanks Steve Petruzzello. + * Update documentation (OMG horribly outdated OMG). + + -- Esteban Manchado Velázquez Thu, 29 May 2008 22:56:06 +0200 + +dhelp (0.6.8) unstable; urgency=low + + * The "UTF-8 FTW" release. + * Change HTML pages encoding to UTF-8. + * Force HTML exporter to output UTF-8. + * Force dsearch to output UTF-8. + * Add initial French translation (Closes: #458836). Thanks David Kremer and + Christian Perrier! + * Add initial Russian translation (Closes: #466090). Thanks Yuri Kozlov! + * Add initial German translation (Closes: #466263). Thanks Helge Kreutzmann! + * Add initial Basque (Euskera) translation. Thanks Piarres Beobide! + * Strip accepted languages from the browser correctly. + + -- Esteban Manchado Velázquez Sun, 24 Feb 2008 19:33:12 +0100 + +dhelp (0.6.7) unstable; urgency=low + + * Refactor to fix a bug in which newly added documents wouldn't have their + directories registered, so you couldn't see the registered documentation + from the documentation directory. + * Fix a bug with PDF documents given as a glob (e.g. xapian-apidocs + specifies its PDF version as ".../apidoc.pdf*", so it works with both + apidoc.pdf and apidoc.pdf.gz). + * Make dhelp_parse accept multiple arguments for -a and -d again. + + -- Esteban Manchado Velázquez Thu, 14 Feb 2008 00:15:22 +0100 + +dhelp (0.6.6) unstable; urgency=low + + * Don't show in the directory any documents that don't have any supported + format. + * Add "DVI" to supported formats for the documentation directory. + * Add firefox to Recommends, for Ubuntu compatibility (Closes: #454517). + * Bump debhelper compatibility level to 5. + * Use /var/tmp for temporary files (Closes: #458546). + * Behave with doc-base (in particular, install-docs). Now parameters to -a + and -r options in dhelp_parse are interpreted as what they are now: + doc-base file paths. + * Don't choke with missing "Files" field (Closes: #455731). + * Bump Standards-Version to 3.7.3 + * Remove bashism in Makefile (Closes: #463582). + + -- Esteban Manchado Velázquez Sun, 03 Feb 2008 17:10:10 +0100 + +dhelp (0.6.5) unstable; urgency=low + + * Index *.pdf and *.txt. Otherwise, it seems only PDF files are indexed. + * Add a rule for converting PS files to text prior to indexing. + * Move pstotext to dependencies, because it is needed for indexing. + * Add dhelp_fetcher.rb, a script to get the contents of a doc-base + registered documentation file. It uncompresses PDF and PS files for easy + viewing inside a browser. + * Only index files, never directories (directories can be specified + implicitly by a glob, but those aren't part of the documentation). + * Fix a couple of problems on upgrade (Closes: #452873). + * Fix some issues with offline mode. + * Fix subsubsections in the generated documentation directory. + * Add a hack to avoid 3rd party error messages at installation time. + + -- Esteban Manchado Velázquez Thu, 06 Dec 2007 18:03:40 +0100 + +dhelp (0.6.0) unstable; urgency=low + + * Changed all the indexing system so it now searches in the registered + document, instead of in the HTML directory generated by dhelp. + * Make .dhelp files obsolete, just use doc-base files directly. They contain + more information, maintenance is easier over all (we get rid of pointless + conversions), and we get rid of bugs + (Closes: #19076, #429233, #334789, #347980, #155054, #177668, #19076). + * Clean up dhelp.pot file weirdness (Closes: #448211). + * Removed the hardcoded HTML in favour of using templates, redesign the + appearance of all pages, and made all those templates translatable to + different languages using gettext. + * Added configuration file to specify directories to search for doc-base + files (Closes: #81405). + * Add a special, "all" section with all the documents (Closes: #188258). + * Show relevant portions of the results when searching (Closes: #272953). + * Order sections (Closes: #283402). + * Remove remaining debconf traces. Apart from not being used anymore, it was + making the postinst wait for the indexing even if it was run in the + background. + * Depend on swish++ instead of just recommending it. + * Recommend or suggest different packages that give preview on search + results + * Change mozilla-firefox dependency to iceweasel. + + -- Esteban Manchado Velázquez Sun, 25 Nov 2007 20:00:58 +0100 + +dhelp (0.5.25) unstable; urgency=low + + * Maintainer change. + * Rewrite dhelp_parse in Ruby. This fixes some bugs and avoids many problems + (Closes: #21678, #268487, #62454, #312950, #442943, #444429, #193428). + * This release should be a drop-in replacement for the C version, and still + uses the same database and internal format. + * It also adds a Ruby library, to allow other developers to write other + programs that read and/or update the dhelp databases. + * Use "http://localhost" for CGI script URLs (Closes: #114588). + * Removed misleading dot from example (Closes: #381804). + * Uses sensible-browser instead of having its own configuration system + (Closes: #146002, #162518, #381805, #217162, #430590). + * Clean up the HTML a bit (Closes: #438973, #134567, #115306). + * Remove references to obsolete script dh_dhelp (Closes: #369459). + * Raise title limit from 49 to 100 characters (Closes: #102393). + * Depend on doc-base, to make sure packages have their documentation + available for dhelp (Closes: #314733, #368035). + * Wait a couple of seconds before exiting, after a fatal error, to make sure + the user can read the error message (Closes: #35097). + * Make documentation index files world-readable, regardless of current umask + (Closes: #158792, #430474, #430505). + * Remove obsolete script dhelp2dwww.pl, and references to it + (Closes: #364245). + * Remove "dangerous" environment variables from dsearch, to avoid taint + problems (Closes: #389944). + * Strip blanks from .dhelp field values (Closes: #133218). + + -- Esteban Manchado Velázquez Sat, 20 Oct 2007 17:35:26 +0200 + +dhelp (0.5.24-0.1) unstable; urgency=low + + * Non-maintainer upload. + * Build against libdb4.5-dev (Closes: 282172). + * Update build-system. + + -- Pierre Habouzit Fri, 20 Jul 2007 16:17:52 +0200 + +dhelp (0.5.24) unstable; urgency=low + + * updated Vietnamese translation of debconf templates (Closes: #397099, + thanks to Clytie Siddall ) + * added Romanian translation of debconf templates (thanks to Eddy + Petrisor ) + * added Russian translation of debconf templates (Closes: #343843, + thanks to Yuri Kozlov ) + * added Swedish translation of debconf templates (Closes: #332367, + thanks to Daniel Nylander ) + * added Spanish translation of debconf templates (Closes: #336068, + thanks to César Gómez Martín" ) + * switched changelog to UTF-8, fixed odd date entry + * new FSF address in Debian copyright + + -- Stefan Hornburg (Racke) Thu, 9 Nov 2006 21:19:44 +0100 + +dhelp (0.5.23) unstable; urgency=low + + * debconf-2.0 alternative dependency added (Closes: #331801, thanks to + Joey Hess for the report) + + -- Stefan Hornburg (Racke) Wed, 5 Oct 2005 10:00:17 +0200 + +dhelp (0.5.22) unstable; urgency=high + + * applied patch from Robert Harris to + avoid segmentation faults (Closes: #330488, thanks to Daniel Schepler + for the report) + * fixed wrong spelling in dhelp file (Closes: #31212, thanks to Esteban + Manchado Velázquez for investigations) + * added Vietnamese translation of debconf templates (Closes: #311586, + thanks to Clytie Siddall ) + * added Portuguese translation of debconf templates (Closes: #315874, + thanks to Miguel Figueiredo ) + + -- Stefan Hornburg (Racke) Fri, 26 Aug 2005 10:10:52 +0200 + +dhelp (0.5.21) unstable; urgency=low + + * added Czech translation of debconf templates (Closes: #308205, thanks + to Martin Sin ) + * added Japanese translation of debconf templates (Closes: #273603, thanks + to Hideki Yamane ) + + -- Stefan Hornburg (Racke) Mon, 9 May 2005 14:08:46 +0200 + +dhelp (0.5.20) unstable; urgency=low + + * handle missing /usr/share/doc directory gracefully (Closes: #300440, + thanks to Marc Langer for the report and Gustavo + Franco for the patch) + * quote command in menu file + * use mozilla-firefox as real package for recommends on virtual package + www-browser + + -- Stefan Hornburg (Racke) Thu, 31 Mar 2005 20:24:45 +0200 + +dhelp (0.5.19) unstable; urgency=low + + * improved error messages from dsearch in respect of missing search + engine or database (Closes: #272614, #272951, thanks to James R. Van + Zandt for the patches) + * updated dhelp manual page (Closes: #147727) + + -- Stefan Hornburg (Racke) Thu, 23 Sep 2004 11:21:37 +0200 + +dhelp (0.5.18) unstable; urgency=low + + * properly untaint search specification in dsearch CGI script + (Closes: #229688, #254552, thanks to Dan Jacobson + and Dafydd Harries for + reporting) + * added German translation of debconf templates (Closes: #252329, thanks + to Erik Schanze ) + * added Dutch translation of debconf templates (Closes: #250233, thanks + to Luk Claes ) + * added Turkish translation of debconf templates (Closes: #252939, + thanks to Recai Oktas ) + + -- Stefan Hornburg (Racke) Wed, 16 Jun 2004 00:26:05 +0200 + +dhelp (0.5.17) unstable; urgency=low + + * Recognize epiphany as X11 browser (Closes: #241536, thanks to Dan + Korostelev for the report) + * Removed obsolete dh_dhelp script (Closes: #74846, #115047) + + -- Stefan Hornburg (Racke) Thu, 1 Apr 2004 23:34:39 +0200 + +dhelp (0.5.16) unstable; urgency=low + + * Changed maintainer back to Stefan Hornburg (Racke) + (Closes: #210439) + * Acknowledge bugs closed in NMUs + (Closes: #203082, #207793, #210657, #230351) + * Proper handling of creation and deletion of /var/lib/dhelp also fixes + another bug (Closes: #202213) + + -- Stefan Hornburg (Racke) Wed, 17 Mar 2004 02:32:11 +0100 + +dhelp (0.5.15-0.3) unstable; urgency=low + + * Non-maintainer upload + * *Really* apply Alexander Kogan patch. + + -- Christian Perrier Thu, 11 Mar 2004 09:07:24 +0100 + +dhelp (0.5.15-0.2) unstable; urgency=low + + * Non-maintainer upload + * Create /var/lib/dhelp in postinst. Closes: #230351 + Thanks to Alexander Kogan for the patch + * Switch to gettext for debconf templates. Closes: #207793 + * French debconf templates translation. Closes: #210657 + + -- Christian Perrier Mon, 8 Mar 2004 20:20:57 +0100 + +dhelp (0.5.15-0.1) unstable; urgency=low + + * Non-maintainer upload + * dhelp_parse.c: Changed stat() to lstat() in rm_r(), thanks to + John Belmonte (Closes: #203082) + + -- Roland Stigge Wed, 3 Sep 2003 22:16:25 +0200 + +dhelp (0.5.15) unstable; urgency=low + + * changing /cgi-bin/man2html to /cgi-bin/man/man2html in dhelp_parse. + (Closes: #182864) + * added Daniel Nouri, a good friend of mine and a amazing programmer to + the uploaders-field in debian/control. He will help me in maintaining + and developing dhelp in future. Thanks! :-) + * changed "make clean" to "make distclean" in debian/rules. Thanks to + Michael Banck for this hint. + * added dh_fixperms to debian/rules. + + -- Daniel K. Gebhart Fri, 28 Feb 2003 18:51:56 +0000 + +dhelp (0.5.14) unstable; urgency=low + + * switching maintainer to Daniel K. Gebhart + (Closes: #172346) + + -- Daniel K. Gebhart Sat, 18 Jan 2003 20:41:39 +0200 + +dhelp (0.5.13) unstable; urgency=low + + * deactivated warning message on directories not included in + /usr/share/doc/dhelp/.dhelp (Closes: #118600) + + -- Stefan Hornburg (Racke) Sat, 7 Sep 2002 23:59:00 +0200 + +dhelp (0.5.12) unstable; urgency=low + + * added debconf template translation to Brazilian Portuguese + (Closes: #144648, thanks to Paulo R. Ormenese ) + * modified icons to get the background color right (Closes: #147198, + thanks to Laurent Bonnaud for reporting and + Don Armstrong for providing the icons) + * removed unnecessary check on search parameters (Closes: #151184) + + -- Stefan Hornburg (Racke) Wed, 22 May 2002 02:22:55 +0200 + +dhelp (0.5.11) unstable; urgency=medium + + * made "other documents" link relative (Closes: #82757) + * avoid Perl warnings if browser undefined + * really set the defaults for console/X browsers + * removed gnome-help-browser from list of X browsers (Closes: #143869, + thanks to Thomas Langen for reporting it) + + -- Stefan Hornburg (Racke) Sun, 21 Apr 2002 15:57:26 +0200 + +dhelp (0.5.10) unstable; urgency=high + + * rewritten copyright file to comply with policy (Closes: #111762) + + -- Stefan Hornburg (Racke) Wed, 3 Apr 2002 13:36:24 +0200 + +dhelp (0.5.9) unstable; urgency=low + + * rewrite of the dhelp script: + - checks now if a WWW server listening on the localhost (Closes: #36880) + - browser is now configurable by debconf and configuration files + (Closes: #80218) + - provides a --help option now (thanks to Chris Tillman + , Closes: #126583) + * use .png images instead of .gif ones (Closes: #116676) + * more comprehensive description about accessing the online + help system in debian/control (Closes: #106957) + * directories database, help, misc and otherosfs added to debian/dhelp + (Closes: #119709) + + -- Stefan Hornburg (Racke) Tue, 19 Mar 2002 16:43:39 +0100 + +dhelp (0.5.8) unstable; urgency=low + + * dsearch displays appropriate message now in case of missing search + results (Closes: #67741, #123286) + * made dhelp script working with search tokens again + * removed obsolete dhelp_fsstnd + + -- Stefan Hornburg (Racke) Tue, 11 Dec 2001 15:44:16 +0100 + +dhelp (0.5.7) unstable; urgency=low + + * more titles added (Closes: #121279) + * remove /usr/doc/HTML2 on postinst (again Closes: #84206) + + -- Stefan Hornburg (Racke) Fri, 7 Dec 2001 15:36:27 +0100 + +dhelp (0.5.6) unstable; urgency=low + + * use Debian logo from http://www.debian.org (Closes: #46338) + * removed outdated README.debian (Closes: #119705) + * run dh_compress (Closes: #119759) + * remove /usr/doc/HTML2 on purge (Closes: #84206) + + -- Stefan Hornburg (Racke) Sat, 24 Nov 2001 16:52:32 +0100 + +dhelp (0.5.5) unstable; urgency=low + + * dsearch checks now if a search token is supplied (Closes: #34807) + * added missing entries to dhelp's .dhelp (Closes: #117362) + * added a warning if the title is missing + * typo and email address fixed in dhelp.html + + -- Stefan Hornburg (Racke) Sun, 28 Oct 2001 11:19:45 +0100 + +dhelp (0.5.4) unstable; urgency=low + + * images were installed in a subdirectory of /usr/share/doc/dhelp, + so they couldn't displayed in a browser accessing the dhelp pages + + -- Stefan Hornburg (Racke) Sun, 28 Oct 2001 11:05:39 +0100 + +dhelp (0.5.3) unstable; urgency=low + + * fixed a number of a places to stop dhelp_parse immediately if an error + occurs + * stop if string after in .dhelp starts with a slash + (Closes: #21361) + + -- Stefan Hornburg (Racke) Sat, 27 Oct 2001 19:42:39 +0200 + +dhelp (0.5.2) unstable; urgency=low + + * call dh_installdirs to ensure that /var/lib/dhelp exists (Closes: #116490) + * call make install instead of installing manually + + -- Stefan Hornburg (Racke) Sun, 21 Oct 2001 13:34:13 +0200 + +dhelp (0.5.1) unstable; urgency=low + + * chown of /var/lib/dhelp removed from postinst too (Closes: #60964) + * removed old Debian Online Help from menu file + * use Swish++ as search engine now (Closes: #57932, #63693, #92906, #111547) + * moved build operations to build target (Closes: #115455) + * CREDITS file added + * use dh_clean instead of removing files manually + * postinst rewritten, we no longer care about /usr/doc (Closes: #114922) + + -- Stefan Hornburg (Racke) Sat, 20 Oct 2001 13:12:00 +0200 + +dhelp (0.5.0) unstable; urgency=low + + * automake support added + * removed dhelp_parse_fsstnd (Closes: #89073) + * no longer give away /var/lib/dhelp to www-data (Closes: #60964) + + -- Stefan Hornburg (Racke) Thu, 4 Oct 2001 14:52:08 +0200 + +dhelp (0.3.24) unstable; urgency=low + + * Force usage of libdb3. (Closes: #112659) + + -- Stefan Hornburg (Racke) Mon, 24 Sep 2001 13:08:33 +0200 + +dhelp (0.3.23.2) unstable frozen; urgency=low + + * NMU + * include source this time. Closes: #104805. + + -- LaMont Jones Wed, 15 Aug 2001 23:45:58 -0600 + +dhelp (0.3.23) unstable frozen; urgency=low + + * dsearch: security fix for glimpse's temp files (#60853) + + -- Marco Budde Thu, 23 Mar 2000 21:42:05 +0100 + +dhelp (0.3.22) unstable frozen; urgency=low + + * dsearch: DoS security check (#60849) + + -- Marco Budde Tue, 21 Mar 2000 21:24:09 +0100 + +dhelp (0.3.21) unstable frozen; urgency=low + + * dsearch: dhelp console support fixed (#55545, #20891) + + -- Marco Budde Mon, 20 Mar 2000 22:24:48 +0100 + +dhelp (0.3.20) unstable frozen; urgency=low + + * installation scripts changed + * parser bug "can't open ..." fixed + + -- Marco Budde Sat, 29 Jan 2000 17:30:33 +0100 + +dhelp (0.3.19) unstable frozen; urgency=low + + * alpha patch (bug report #44082) added + * AOLserver support in dhelp (bug report #54527) + * dsearch: sorting bug solved, new look + * dsearch: supports /usr/doc *and* /usr/share/doc + -- please test this new feature -- + + -- Marco Budde Sat, 15 Jan 2000 18:34:29 +0100 + +dhelp (0.3.18) unstable frozen; urgency=low + + * dh_dhelp + * upload to frozen + + -- Marco Budde Tue, 4 Jan 2000 20:21:50 +0100 + +dhelp (0.3.17) unstable; urgency=low + + * most changes of 0.3.16 removed + * /usr/doc/HTML is a link to /usr/share/doc/HTML + * old packages can be found at /usr/doc/HTML2 + + -- Marco Budde Mon, 3 Jan 2000 20:22:22 +0100 + +dhelp (0.3.16) unstable; urgency=low + + * dh_dhelp: support for policy 3.1.0.0 + * fsstnd/dhelp_parse.c: hacked to follow symlinks + (policy 3.1.0.0) + * README in /usr/doc/HTML and /usr/share/doc/HTML added + (bug #49793: dhelp deletes this directories) + * documentation updated + + -- Marco Budde Fri, 31 Dec 1999 13:48:09 +0100 + +dhelp (0.3.15) unstable; urgency=low + + * dh_dhelp: + supports -p/-P options + + supports dh_installdeb + * dh_dhelp man page (new) + * policy 3.1.0.0 (package itself) + + -- Marco Budde Mon, 8 Nov 1999 14:54:21 +0100 + +dhelp (0.3.14) unstable; urgency=low + + * new dhelp_parse_fsstnd to support FSSTND. + + -- Marco Budde Mon, 20 Sep 1999 18:43:09 +0200 + +dhelp (0.3.13) unstable; urgency=low + + * dhelp: support for gnome-help-browser + * dhelp_parse.c: #include for "old" systems + * debian/cron.weekly: policy 3.0.0.0 + * dsearch: policy 3.0.0.0 + * man pages: policy 3.0.0.0 + + -- Marco Budde Tue, 20 Jul 1999 20:36:38 +0200 + +dhelp (0.3.12) unstable; urgency=low + + * Makefile: link with db1 + * dhelp_parse.c: #include + * Policy 3.0.x: /usr/share/doc + * new debian/menu (bug #41140) + * dhelp_parse.c: new look + * dhelp: support for gzilla & amaya added + + -- Marco Budde Tue, 13 Jul 1999 15:20:09 +0200 + +dhelp (0.3.11) unstable frozen; urgency=low + + * dhelp: perl -T problem solved (bug #31211) + * cron.weekly: cd / (bug #30499) + * dhelp_parse: core dump problem solved: variables to small + (bug #31602) + + -- Marco Budde Sat, 23 Jan 1999 20:30:21 +0000 + +dhelp (0.3.10-0.1) unstable frozen; urgency=low + + * no maintainer upload, because developer has no working + development system + * dhelp_parse: problems with long solved + * uploader note: read the diff from 0.3.9 on ftp.debian.org. Seems + OK to me (auth concerns). + + -- Yann Dirson Thu, 19 Nov 1998 21:57:28 +0100 + +dhelp (0.3.9) unstable; urgency=low + + * Danish translations + + -- Marco Budde Tue, 8 Sep 1998 21:58:51 +0200 + +dhelp (0.3.8) unstable frozen; urgency=low + + * debian/postinst: redirect glimpse messages to /dev/null + (reported bug) + * debian/control: httpd recommends -> suggests (reported bug) + Standards-Version: 2.4.0.1 + + -- Marco Budde Fri, 15 May 1998 7:21:03 +0200 + +dhelp (0.3.7) unstable frozen; urgency=low + + * debian/rules: create /var/lib/dhelp directory, needed to fix + problem between dhelp and doc-base + + -- Marco Budde Fri, 24 Apr 1998 20:17:05 +0100 + +dhelp (0.3.6) unstable frozen; urgency=low + + * man pages: + dhelp (en,de) + + dhelp_parse (en) + * dhelp: + searching without httpd bug fixed + + use local httpd (apache) if possible + + delete existing temp file (security) + * dhelp_parse: fixed error in get_item(), necessary for + long descriptions like in doc-linux-html + * debian/control + * doc/dhelp2dwww.pl: new script for package maintainers + * doc/sgml2dhelp.pl: new script for package maintainers + + -- Marco Budde Sun, 5 Apr 1998 18:12:43 +0100 + +dhelp (0.3.5) unstable frozen; urgency=low + + * dsearch: important security bugfixes + + -- Marco Budde Mon, 23 Mar 1998 20:34:29 +0100 + +dhelp (0.3.4) unstable; urgency=low + + * dh_dhelp: option -noleaf (NFS bug of Linux) + * debian/dhelp + * documentation + + -- Marco Budde Wed, 11 Mar 1998 20:43:20 +0100 + +dhelp (0.3.3) unstable; urgency=low + + * dh_dhelp: chmod + * bug fix: Spanish translation + * debian/posting: run glimpse in the background + * dsearch: French support (Yann) + * dhelp_parse: html_w_tail() French support + + -- Marco Budde Fri, 6 Mar 1998 16:54:20 +0100 + +dhelp (0.3.2) unstable; urgency=low + + * dsearch: bugfix + * dh_dhelp: script for package maintainers (!!!) + * Priority: optional + * doc/dhelp.html: description of dh_dhelp + + -- Marco Budde Fri, 27 Feb 1998 20:55:12 +0100 + +dhelp (0.3.1) unstable; urgency=low + + * dhelp_parse: foreign language support in html_w_tail () + (English, German, Italian, Spanish) + * new dsearch (written in Perl) with foreign language support + (English, German, Italian, Spanish) + * cgiparse binary removed (i386 -> any) + * dbugreport removed + * debian/dhelp: titles in Italian, Spanish + + -- Marco Budde Thu, 26 Feb 1998 21:04:20 +0100 + +dhelp (0.2.5) unstable; urgency=low + + * dhelp_parse: symlink problem #2 + * French titles (thanks Yann) + * dhelp_parse: better error checking + + -- Marco Budde Sun, 1 Feb 1998 18:10:21 +0100 + +dhelp (0.2.4) unstable; urgency=low + + * dhelp_parse: "/usr/doc is a symbolic link" problem solved + * /usr/bin/dhelp: X11 WWW browser + * documentation + * dhelp_parse: better error checking + * dhelp_parse: "recursive symbolic link in /usr/doc" problem solved + + -- Marco Budde Sat, 10 Jan 1998 11:20:32 +0100 + +dhelp (0.2.3) unstable; urgency=low + + * postinst + * cron.weekly -> conffiles + * dhelp_parse: compiled with option -O + + -- Marco Budde Thu, 8 Jan 1998 20:55:37 +0100 + +dhelp (0.2.2) unstable; urgency=low + + * dhelp_parse: missing tail bug fixed + * cron.weekly: bug fix for *.html.gz + + -- Marco Budde Tue, 6 Jan 1998 17:59:21 +0100 + +dhelp (0.2.1) unstable; urgency=low + + * Priority: standard + * dhelp_parse -r deletes /var/lib/dhelp/dbase + * dhelp_parse: better error checking, flag + * debian/dhelp includes for English, German groups + * cgiparse binary (from CERN httpd) + * dsearch (WWW search) + * dbugreport (report Debian bugs) + + -- Marco Budde Wed, 31 Dec 1997 14:34:59 +0100 + +dhelp (0.2-1) unstable; urgency=low + + * new dhelp_parse (written in C using db library), much faster + + -- Marco Budde Mon, 29 Dec 1997 18:53:33 +0100 + +dhelp (0.1-4) experimental; urgency=low + + * some bug fixes from Christian Schwarz + + -- Marco Budde Wed, 23 Jul 1997 18:50:06 +0200 + +dhelp (0.1-3) experimental; urgency=low + + * fix title bug in dhelp_index + + -- Marco Budde Mon, 30 Jun 1997 20:40:45 +0200 + +dhelp (0.1-2) experimental; urgency=low + + * several bug fixes + + -- Marco Budde Sat, 28 Jun 1997 19:20:13 +0200 + +dhelp (0.1-1) experimental; urgency=low + + * Initial release. + + -- Marco Budde Wed, 25 Jun 1997 13:04:34 +0200 + + diff --git a/debian/compat b/debian/compat new file mode 100644 index 0000000..7ed6ff8 --- /dev/null +++ b/debian/compat @@ -0,0 +1 @@ +5 diff --git a/debian/control b/debian/control new file mode 100644 index 0000000..2d5e420 --- /dev/null +++ b/debian/control @@ -0,0 +1,26 @@ +Source: dhelp +Section: doc +Priority: optional +Maintainer: Debian QA Group +Standards-Version: 3.9.3 +Build-Depends: debhelper (>= 5), cdbs (>= 0.4.23-1.1), + ruby-gettext + +Package: dhelp +Depends: perl-modules, libtemplate-perl, libhtml-parser-perl, + liburi-perl, liblocale-gettext-perl, libdata-page-perl, + ruby | ruby-interpreter, ruby-bdb, ruby-debian, ruby-gettext, + doc-base, swish++, pstotext, poppler-utils, ucf (>= 0.8), + ${misc:Depends} +Recommends: www-browser | html2text +Suggests: httpd-cgi, info2www, man2html, catdvi +Architecture: all +Description: online help system + Read all documentation with a WWW browser. dhelp builds an index of + all installed HTML documentation. You don't need a WWW server to read + the documentation. dhelp offers a very fast search in the HTML documents. + . + You can access the online help system with the dhelp program or with + your browser. The URL to point your browser at is (if you have a WWW + server installed) http://localhost/doc/HTML/index.html , else (if you + do not) file://localhost/usr/share/doc/HTML/index.html. diff --git a/debian/copyright b/debian/copyright new file mode 100644 index 0000000..fa6116b --- /dev/null +++ b/debian/copyright @@ -0,0 +1,25 @@ +Maintainer: + +© 1997-2000, Marco Budde +© 2001-2006, Stefan Hornburg (Racke) +© 2007-2011, Esteban Manchado Velázquez +© 2012, Georgios M. Zarkadas + +Copyright: + +This program is free software; you may redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +This is distributed in the hope that it will be useful, but without +any warranty; without even the implied warranty of merchantability or +fitness for a particular purpose. See the GNU General Public License +for more details. + +A copy of the GNU General Public License is available as +/usr/share/common-licenses/GPL-2 in the Debian GNU/Linux distribution +or on the World Wide Web at http://www.gnu.org/copyleft/gpl.html. +You can also obtain it by writing to the Free Software Foundation, Inc., +51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA. + diff --git a/debian/cron.monthly b/debian/cron.monthly new file mode 100755 index 0000000..67f2e45 --- /dev/null +++ b/debian/cron.monthly @@ -0,0 +1,28 @@ +#!/bin/sh +# Remove all but the newest five *.index-log.* files, to keep them +# from accumulating inside /var/lib/dhelp/tmp. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. + +if [ -d /var/lib/dhelp/tmp ]; then + ( + cd /var/lib/dhelp/tmp || exit + ls *.index-log.* \ + | sort --numeric-sort --field-separator='-' --key=1,4 --key=6,7 --key=9,10 \ + | head --lines=-5 \ + | xargs --no-run-if-empty --max-args=1 --max-lines=1 rm -f + ) +fi diff --git a/debian/cron.weekly b/debian/cron.weekly new file mode 100755 index 0000000..995c168 --- /dev/null +++ b/debian/cron.weekly @@ -0,0 +1,26 @@ +#! /bin/sh +# +# Copyright 2007 by Esteban Manchado Velázquez +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. + +if [ -d /var/lib/dhelp ] && \ + [ -x /usr/sbin/dhelp_parse ] && \ + [ -x /usr/bin/index++ ]; then + rm --force /var/lib/dhelp/documents.index || true + /usr/sbin/dhelp_parse -r + /usr/sbin/dhelp_parse -i +fi diff --git a/debian/dhelp.lintian-overrides b/debian/dhelp.lintian-overrides new file mode 100644 index 0000000..e0cf92e --- /dev/null +++ b/debian/dhelp.lintian-overrides @@ -0,0 +1,4 @@ +# The mentioned page is a local page, not the package homepage. +dhelp: description-possibly-contains-homepage http://localhost/doc/HTML/index.html +# The directory is filled by the postinst script. +dhelp: package-contains-empty-directory usr/share/doc/HTML/ diff --git a/debian/dirs b/debian/dirs new file mode 100644 index 0000000..66e7552 --- /dev/null +++ b/debian/dirs @@ -0,0 +1,7 @@ +usr/share/doc/HTML +var/lib/dhelp +var/lib/dhelp/tmp +/etc/apt/apt.conf.d +/etc/apache2/conf.d +/etc/apache2/conf-available +/etc/lighttpd/conf-available diff --git a/debian/menu b/debian/menu new file mode 100644 index 0000000..e8987f7 --- /dev/null +++ b/debian/menu @@ -0,0 +1,6 @@ +?package(dhelp):needs="X11" section="Help" \ +title="Debian Online Help" command="/usr/bin/dhelp" + +?package(dhelp):needs="text" section="Help" \ +title="Debian Online Help" command="/usr/bin/dhelp" + diff --git a/debian/postinst b/debian/postinst new file mode 100755 index 0000000..7bef8e8 --- /dev/null +++ b/debian/postinst @@ -0,0 +1,194 @@ +#!/bin/sh +# +# Copyright (C) 2001,2002 Stefan Hornburg (Racke) +# Copyright (C) 2007 Esteban Manchado Velázquez +# Copyright (C) 2011,2012 Georgios M. Zarkadas +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. + +set -e + +#DEBHELPER# + +#### Globals #### + +DHELP_INDEXER=/usr/share/dhelp/scripts/index-deferred +DHELP_APTHOOK=/etc/apt/apt.conf.d/35dhelp +DHELP_POSTCMD='Dpkg::Post-Invoke { + "if test -x '${DHELP_INDEXER}'; then '${DHELP_INDEXER}'; fi"; +};' +DHELP_OKINDEX="false" + +#### Import Library #### + +for DHELP_LIBFILE in /usr/share/dhelp/maint-scripts/*.sh; do + if [ -f ${DHELP_LIBFILE} ]; then + . ${DHELP_LIBFILE} + else + >&2 echo "Dhelp error: file ${DHELP_LIBFILE} was not found." + >&2 echo "Please file a bug report at bugs.debian.org" \ + "against the dhelp package." + fi +done + +#### Functions #### + +# cleanup artifacts of previous versions +# +do_upgrade_cleanup_actions () +{ + # remove /usr/doc/HTML, /usr/doc/HTML2 and /usr/doc/dhelp + # if upgrading from old dhelp package + + if [ -h /usr/doc/HTML ]; then + rm --force /usr/doc/HTML + elif [ -d /usr/doc/HTML ]; then + rm --force --recursive /usr/doc/HTML + fi + + if [ -d /usr/doc/HTML2 ]; then + rm --force --recursive /usr/doc/HTML2 + fi + + if [ -h /usr/doc/dhelp ]; then + rm --force /usr/doc/dhelp + fi + + # remove old /var/lib/dhelp/swish++.index (versions older than 0.6) + + if [ ! -d /var/lib/dhelp/swish++.index ]; then + rm --force /var/lib/dhelp/swish++.index + fi +} + +# create and register with ucf our dpkg post-invoke hook +# +register_dpkg_postinvoke_hook () +{ + local dhelp_tmp_apthook=$(mktemp) + + chmod 644 ${dhelp_tmp_apthook} + echo "${DHELP_POSTCMD}" > ${dhelp_tmp_apthook} + + mv_ucfregister_file dhelp ${dhelp_tmp_apthook} ${DHELP_APTHOOK} +} + +# build the set of html files inside /usr/share/doc/HTML +# +build_document_index () +{ + local ret=0 + + # 'dhelp_parse -r', among other actions, produces the pending list. + echo -n "Building HTML tree..." + + dhelp_parse -r && ret=$? || ret=$? + + if [ ${ret} -eq 0 ]; then + echo " done." + fi + return ${ret} +} + +# create the full text search index file in the background +# +delaybuild_search_index () +{ + local ret=0 + + # since the pending list is created by dhelp_parse -r, if index file + # does not exist, it suffices to do incremental indexing. + + if [ -f /var/lib/dhelp/documents.index ]; then + return 0 + else + echo "Reindexing documentation in the background" + + if [ -x ${DHELP_INDEXER} ]; then + ${DHELP_INDEXER} && ret=$? || ret=$? + return ${ret} + else + install_msg dhelp err \ + "Error: ${DHELP_INDEXER} does not exist or is not executable" + return 1 + fi + fi +} + +#### Main script body #### + +# NOTE: do not fail package installation if "cache data" that can be +# recreated anytime cannot for any reason be created during install. + +case $1 in +configure|abort-upgrade) + + # cleanup artifacts of previous versions + + do_upgrade_cleanup_actions + + # Create and register with ucf our dpkg post-invoke hook. + + register_dpkg_postinvoke_hook + + # Hack to tell if the package is configured, so that third party + # packages that call dhelp don't barf (from scrollkeeper package). + # It is also checked by dhelp_parse, hence this line must come + # _before_ the build_document_index call. + + touch /var/lib/dhelp/configured + + # Create the html document index before registering configuration + # snippets with installed web servers. + + if build_document_index; then + DHELP_OKINDEX="true" + else + install_msg dhelp err \ + "Error: building of the HTML tree failed;" \ + "check mount options and disk space for '/usr/share/doc/HTML'" \ + "and run 'dhelp_parse -r' to retry the build process." + fi + + # Try to enable web server configs (at most one is expected to succeed) + + try_chconf_apache2 "$1" "enable" dhelp || true + try_chconf_lighttpd "$1" "enable" dhelp || true + + # Create the full text search index at the end of postinst. + + if [ "${DHELP_OKINDEX}" = "true" ]; then + if delaybuild_search_index; then + : + else + install_msg dhelp err \ + "Error: delayed indexing failed;" \ + "run the weekly cron job to recreate the index." + fi + else + install_msg dhelp warning \ + "Not reindexing documentation due to HTML tree" \ + "build error; correct the above and run the weekly" \ + "cron job to recreate the index." + fi + ;; +*) + ;; +esac + +unset DHELP_INDEXER DHELP_POSTCMD DHELP_APTHOOK || true +unset DHELP_LIBFILE DHELP_OKINDEX || true + diff --git a/debian/prerm b/debian/prerm new file mode 100755 index 0000000..4d8744b --- /dev/null +++ b/debian/prerm @@ -0,0 +1,110 @@ +#!/bin/sh +# +# Copyright (C) 2001,2002 Stefan Hornburg (Racke) +# Copyright (C) 2011,2012 Georgios M. Zarkadas +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. + +set -e + +#DEBHELPER# + +#### Globals #### + +DHELP_APTHOOK=/etc/apt/apt.conf.d/35dhelp + +#### Import Library #### + +# If old version's prerm fails, our files (and thus the script library) +# will not be available. Thus, we need to treat this case specially. + +case $1 in +failed-upgrade) + ;; +*) + for DHELP_LIBFILE in /usr/share/dhelp/maint-scripts/*.sh; do + if [ -f ${DHELP_LIBFILE} ]; then + . ${DHELP_LIBFILE} + else + >&2 echo "Dhelp error: file ${DHELP_LIBFILE} was not found." + >&2 echo "Please file a bug report at bugs.debian.org" \ + "against the dhelp package." + fi + done + ;; +esac + +#### Functions #### + +# Cleanup the files installed by the postinst. +# +do_removal_cleanup_actions () +{ + # The directories themselves will be removed by dpkg; + # cf. our debian/dirs entries. + + # Remove all cache data inside /var/lib/dhelp/tmp + + if [ -d /var/lib/dhelp/tmp ]; then + rm --force /var/lib/dhelp/tmp/* || true + fi + + # Remove all cache data inside /var/lib/dhelp + # Hide the "rm: cannot remove `/var/lib/dhelp/tmp': Is a directory" error. + + if [ -d /var/lib/dhelp ]; then + rm --force /var/lib/dhelp/* 2>&1 \ + | grep --invert-match '/var/lib/dhelp/tmp' || true + fi + + # Remove html document index directory contents. + + if [ -d /usr/share/doc/HTML ]; then + rm --force --recursive /usr/share/doc/HTML/* + fi +} + +#### Main script body #### + +case $1 in +failed-upgrade) + # Library is not available; confine ourselves to the bare essentials. + + do_removal_cleanup_actions + ;; +*) + # Disable our web server configuration snippets. + + try_chconf_apache2 "$1" "disable" dhelp || true + try_chconf_lighttpd "$1" "disable" dhelp || true + + # Cleanup the files installed by the postinst. + + do_removal_cleanup_actions + ;; +esac + +case $1 in +purge) + # Remove and unregister with ucf our dpkg post-invoke hook. + + ucf_unregister_file dhelp ${DHELP_APTHOOK} + ;; +*) + ;; +esac + +unset DHELP_APTHOOK DHELP_LIBFILE || true diff --git a/debian/rules b/debian/rules new file mode 100755 index 0000000..2be9471 --- /dev/null +++ b/debian/rules @@ -0,0 +1,23 @@ +#!/usr/bin/make -f +# +# Invoke each target with `./debian/rules '. All targets should be +# invoked with the package root as the current directory. + +# Set VENDOR_RUBY to 'yes' to use the new ruby packaging policy for wheezy +# and onwards. Set to 'no' if you are back-porting the package. + +DEB_MAKE_ENVVARS := VENDOR_RUBY="yes" +#DEB_MAKE_ENVVARS := VENDOR_RUBY="no" + +DEB_MAKE_INSTALL_TARGET = install DESTDIR=$(DEB_DESTDIR) PREFIX=/usr +DEB_INSTALL_MANPAGES_dhelp = man/dhelp* +DEB_INSTALL_EXAMPLES_dhelp = examples/* + +include /usr/share/cdbs/1/rules/debhelper.mk +include /usr/share/cdbs/1/class/makefile.mk + +# Custom install of the maintainer scripts library. +install/dhelp:: + install --directory $(DEB_DESTDIR)/usr/share/dhelp/maint-scripts + install --mode=644 debian/scripts/*.sh $(DEB_DESTDIR)/usr/share/dhelp/maint-scripts + diff --git a/debian/scripts/files.sh b/debian/scripts/files.sh new file mode 100644 index 0000000..aa038fc --- /dev/null +++ b/debian/scripts/files.sh @@ -0,0 +1,139 @@ +# File operation functions for Debian maintainer scripts. +# Copyright (C) 2012 Georgios M. Zarkadas +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. +# +# This file is intended to be sourced by maintainer scripts. + + +# Test executability (implies existence) of a binary in the system's path. +# ARGS: +# $1=binary_basename +# +is_exec() +{ + # First ensure we are not passed an empty argument, + # because test -x "" returns success. + + if [ "X${1}" = "X" ]; then + return 2 + fi + + # Then look for the binary location. If not found, + # return error, because test -x "" returns success. + + local binary=$(which "${1}" 2>/dev/null) + + if [ "X${binary}" = "X" ]; then + return 1 + fi + + # If the binary is found, return its executable status. + + test -x "${binary}" 2>/dev/null +} + + +# Ucf-interfacing of generated conffiles helpers. +# Fall-through behaviour, when ucf is not available: +# -- install our version of the conffile +# -- if old conffile exists and is a file, rename old conffile to +# .ucf-old +# -- if old conffile or .ucf-old exists and is a directory, +# fail. + +# Copy a conffile to the filesystem and add it to the ucf and ucfr databases. +# ARGS: +# $1=package $2=source $3=destination +# +cp_ucfregister_file () +{ + local package="${1}" + local srcfile="${2}" + local conffile="${3}" + + if is_exec ucf; then + ucf --debconf-ok --three-way "${srcfile}" "${conffile}" + else + # If conffile is a symlink, our move-to-old-then-copy strategy + # would make the symlink a normal file; account for this. + + if [ -h "${conffile}" ]; then + + local realconf=$(readlink --no-newline \ + --canonicalize "${conffile}" || :) + + if [ "X${realconf}" = "X" ]; then + >&2 echo "${conffile} is a broken symlink; replacing it" + rm --force "${conffile}" + else + conffile="${realconf}" + fi + fi + + # Now, after resolving symlinks, check for existence and being a file. + + if [ -e "${conffile}" ]; then + if [ -d "${conffile}" ] || [ -d "${conffile}.ucf-old" ]; then + >&2 echo "${conffile} is a directory; aborting" + return 10 + fi + # We do not use the backup option, because in such a case + # we would being accumulating backups on each upgrade. + + mv --force "${conffile}" "${conffile}.ucf-old" + fi + cp --force --preserve "${srcfile}" "${conffile}" + fi + + if is_exec ucfr; then + ucfr "${package}" "${conffile}" + fi +} + +# Move a (temporary, ie dynamically created) conffile to the filesystem +# and add it to the ucf and ucfr databases. +# +# $1=package $2=source $3=destination +# +mv_ucfregister_file () +{ + cp_ucfregister_file "${1}" "${2}" ${3} + rm --force "${2}" +} + +# Remove a conffile from the filesystem and the ucf and ucfr databases. +# ARGS: +# $1=package $2=conffile +# +ucf_unregister_file () +{ + local package="${1}" + local conffile="${2}" + local ext + + # the '' value is to delete the file itself + for ext in '' '~' '%' .bak .ucf-new .ucf-old .ucf-dist; do + rm -f "${conffile}${ext}" || true + done + if is_exec ucf; then + ucf --purge "${conffile}" + fi + if is_exec ucfr; then + ucfr --purge "${package}" "${conffile}" + fi +} + diff --git a/debian/scripts/httpd.sh b/debian/scripts/httpd.sh new file mode 100644 index 0000000..f43716d --- /dev/null +++ b/debian/scripts/httpd.sh @@ -0,0 +1,265 @@ +# httpd configuration enable/disable functions for Debian maintainer scripts. +# Copyright (C) 2012 Georgios M. Zarkadas +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. +# +# This file is intended to be sourced by maintainer scripts. + +# REQUIRES: info.sh files.sh + +# (internal) message template functions + +# ARGS: +# $1=package $2=caller +# +_httpdmsg_nocfa() +{ + echo "${1} error: invalid action '${2}' supplied as argument" +} + +# ARGS: +# $1=caller_with_args +# +_httpdmsg_nopkg() +{ + echo "${1} error: package name was not supplied as argument" +} + +# ARGS: +# $1=package $2=httpd_name $3={enable,disable} +# +_httpdmsg_check() +{ + local text="" + if [ "${3}" = "disable" ]; then + text="de" + fi + echo "check the status of the ${2} web server and whether" \ + "${1} configuration for ${2} has been ${text}activated." +} + +# ARGS: +# $1=package $2=httpd_name $3={enable,disable} +# +_httpdmsg_noact() +{ + local text="" + if [ "${3}" = "disable" ]; then + text="de" + fi + echo "${1} configuration for ${2} has not been ${text}activated." +} + +# Return error if action is not (en/dis)able or package is empty. +# ARGS: +# $1=action $2=package $3=caller +# +_check_action_and_package() +{ + local action=${1} + local package=${2} + local caller=${3} + + local nopkg="false" + + if [ "X${package}" = "X" ]; then + package=unknown + nopkg="true" + fi + + case ${action} in + enable|disable) + ;; + *) + install_msg ${package} err $(_hhtpdmsg_nocfa ${package} ${caller}) + return 10 + ;; + esac + + if [ "${nopkg}" = "true" ]; then + install_msg ${package} err $(_httpdmsg_nopkg "${caller} ${action}") + return 11 + fi + + return 0 +} + +# Return {new,old,unknown} when, respectively, the apache2 package uses +# new / old packaging or it is not installed in the system. +# ARGS: none +# +apache2_packaging () +{ + if ! is_pkg_installed 'apache2'; then + echo 'unknown' + return + fi + + local aversion=$(get_pkg_version 'apache2') + local amajor=$(version_major "${aversion}") + local aminor=$(version_minor "${aversion}") + + local packaging="old" + case ${amajor} in + 2) + if [ ${aminor} -ge 4 ]; then + packaging="new" + fi + ;; + *) + if [ ${amajor} -gt 2]; then + packaging="new" + fi + ;; + esac + echo ${packaging} +} + +# Try to (en/dis)able an apache2 configuration snippet. +# Return error if (en/dis)abling tried and failed; caller *must* check status. +# ARGS: +# $1=maintscript-action (configure,abort-upgrade) +# $2={enable,disable} $3=package [$4=name_of_snippet_if_different_from_package] +# +try_chconf_apache2 () +{ + local action=${2} + local package=${3} + local confname=${4} + + local ret=0 + _check_action_and_package ${action} ${package} "try_chconf_apache2" \ + && ret=$? || ret=$? + if [ ${ret} -ne 0 ]; then + return ${ret} + fi + + local confaction + if [ "${action}" = "enable" ]; then + confaction=enconf + else + confaction=disconf + fi + + if [ "X${confname}" = "X" ]; then + confname=${package} + fi + + case $(apache2_packaging) in + new) + # The apache2_invoke function also reloads the web server + # if it is running. + + local ahelper=/usr/share/apache2/apache2-maintscript-helper + + if [ -e $ahelper ] ; then + . $ahelper + apache2_invoke ${confaction} ${confname}.conf && ret=$? || ret=$? + if [ ${ret} -ne 0 ]; then + install_msg ${package} warning \ + "apache2_invoke returned an error;" \ + $(_httpdmsg_check ${package} apache2 ${action}) + fi + return ${ret} + else + install_msg ${package} warning \ + "apache2-maintscript-helper not found;" \ + $(_httpdmsg_noact ${package} apache2 ${action}) + return 1 + fi + ;; + old) + # The apache2 init script uses apache2ctl configtest internally + # and also checks that the server is indeed running; thus there + # is no need to repeat these tests here. + + invoke-rc.d apache2 reload && ret=$? || ret=$? + if [ ${ret} -ne 0 ]; then + install_msg ${package} warning \ + "invoke-rc.d apache2 returned an error;" \ + $(_httpdmsg_check ${package} apache2 ${action}) + fi + return ${ret} + ;; + *) # can only be unknown in which case apache2 is not installed; return + ;; + esac +} + +# Try to (en/dis)able a lighttpd configuration snippet. +# Return error if (en/dis)abling tried and failed; caller *must* check status. +# ARGS: +# $1=maintscript-action (configure,abort-upgrade) +# $2={enable,disable} $3=package [$4=name_of_snippet_if_different_from_package] +# +try_chconf_lighttpd () +{ + local action=${2} + local package=${3} + local snippetname=${4} + + local ret=0 + _check_action_and_package ${action} ${package} "try_chconf_lighttpd" \ + && ret=$? || ret=$? + if [ ${ret} -ne 0 ]; then + return ${ret} + fi + + local confaction + if [ "${action}" = "enable" ]; then + confaction=lighty-enable-mod + else + confaction=lighty-disable-mod + fi + + if ! is_pkg_installed 'lighttpd'; then + return 0 + fi + + local confname=${package} + + if [ "X${snippetname}" != "X" ]; then + confname=${snippetname} + fi + + # lighty-xxx-mod will return 2 if no action is needed; workaround this. + + if is_exec ${confaction}; then + ${confaction} ${confname} && ret=$? || ret=$? + if [ $ret -eq 1 ]; then + install_msg ${package} warning \ + "${confaction} returned an error;" \ + $(_httpdmsg_noact ${package} lighttpd ${action}) + return 1 + fi + else + install_msg ${package} warning \ + "${confaction} not found;" \ + $(_httpdmsg_noact ${package} lighttpd ${action}) + return 2 + fi + + # Try to reload the web server configuration. + + invoke-rc.d lighttpd reload && ret=$? || ret=$? + if [ ${ret} -ne 0 ]; then + install_msg ${package} warning \ + "invoke-rc.d lighttpd returned an error;" \ + $(_httpdmsg_check ${package} lighttpd ${action}) + fi + return ${ret} +} + diff --git a/debian/scripts/info.sh b/debian/scripts/info.sh new file mode 100644 index 0000000..973d44d --- /dev/null +++ b/debian/scripts/info.sh @@ -0,0 +1,84 @@ +# Information retrieval/display functions for Debian maintainer scripts. +# Copyright (C) 2012 Georgios M. Zarkadas +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public +# License along with this program; if not, write to the Free +# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, +# MA 02111-1307 USA. +# +# This file is intended to be sourced by maintainer scripts. + + +# Return success if package is installed. +# +is_pkg_installed () +{ + LC_ALL=C dpkg --status ${1} 2>/dev/null \ + | grep --quiet '^Status: install ok installed' 2>/dev/null + return $? +} + +# Return the package version. +# +get_pkg_version () +{ + echo $(LC_ALL=C dpkg --status ${1} 2>/dev/null \ + | grep '^Version:' 2>/dev/null \ + | cut --fields=2 --delimiter=' ' 2>/dev/null) +} + +# Return the {major,minor,tail} part of version. Assume version has the form: +# major.minor.tail +# The || true handles missing/ill-formed argument cases. + +version_major () +{ + expr "${1}" \: '\([^.]\+\)' 2>/dev/null || true +} + +version_minor () +{ + expr "${1}" \: '[^.]\+\.\([^.]\+\)' 2>/dev/null || true +} + +version_tail () +{ + expr "${1}" \: '[^.]\+\.[^.]\+\.\([^.]\+\)' 2>/dev/null || true +} + +# Display and record to syslog (if logger is available) an error message. +# +install_msg () +{ + local package=${1} + local priority=${2} + + # Remove package and priority from ARGV; then join all args to message. + + shift; shift + + local message="${package}:" + local arg + + for arg; do + message="${message} ${arg}" + done + + # Output to stanard error and to syslog, if logger is available. + + >&2 echo "${message}" + if is_exec logger; then + logger -p syslog.${priority} -t "${package}" -- "${message}" || true + fi +} + diff --git a/debian/source/format b/debian/source/format new file mode 100644 index 0000000..89ae9db --- /dev/null +++ b/debian/source/format @@ -0,0 +1 @@ +3.0 (native) diff --git a/debian/stamp-makefile-check b/debian/stamp-makefile-check new file mode 100644 index 0000000..e69de29 -- cgit v1.2.3