apt-dpkg-ref-5.3.1+nmu1/0000755000000000000000000000000011554033226011544 5ustar apt-dpkg-ref-5.3.1+nmu1/make-docs0000755000000000000000000000110211551203110013313 0ustar #!/bin/sh CLISP_BIN=$(which clisp) LISP_BIN=$(which cmucl) if [ -n "$CLISP_BIN" ]; then $CLISP_BIN apt-dpkg-ref.lisp elif [ -n "$LISP_BIN" ]; then $LISP_BIN -load apt-dpkg-ref.lisp else echo "You need a lisp-compiler installed!" exit 1; fi LATEX_BIN=$(which latex) PDFLATEX_BIN=$(which pdflatex) DVIPS_BIN=$(which dvips) if [ -n "$LATEX_BIN" -a -n "$PDFLATEX_BIN" -a -n "$DVIPS_BIN" ]; then latex apt-dpkg-ref.tex pdflatex apt-dpkg-ref.tex dvips apt-dpkg-ref.dvi -o else echo "You need a LaTeX distribution installed! Need latex, pdflatex, and dvips." exit 1; fi apt-dpkg-ref-5.3.1+nmu1/apt-dpkg-ref.lisp0000755000000000000000000003314111552024736014727 0ustar ;; Copyright 2001 Matthew Danish ;; Under the terms of the GNU General Public License version 2 ;; http://www.gnu.org/ (defun interleave (token seq) (cond ((<= (length seq) 1) seq) (t (cons (car seq) (mapcan (lambda (x) (list token x)) (cdr seq)))))) ;; It's ugly, but it does its job. :) (defmacro reference-guide-latex (stream title author &rest body) (labels ((escape-string (str) (let ((len (length str))) (with-output-to-string (stream) (do ((i 0 (1+ i))) ((>= i len) t) (cond ((and (char= (aref str i) #\-) (< i (- len 1)) (char= (aref str (+ i 1)) #\-)) (princ "-\\/" stream)) ((or (char= (aref str i) #\{) (char= (aref str i) #\}) (char= (aref str i) #\#) (char= (aref str i) #\$) (char= (aref str i) #\%) (char= (aref str i) #\&) (char= (aref str i) #\~) (char= (aref str i) #\_) (char= (aref str i) #\^)) (princ "\\" stream) (princ (aref str i) stream)) ((char= (aref str i) #\\) (princ "$\\backslash$" stream)) (t (princ (aref str i) stream))))))) (escape-control-chars (l) (typecase l (string (escape-string l)) (list (mapcar #'escape-control-chars l)) (t l)))) `(progn (format ,stream "\\documentclass[twocolumn]{article} \\usepackage[T1]{fontenc} \\usepackage[latin1]{inputenc} \\usepackage{fancyhdr} \\pagestyle{fancy} \\makeatletter \\renewcommand{\\section}{\\@startsection{section}{1}{0pt}{2\\baselineskip}% {\\baselineskip}{\\large\\sffamily\\centering}} \\makeatother \\setcounter{secnumdepth}{0} \\catcode`<=13 \\def<#1>{$\\langle${\\itshape #1}$\\rangle$} \\lhead{~A} \\rhead{\\textsc{~A}} \\begin{document}~% " ,title ,author) ,@(mapcar (lambda (heading) `(progn (format ,stream "\\section{~A}~%~%" ,(cadar heading)) ,@(mapcar (lambda (command) `(progn (format ,stream "\\paragraph{~A}~%~%" ,(apply #'concatenate 'string (interleave " \\\\ " (escape-control-chars (cdar command))))) ,@(mapcar (lambda (l) (let ((line (escape-control-chars l))) (typecase line (string `(format ,stream "~A" ,line)) (list (case (car line) ((:program) `(format ,stream "\\texttt{~A}" ,(apply #'concatenate 'string (cdr line)))) ((:keyword) `(format ,stream "\\textit{~A}" ,(apply #'concatenate 'string (cdr line)))) ((:filename) `(format ,stream "\\textsf{~A}" ,(apply #'concatenate 'string (cdr line)))) ((:commands) `(format ,stream "~%\\begin{quote}~%~A~%\\end{quote}~%" ,(apply #'concatenate 'string (interleave " \\\\ " (cdr line)))))))))) (cdr command)) (format ,stream "~%~%"))) (cdr heading)) (format ,stream "~%~%"))) body) (format ,stream "\\end{document}~%")))) (defmacro reference-guide-html (stream title author &rest body) (labels ((escape-string (str) (with-output-to-string (stream) (do ((i 0 (1+ i))) ((>= i (length str)) t) (cond ((char= (aref str i) #\<) (princ "<" stream)) ((char= (aref str i) #\>) (princ ">" stream)) (t (princ (aref str i) stream)))))) (escape-control-chars (l) (typecase l (string (escape-string l)) (list (mapcar #'escape-control-chars l)) (t l)))) `(progn (format ,stream "~%~%~A~%~%

