From fd160606fdf7e316d6ad776f0d00909fc1514593 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Fri, 21 Sep 2018 20:56:24 -0300 Subject: Revert "dh_elpa.in: add new section "A word on info pages..."" This reverts commit cb044808c708f3359542dec387dc44baa42fb220. Make the package buildable again. --- dh_elpa.in | 42 ------------------------------------------ 1 file changed, 42 deletions(-) diff --git a/dh_elpa.in b/dh_elpa.in index 6584ab5..df0cbe7 100755 --- a/dh_elpa.in +++ b/dh_elpa.in @@ -475,46 +475,4 @@ the package autoloads file. Changing the behaviour of the package (as opposed to making it work) should in most cases happen in upstreamed patches. -=head2 A word on info pages in dh_elpa packages - -While info pages can be installed to the main INFOPATH in -/usr/share/info using B, this is not recommended. If -the addon is also bundled with Emacs this method will, at times, -conflict with the file path of a page provided by GNU Emacs. -Conflicts are primarily with the B package. -More importantly, installing files outside of the B-managed -directory /usr/share/emacs/site-lisp/elpa-src/package-version violates -the ELPA package specification. This specification requires that the -contents of an ELPA package are contained within a single directory, -and that this directory is named package-version; subdirectories -within package-version are permitted I<[1]>. - -Thus, the following method is recommended: Add the path of -C, relative to source-package-dir to -debian/[S>]elpa. Emacs' info viewer is able to find info -pages installed in this way because C updates -C to include each addon I<[2]>. At present the -only downside is that these info pages will be inaccessible using the -standalone B viewer, eg: bugs such as I<#725408> "org-mode 8 -info does not show up in info index". - -This issue can be fixed upstream in the standalone B viewer if -the ability to parse installed ELPA packages is added to B. -Alternatively, this issue can be resolved by customising C -I<[2]>. eg: B could hypothetically be extended using a -method similar to C for each -elpa-package that installs an info page. GNU Emacs info-mode and the -standalone B viewer would then use C to resolve the -correct location of an info page. - -= item References: - -[1] For more information see section "Multi-file Packages" in the GNU -Emacs Lisp Reference Manual, available online or from the non-free -package emacs-common-non-dfsg C. - -[2] For more information see section "Other Info Directories" in the -GNU Texinfo Manual, available online or from the non-free package -texinfo-doc-nonfree C. - =back -- cgit v1.2.3