X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=4855506e6105556bc6db756e712ed4f849dcbc68;hb=3c725b9d2af39ac3a7e24b7d9eb374a48c5b6893;hp=1743552e0f16e5d104fc99c8b7ed6221b9b9dee4;hpb=f545dfd88c291812520adee2147723a47e16f220;p=debian%2Fdebian-policy.git diff --git a/policy.sgml b/policy.sgml index 1743552..4855506 100644 --- a/policy.sgml +++ b/policy.sgml @@ -2367,8 +2367,7 @@ endif This is an optional, recommended configuration file for the uscan utility which defines how to automatically scan ftp or http sites for newly available updates of the - package. This is used - by and other Debian QA + package. This is used Debian QA tools to help with quality control and maintenance of the distribution as a whole.

@@ -3674,7 +3673,7 @@ Files:

The special value byhand for the section in a .changes file indicates that the file in question - is not an ordinary package file and must by installed by + is not an ordinary package file and must be installed by hand by the distribution maintainers. If the section is byhand the priority should be -.

@@ -6918,6 +6917,20 @@ Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) exceptions to the FHS apply: + +

+ The FHS requirement that architecture-independent + application-specific static files be located in + /usr/share is relaxed to a suggestion. + + In particular, a subdirectory of /usr/lib may + be used by a package (or a collection of packages) to hold a + mixture of architecture-independent and + architecture-dependent files. However, when a directory is + entirely composed of architecture-independent files, it + should be located in /usr/share. +

+

The optional rules related to user specific @@ -6963,6 +6976,17 @@ Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) multiarch.

+

+ The requirement for C and C++ headers files to be + accessible through the search path + /usr/include/ is amended, permitting files to + be accessible through the search path + /usr/include/triplet where + triplet is as above. + This is necessary for architecture-dependant headers + file to coexist in a multiarch setup. + +

Applications may also use a single subdirectory under /usr/lib/triplet. @@ -7029,6 +7053,16 @@ Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) kernel information.

+ +

+ The requirement for /usr/local/lib<qual> + to exist if /lib<qual> or + /usr/lib<qual> exists (where + lib<qual> is a variant of + lib such as lib32 or + lib64) is removed. +

+

On GNU/Hurd systems, the following additional @@ -8054,75 +8088,38 @@ Reloading description configuration...done. Menus

- Packages shipping applications that comply with minimal requirements - described below for integration with desktop environments should - register these applications in the desktop menu, following the - FreeDesktop standard, using text files called - desktop entries. Their format is described in the - Desktop Entry Specification at - - and complementary information can be found in the - Desktop Menu Specification at - . + The Debian menu package provides a standard + interface between packages providing applications and + menu programs (either X window managers or + text-based menu programs such as pdmenu).

- The desktop entry files are installed by the packages in the - directory /usr/share/applications and the FreeDesktop - menus are refreshed using dpkg triggers. It is therefore - not necessary to depend on packages providing FreeDesktop menu - systems. + All packages that provide applications that need not be + passed any special command line arguments for normal + operation should register a menu entry for those + applications, so that users of the menu package + will automatically get menu entries in their window + managers, as well in shells like pdmenu.

- Entries displayed in the FreeDesktop menu should conform to the - following minima for relevance and visual integration. - - - - Unless hidden by default, the desktop entry must point to a PNG - or SVG icon with a transparent background, providing at least - the 22×22 size, and preferably up to 64×64. The icon - should be neutral enough to integrate well with the default icon - themes. It is encouraged to ship the icon in the default - hicolor icon theme directories, or to use an existing - icon from the hicolor theme. - - - - If the menu entry is not useful in the general case as a - standalone application, the desktop entry should set the - NoDisplay key to true, so that it can be - configured to be displayed only by those who need it. - - - - In doubt, the package maintainer should coordinate with the - maintainers of menu implementations through the - debian-desktop mailing list in order to avoid problems - with categories or bad interactions with other icons. Especially - for packages which are part of installation tasks, the contents - of the NotShowIn/OnlyShowIn keys should be - validated by the maintainers of the relevant environments. - - + Menu entries should follow the current menu policy.

- Since the FreeDesktop menu is a cross-distribution standard, the - desktop entries written for Debian should be forwarded upstream, - where they will benefit to other users and are more likely to - receive extra contributions such as translations. + The menu policy can be found in the menu-policy + files in the debian-policy package. + It is also available from the Debian web mirrors at + .

-

- Packages can, to be compatible with Debian additions to some window - managers that do not support the FreeDesktop standard, also provide a - Debian menu file, following the Debian menu policy, - which can be found in the menu-policy files in the - debian-policy package. It is also available from the Debian - web mirrors at . +

+ Please also refer to the Debian Menu System + documentation that comes with the menu + package for information about how to register your + applications.