~A

~%
~%~A
~%~%" ,title ,title ,author) ,@(mapcar (lambda (heading) `(progn (format ,stream "

~A

~%" ,(cadar heading)) ,@(mapcar (lambda (command) `(progn (format ,stream "~A~%~%" ,(apply #'concatenate 'string (interleave "
" (escape-control-chars (cdar command))))) ,@(mapcar (lambda (l) (let ((line (escape-control-chars l))) (typecase line (string `(format ,stream "~A" ,line)) (list (case (car line) ((:program) `(format ,stream "~A" ,(apply #'concatenate 'string (cdr line)))) ((:keyword) `(format ,stream "~A" ,(apply #'concatenate 'string (cdr line)))) ((:filename) `(format ,stream "~A" ,(apply #'concatenate 'string (cdr line)))) ((:commands) `(format ,stream "~%

~A

~%" ,(apply #'concatenate 'string (interleave "
" (cdr line)))))))))) (cdr command)) (format ,stream "

~%~%"))) (cdr heading)) (format ,stream "~%~%"))) body) (format ,stream "~%~%")))) (defvar apt-dpkg-ref '("APT and Dpkg Quick Reference Sheet" "Matthew Danish" ((:heading "Common APT usage") ((:command "apt-get install ") "Downloads and all of its dependencies, and installs or upgrades them. This will also take a package off of " (:keyword "hold") " if it was put on. See below for more info on " (:keyword "hold.")) ((:command "apt-get remove [--purge] ") "Removes and any packages that depend on it. --purge specifies that packages should be " (:keyword "purged") ", see " (:program "dpkg -P") " for more information.") ((:command "apt-get update") "Updates packages listings from Debian mirrors, should be run at least once a day if you install anything that day, and every time after " (:filename "/etc/apt/sources.list") " is changed.") ((:command "apt-get upgrade [-u]") "Upgrades all packages installed to newest versions available. Will not install new or remove old packages. If a package changes dependencies and requires installation of a new package, it will not be upgraded, it will be put on " (:keyword "hold") " instead. " (:program "apt-get upgrade") " will not upgrade packages put on " (:keyword "hold") " (that is the meaning of " (:keyword "hold") "). See below for how to manually put packages on " (:keyword "hold") ". I suggest the `-u' option as well, because then you can see what packages are going to be upgraded.") ((:command "apt-get dist-upgrade [-u]") "Similar to " (:program "apt-get upgrade") ", except that " (:keyword "dist-upgrade") " will install or remove packages to satisfy dependencies.") ((:command "apt-cache search ") "Searches packages and descriptions for .") ((:command "apt-cache show ") "Shows the full description of .") ((:command "apt-cache showpkg ") "Shows a lot more detail about , and its relationships to other packages.") ((:command "synaptic" "gdebi" "gdebi-kde" "dselect" "aptitude" "gnome-apt") "Graphical front ends to " (:keyword "APT") " (some of these may be in their own package, that must be installed before use). While " (:program "dselect") " is arguably the most powerful, it's also the oldest and hardest to use.")) ((:heading "Common Dpkg usage") ((:command "dpkg -i ") "Installs a Debian package file; one that you downloaded manually, for example.") ((:command "dpkg -c ") "Lists the contents of , a .deb file.") ((:command "dpkg -I ") "Extracts package information from , a .deb file.") ((:command "dpkg -r ") "Removes an installed package named ") ((:command "dpkg -P ") "Purges an installed package named . The difference between " (:keyword "remove") " and " (:keyword "purge") " is that while " (:keyword "remove") " only deletes data and executables, " (:keyword "purge") " also deletes all configuration files in addition.") ((:command "dpkg -L ") "Gives a listing of all the files installed by . See also " (:program "dpkg -c") " for checking the contents of a .deb file.") ((:command "dpkg -s ") "Shows information on the installed package . See also " (:program "apt-cache show") " for viewing package information in the Debian archive and " (:program "dpkg -I") " for viewing package information extracted from a .deb file.") ((:command "dpkg-reconfigure ") "Reconfigures an installed package, if it uses " (:keyword "debconf") " (" (:keyword "debconf") " provides that consistent configuration interface for package installation). You can reconfigure " (:keyword "debconf") " itself if you want to change the front-end or priority of questions asked. For example, to reconfigure " (:keyword "debconf") " with the dialog front-end, you simply run: " (:commands "dpkg-reconfigure --frontend=dialog debconf")) ((:command "echo `` hold'' | dpkg --set-selections") "Put on " (:keyword "hold") " (command line method)") ((:command "dpkg --get-selections ``''") "Get the current status of (command line method)") ((:command "dpkg -S ") "Searches for in package database, telling you which installed packages have that file in them. To search for a file or list the contents of a package without installing it, you can use apt-file command line tool.")) ((:heading "Building Debian packages from Source") ((:command "apt-get source [-b] ") "Download the source Debian package for and extract it. You must have deb-src lines in your " (:filename "/etc/apt/sources.list") " for this to work. If you supply the `-b' option and you are currently root, then the package will be automatically built if possible.") ((:command "apt-get build-dep ") "Download and install the packages necessary to build the source Debian package . This feature is only present in " (:program "apt") " version 0.5 and up. Currently this means that woody and above contain this functionality. If you have an older version of " (:program "apt") " then the easiest way to find out the build dependencies is to look in the " (:filename "debian/control") " file in the source package directory. A common usage of this command is in conjunction with " (:program "apt-get source -b") ". For example (as root): " (:commands "apt-get build-dep " "apt-get source -b ") "Will download the source package, all of its build dependencies, and attempt to compile the source package.") ((:command "dpkg-source -x ") "If you have downloaded the source package for a program manually, which includes several files such as a .orig.tar.gz (or .tar.gz if it is Debian native), a .dsc, and a .diff.gz (if it is not Debian native), then you can unpack the source package using this command on the .dsc file.") ((:command "dpkg-buildpackage") "Builds a Debian package from a Debian source tree. You must be in the main directory of the source tree for this to work. Sample usage: " (:commands "dpkg-buildpackage -rfakeroot -uc -b") "Where `-rfakeroot' instructs it to use the " (:program "fakeroot") " program to simulate root privileges (for ownership purposes), `-uc' stands for ``Don't cryptographically sign the changelog'', and `-b' stands for ``Build the binary package only''") ((:command "debuild") "A handy wrapper script around " (:program "dpkg-buildpackage") " that will automatically take care of using " (:program "fakeroot") " or not, as well as running " (:program "lintian") " and " (:program "gpg") " for you. This script is provided by (:program "devscripts"), so you need to install this package first.")) ((:heading "Fixing dependencies") ((:command "dpkg --configure --pending") "If dpkg quits with an error while " (:program "apt-get install, upgrade, or dist-upgrade") "ing try running this to configure the packages that were already unpacked. Then try " (:program "apt-get install, upgrade, or dist-upgrade -f") ", and then try " (:program "apt-get install, upgrade, or dist-upgrade") " again. Repeat as needed. This usually resolves most dependency problems (also, if it mentions a specific package for some reason, you might want to try installing or removing that package)") ((:command "apt-get install -f" "apt-get upgrade -f" "apt-get dist-upgrade -f") "Attempt to fix dependencies while doing one of the above. Note that " (:program "apt-get install -f") " does not require a argument.")) ((:heading "See Also") ((:command "man ")"To learn more about this commands you can always consult their man pages, e.g. man apt-get, man dpkg. You can also find information about this and more tools, HOWTOs, manuals, etc at http://www.debian.org/doc/.")))) (defmacro output-document (stream type doc) (ecase type ((:latex) `(reference-guide-latex . (,stream . ,(symbol-value doc)))) ((:html) `(reference-guide-html . (,stream . ,(symbol-value doc)))))) (with-open-file (stream "apt-dpkg-ref.tex" :direction :output) (output-document stream :latex apt-dpkg-ref)) (with-open-file (stream "apt-dpkg-ref.html" :direction :output) (output-document stream :html apt-dpkg-ref)) (quit) apt-dpkg-ref-5.3.1+nmu1/clean-docs0000755000000000000000000000022307450550371013504 0ustar #!/bin/sh rm -f apt-dpkg-ref.html apt-dpkg-ref.tex apt-dpkg-ref.ps \ apt-dpkg-ref.pdf apt-dpkg-ref.dvi \ apt-dpkg-ref.aux apt-dpkg-ref.log .log apt-dpkg-ref-5.3.1+nmu1/debian/0000755000000000000000000000000012537025053012767 5ustar apt-dpkg-ref-5.3.1+nmu1/debian/control0000755000000000000000000000120412537024560014374 0ustar Source: apt-dpkg-ref Section: doc Priority: optional Maintainer: Vanessa Gutiérrez Build-Depends: debhelper (>= 7.0) Build-Depends-Indep: clisp | cmucl, texlive-base, texlive-latex-base, texlive-latex-recommended, texlive-fonts-recommended Standards-Version: 3.9.2.0 Package: apt-dpkg-ref Architecture: all Depends: ${misc:Depends} Description: APT, Dpkg Quick Reference sheet A quick lookup chart with various APT and dpkg options for handy reference, for those who haven't quite memorized the most commonly used commands. . This package will generate the documentation in different formats, such as HTML and PDF. apt-dpkg-ref-5.3.1+nmu1/debian/copyright0000755000000000000000000000040111554033570014721 0ustar Files: * Copyright: 2001-2002 Matthew Danish , 2011 Vanessa Gutierrez License: GPL-2 On Debian systems, the complete text of the GNU General Public License can be found in `/usr/share/common-licenses/GPL-2'. apt-dpkg-ref-5.3.1+nmu1/debian/changelog0000755000000000000000000000651312537025040014645 0ustar apt-dpkg-ref (5.3.1+nmu1) unstable; urgency=low [ Andreas Moog ] * Add Build-Dependency on texlive-fonts-recommended to fix FTBFS: Could not map source abbreviation for ecrm1000. (Closes: #737250, #738415, #759928) [ Axel Beckert ] * Non-maintainer upload. -- Axel Beckert Sat, 13 Jun 2015 15:03:28 +0200 apt-dpkg-ref (5.3.1) unstable; urgency=low * Added clarification on the use of dpkg and made reference to apt-file command line tool. (Closes: #304995) * Added a "See Also" section. (Closes: #304985) * Updated GUI references. (Closes: #304988) * Extended debuild-devscripts description (apt-dpkg-ref is a quick reference chart, not a starting guide). (Closes: #304987) * Added longer description for the package. * Switched copyright file format to machine readable. * Updated Standard-Versions to 3.9.2.0 (no changes needed). -- Vanessa Gutiérrez Sat, 09 Apr 2011 23:39:49 -0300 apt-dpkg-ref (5.3+nmu1) unstable; urgency=low * Non-maintainer upload. * More specific build-dep on lisp compilers: build only work with either clisp or cmucl. Update make-docs script accordingly. (Closes: #521900) Thanks to Peter De Wachter for the bug triage. -- Stefano Zacchiroli Wed, 23 Sep 2009 13:35:13 +0200 apt-dpkg-ref (5.3) unstable; urgency=low * Updated to the last version of Debian Policy (3.8.0) * Updated obsolete packages (tetex-bin, tetex-extra) from build-indep * Changed document section. (Closes: #153404) * Edited copyright file * Maintainer's email address changed -- Vanessa Gutiérrez Thu, 13 Nov 2008 22:23:13 -0430 apt-dpkg-ref (5.2) unstable; urgency=low * New maintainer. (Closes: #377918) * Removed command "console-apt" which no longer exists. (Closes: #304981) * Removed LaTex format from apt-dpkg-ref.doc-base, still generates .tex files * Added a debian/compat file * Moved debhelper's commands from build-arch target to build-indep -- Vanessa Gutierrez Wed, 26 Dec 2007 11:09:57 -0430 apt-dpkg-ref (5.1) unstable; urgency=low * Non-maintainer upload. * Rebuild to get rid of the /usr/doc symlink (closes: #153404). -- Amaya Rodrigo Sastre Sun, 18 Jun 2006 03:15:17 +0200 apt-dpkg-ref (5) unstable; urgency=low * Added Build-Dependency on tetex-extra (Closes: #140130) * Fixed typo in make-docs script -- Matthew Danish Thu, 28 Mar 2002 03:08:21 -0500 apt-dpkg-ref (4) unstable; urgency=low * Patch from Rafael Laboissiere: - Makes headings look nicer in LaTeX output - Uses better angle brackets in LaTeX output -- Matthew Danish Thu, 30 Aug 2001 09:21:06 -0400 apt-dpkg-ref (3) unstable; urgency=low * Fixed some grammar, changed -- to -\/- in LaTeX output. Thanks: J. Struckmeier -- Matthew Danish Thu, 23 Aug 2001 10:37:02 -0400 apt-dpkg-ref (2) unstable; urgency=low * Added "apt-get remove", "dpkg -r", "dpkg -P", and "dpkg --get-selections". * First upload (Closes: #106728) -- Matthew Danish Mon, 30 Jul 2001 01:49:43 -0400 apt-dpkg-ref (1) unstable; urgency=low * Initial Release. -- Matthew Danish Thu, 26 Jul 2001 22:52:09 -0400 Local variables: mode: debian-changelog End: apt-dpkg-ref-5.3.1+nmu1/debian/docs0000755000000000000000000000014707330154260013645 0ustar apt-dpkg-ref.ps apt-dpkg-ref.pdf apt-dpkg-ref.dvi apt-dpkg-ref.lisp apt-dpkg-ref.html apt-dpkg-ref.tex apt-dpkg-ref-5.3.1+nmu1/debian/compat0000755000000000000000000000000211551210531014160 0ustar 7 apt-dpkg-ref-5.3.1+nmu1/debian/rules0000755000000000000000000000242511554033652014054 0ustar #!/usr/bin/make -f # Sample debian/rules that uses debhelper. # GNU copyright 1997 to 1999 by Joey Hess. # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 # This is the debhelper compatability version to use. #export DH_COMPAT=4 configure: configure-stamp configure-stamp: dh_testdir # Add here commands to configure the package. touch configure-stamp build: configure-stamp build-stamp build-stamp: dh_testdir # Add here commands to compile the package. ./make-docs touch build-stamp clean: dh_testdir dh_testroot rm -f build-stamp configure-stamp # Add here commands to clean up after the build process. ./clean-docs dh_clean install: build dh_testdir dh_testroot dh_prep dh_installdirs # Build architecture-independent files here. binary-indep: build install dh_testdir dh_testroot # dh_installdebconf dh_installdocs dh_installexamples dh_installmenu dh_installcron dh_installman dh_installinfo dh_installchangelogs dh_link dh_strip dh_compress dh_fixperms dh_installdeb dh_shlibdeps dh_gencontrol dh_md5sums dh_builddeb # We have nothing to do by default. # Build architecture-dependent files here. binary-arch: build install binary: binary-indep binary-arch .PHONY: build clean binary-indep binary-arch binary install configure apt-dpkg-ref-5.3.1+nmu1/debian/apt-dpkg-ref.doc-base0000755000000000000000000000101111554033253016642 0ustar Document: apt-dpkg-ref Title: APT, Dpkg Quick Reference sheet Author: Matthew Danish Abstract: A quick look-up sheet containing the more commonly used APT and dpkg commands. Section: Debian Format: HTML Index: /usr/share/doc/apt-dpkg-ref/apt-dpkg-ref.html Files: /usr/share/doc/apt-dpkg-ref/apt-dpkg-ref.html Format: PostScript Files: /usr/share/doc/apt-dpkg-ref/apt-dpkg-ref.ps.gz Format: PDF Files: /usr/share/doc/apt-dpkg-ref/apt-dpkg-ref.pdf.gz Format: DVI Files: /usr/share/doc/apt-dpkg-ref/apt-dpkg-ref.dvi.gz