Package: menu Version: 2.1.46 Severity: minor Tags: patch Hi Bill,
I just realised that /usr/share/menu/README was not updated when menu started to use dpkg triggers. Here is a patch that removes mention of postinst in this file, and in other documentations as well. Have a nice Sunday, -- Charles Plessy Tsurumi, Kanagawa, Japan
diff --git a/doc/README.package-menus b/doc/README.package-menus index 9c78b5c..e3a5bf3 100644 --- a/doc/README.package-menus +++ b/doc/README.package-menus @@ -15,10 +15,5 @@ and may contain as many lines (menu entries) as is necessary. For examples, please look in /usr/share/menu/default - -Also, in your postinst you should check for the availability of -the update-menus command, and if available, execute it (no -parameters needed). - For more info, please read /usr/share/doc/menu/html diff --git a/doc/README.pre1 b/doc/README.pre1 index 20c2e32..6cdd583 100644 --- a/doc/README.pre1 +++ b/doc/README.pre1 @@ -85,9 +85,6 @@ package should not have any menu-entries listed. entries should be listed (otherwise, emacs will also be run in an xterm). --In your postinst and postrm script, add a line like: - if test -x /usr/bin/update-menus; then update-menus; fi - -Do not make your package depend on the menu package. ************************ diff --git a/doc/menu.sgml b/doc/menu.sgml index bf189be..7dd07b7 100644 --- a/doc/menu.sgml +++ b/doc/menu.sgml @@ -143,11 +143,11 @@ are finished by a ';' instead of a newline). Basically, users don't need to know any of how and when the startup files are created, but they might be interested to know anyway. <p> -When a package that wants to add something to the menu tree gets -installed, it will run <prgn/update-menus/ in its <file/postinst/ script. -Update-menus then reads in all menu files in <file>/etc/menu/</file>, -<file>/usr/lib/menu</file>, <file>/usr/share/menu</file> and -<file>/usr/share/menu/default</file>, and stores the menu entries of all +When a package that wants to add something to the menu tree installs +a menu entry in <file>/usr/lib/menu</file> or <file>/usr/share/menu</file>, +<prgn>dpkg</prgn> runs the <prgn>update-menus<prgn> command via the +<em>dpkg triggers</em> mechanism. +Update-menus then reads in all menu files, and stores the menu entries of all installed packages in memory. Once that has been done, it will run the menu-methods in <file>/etc/menu-methods/*</file>, and pipe the information about the menu @@ -801,17 +801,6 @@ A package should provide a menu file <file>/usr/share/menu/<package-name></file> that contains information about each program it likes to make available in the menus. -<p> -<sect> Adding a hook for dpkg in your packages -<p> -The <tt/postinst/ script and the <file/postrm/ script of the package -should include the line -<example> - if test -x /usr/bin/update-menus; then update-menus; fi -</example> -If you are using <prgn/debhelper/, the program <prgn/dh_installmenu/ -can do it for you. -<p> <chapt>What packages with menu managers should do <p>