@@ -8130,109 +8127,42 @@ Reloading description configuration...done. Multimedia handlers

- Media types (formerly known as MIME types, Multipurpose Internet Mail - Extensions, RFCs 2045-2049) is a mechanism for encoding files and - data streams and providing meta-information about them, in particular - their type and format (e.g. image/png, text/html, - audio/ogg). + MIME (Multipurpose Internet Mail Extensions, RFCs 2045-2049) + is a mechanism for encoding files and data streams and + providing meta-information about them, in particular their + type (e.g. audio or video) and format (e.g. PNG, HTML, + MP3).

- Registration of media type handlers allows programs like mail + Registration of MIME type handlers allows programs like mail user agents and web browsers to invoke these handlers to - view, edit or display media types they don't support directly. + view, edit or display MIME types they don't support directly.

- There are two overlapping systems to associate media types to programs - which can handle them. The mailcap system is found on a - large number of Unix systems. The FreeDesktop system is - aimed at Desktop environments. In Debian, FreeDesktop entries are - automatically translated in mailcap entries, therefore packages - already using desktop entries should not use the mailcap system - directly. + Packages which provide programs to view/show/play, compose, edit or + print MIME types should register them as such by placing a file in + format (RFC 1524) in the directory + /usr/lib/mime/packages/. The file name should be the + binary package's name.

- - Registration of media type handlers with desktop entries - -

- Packages shipping an application able to view, edit or point to - files of a given media type, or open links with a given URI scheme, - should list it in the MimeType key of the application's - desktop entry. For URI schemes, - the relevant MIME types are x-scheme-handler/* (e.g. - x-scheme-handler/https). -

- - - - Registration of media type handlers with mailcap entries - -

- Packages that are not using desktop entries for registration should - install a file in format (RFC - 1524) in the directory /usr/lib/mime/packages/. The - file name should be the binary package's name. -

- -

- The mime-support package provides the - update-mime program, which integrates these - registrations in the /etc/mailcap file, using dpkg - triggers - Creating, modifying or removing a file in - /usr/lib/mime/packages/ using maintainer scripts will - not activate the trigger. In that case, it can be done by calling - dpkg-trigger --no-await /usr/lib/mime/packages from - the maintainer script after creating, modifying, or removing - the file. - . - -

- Packages installing desktop entries should not install mailcap - entries for the same program, because the - mime-support package already reads desktop - entries. -

- -

- Packages using these facilities should not depend on, - recommend, or suggest mime-support. -

- - - - Providing media types to files - -

- The media type of a file is discovered by inspecting the file's - extension or its pattern, and - interrogating a database associating them with media types. -

- -

- To support new associations between media types and files, their - characteristic file extensions and magic patterns should be - registered to the IANA (Internet Assigned Numbers Authority). See - and RFC 6838 - for details. This information will then propagate to the systems - discovering file media types in Debian, provided by the - shared-mime-info, - mime-support and file - packages. If registration and propagation can not be waited for, - support can be asked to the maintainers of the packages mentioned - above. -

- -

- For files that are produced and read by a single application, it - is also possible to declare this association to the - Shared MIME Info system by installing in the directory - /usr/share/mime/packages a file in the XML format - specified at . -

- +

+ The mime-support package provides the + update-mime program, which integrates these + registrations in the /etc/mailcap file, using dpkg + triggers + Creating, modifying or removing a file in + /usr/lib/mime/packages/ using maintainer scripts will + not activate the trigger. In that case, it can be done by calling + dpkg-trigger --no-await /usr/lib/mime/packages from + the maintainer script after creating, modifying, or removing + the file. + . + Packages using this facility should not depend on, + recommend, or suggest mime-support. +

@@ -8536,7 +8466,17 @@ fi renamed. If a consensus cannot be reached, both programs must be renamed.

- +

+ Binary executables must not be statically linked with the GNU C + library, since this prevents the binary from benefiting from + fixes and improvements to the C library without being rebuilt + and complicates security updates. This requirement may be + relaxed for binary executables whose intended purpose is to + diagnose and fix the system in situations where the GNU C + library may not be usable (such as system recovery shells or + utilities like ldconfig) or for binary executables where the + security benefits of static linking outweigh the drawbacks. +

By default, when a package is being built, any binaries created should include debugging information, as well as @@ -9802,15 +9742,16 @@ done Cgi-bin executable files are installed in the directory -/usr/lib/cgi-bin/cgi-bin-name +/usr/lib/cgi-bin + + or a subdirectory of that directory, and the script + +/usr/lib/cgi-bin/.../cgi-bin-name - or a subdirectory of that directory, and should be - referred to as + should be referred to as -http://localhost/cgi-bin/cgi-bin-name +http://localhost/cgi-bin/.../cgi-bin-name - (possibly with a subdirectory name - before cgi-bin-name).