Freedesktop.org’s icon naming specification, represented as XML. Intended as a convenience to XML devs.

icon-naming-spec.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--
    @source
        http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
    
    @author
        Zearin <zearin@gonk.net>
    
    @license
        I haven’t chosen a license yet.  In the meantime, feel free to reuse this
        code anywhere you like.  No attribution is required, although I’d 
        appreciate it! :)
--> 
<!--    
    This is an XML-based representation of the Icon Naming Specification from 
    freedesktop.org.
    
    It is intended as a convenience to XML enthusiasts to encourage the adoption 
    of the spec.  
    
    As a further convenience, I’ve used the typical prefix of “c” for elements; 
    this makes this ALMOST-conformant to the syntax as described in the 
    W3C XProc spec (http://www.w3.org/TR/xproc/#cv.directory).  
    
    The non-conformant aspect is the @description attribute, which I decided to 
    keep for human-readability.  If the attribute is a problem, it should be 
    trivial for XML devs to use an XPath expression like //@description to 
    delete them, after which everything should be hunky-dorie.  :) 
-->
<c:directory    name="icons">
    <c:directory    name="actions"
                    description="Icons which are generally used in menus and dialogs for interacting with the user.">
        <c:file name="address-book-new"
                description="The icon used for the action to create a new address book." />
        
        <c:file name="application-exit"
                description="The icon used for exiting an application. Typically this is seen in the application's menus as File->Quit." />
        
        <c:file name="appointment-new"
                description="The icon used for the action to create a new appointment in a calendaring application." />
        
        <c:file name="call-start"
                description="The icon used for initiating or accepting a call. Should be similar to the standard cellular call pickup icon, a green handset with ear and mouth pieces facing upward." />
        
        <c:file name="call-stop"
                description="The icon used for stopping a current call. Should be similar to the standard cellular call hangup icon, a red handset with ear and mouth pieces facing downward." />
        
        <c:file name="contact-new"
                description="The icon used for the action to create a new contact in an address book application." />
        
        <c:file name="document-new"
                description="The icon used for the action to create a new document." />
        
        <c:file name="document-open"
                description="The icon used for the action to open a document." />
        
        <c:file name="document-open-recent"
                description="The icon used for the action to open a document that was recently opened." />
        
        <c:file name="document-page-setup"
                description="The icon for the page setup action of a document editor." />
        
        <c:file name="document-print"
                description="The icon for the print action of an application." />
        
        <c:file name="document-print-preview"
                description="The icon for the print preview action of an application." />
        
        <c:file name="document-properties"
                description="The icon for the action to view the properties of a document in an application." />
        
        <c:file name="document-revert"
                description="The icon for the action of reverting to a previous version of a document." />
        
        <c:file name="document-save"
                description="The icon for the save action. Should be an arrow pointing down and toward a hard disk." />
        
        <c:file name="document-save-as"
                description="The icon for the save as action." />
        
        <c:file name="document-send"
                description="The icon for the send action. Should be an arrow pointing up and away from a hard disk." />
        
        <c:file name="edit-clear"
                description="The icon for the clear action." />
        
        <c:file name="edit-copy"
                description="The icon for the copy action." />
        
        <c:file name="edit-cut"
                description="The icon for the cut action." />
        
        <c:file name="edit-delete"
                description="The icon for the delete action." />
        
        <c:file name="edit-find"
                description="The icon for the find action." />
        
        <c:file name="edit-find-replace"
                description="The icon for the find and replace action." />
        
        <c:file name="edit-paste"
                description="The icon for the paste action." />
        
        <c:file name="edit-redo"
                description="The icon for the redo action." />
        
        <c:file name="edit-select-all"
                description="The icon for the select all action." />
        
        <c:file name="edit-undo"
                description="The icon for the undo action." />
        
        <c:file name="folder-new"
                description="The icon for creating a new folder." />
        
        <c:file name="format-indent-less"
                description="The icon for the decrease indent formatting action." />
        
        <c:file name="format-indent-more"
                description="The icon for the increase indent formatting action." />
        
        <c:file name="format-justify-center"
                description="The icon for the center justification formatting action." />
        
        <c:file name="format-justify-fill"
                description="The icon for the fill justification formatting action." />
        
        <c:file name="format-justify-left"
                description="The icon for the left justification formatting action." />
        
        <c:file name="format-justify-right"
                description="The icon for the right justification action." />
        
        <c:file name="format-text-direction-ltr"
                description="The icon for the left-to-right text formatting action." />
        
        <c:file name="format-text-direction-rtl"
                description="The icon for the right-to-left formatting action." />
        
        <c:file name="format-text-bold"
                description="The icon for the bold text formatting action." />
        
        <c:file name="format-text-italic"
                description="The icon for the italic text formatting action." />
        
        <c:file name="format-text-underline"
                description="The icon for the underlined text formatting action." />
        
        <c:file name="format-text-strikethrough"
                description="The icon for the strikethrough text formatting action." />
        
        <c:file name="go-bottom"
                description="The icon for the go to bottom of a list action." />
        
        <c:file name="go-down"
                description="The icon for the go down in a list action." />
        
        <c:file name="go-first"
                description="The icon for the go to the first item in a list action." />
        
        <c:file name="go-home"
                description="The icon for the go to home location action." />
        
        <c:file name="go-jump"
                description="The icon for the jump to action." />
        
        <c:file name="go-last"
                description="The icon for the go to the last item in a list action." />
        
        <c:file name="go-next"
                description="The icon for the go to the next item in a list action." />
        
        <c:file name="go-previous"
                description="The icon for the go to the previous item in a list action." />
        
        <c:file name="go-top"
                description="The icon for the go to the top of a list action." />
        
        <c:file name="go-up"
                description="The icon for the go up in a list action." />
        
        <c:file name="help-about"
                description="The icon for the About item in the Help menu." />
        
        <c:file name="help-contents"
                description="The icon for Contents item in the Help menu." />
        
        <c:file name="help-faq"
                description="The icon for the FAQ item in the Help menu." />
        
        <c:file name="insert-image"
                description="The icon for the insert image action of an application." />
        
        <c:file name="insert-link"
                description="The icon for the insert link action of an application." />
        
        <c:file name="insert-object"
                description="The icon for the insert object action of an application." />
        
        <c:file name="insert-text"
                description="The icon for the insert text action of an application." />
        
        <c:file name="list-add"
                description="The icon for the add to list action." />
        
        <c:file name="list-remove"
                description="The icon for the remove from list action." />
        
        <c:file name="mail-forward"
                description="The icon for the forward action of an electronic mail application." />
        
        <c:file name="mail-mark-important"
                description="The icon for the mark as important action of an electronic mail application." />
        
        <c:file name="mail-mark-junk"
                description="The icon for the mark as junk action of an electronic mail application." />
        
        <c:file name="mail-mark-notjunk"
                description="The icon for the mark as not junk action of an electronic mail application." />
        
        <c:file name="mail-mark-read"
                description="The icon for the mark as read action of an electronic mail application." />
        
        <c:file name="mail-mark-unread"
                description="The icon for the mark as unread action of an electronic mail application." />
        
        <c:file name="mail-message-new"
                description="The icon for the compose new mail action of an electronic mail application." />
        
        <c:file name="mail-reply-all"
                description="The icon for the reply to all action of an electronic mail application." />
        
        <c:file name="mail-reply-sender"
                description="The icon for the reply to sender action of an electronic mail application." />
        
        <c:file name="mail-send"
                description="The icon for the send action of an electronic mail application." />
        
        <c:file name="mail-send-receive"
                description="The icon for the send and receive action of an electronic mail application." />
        
        <c:file name="media-eject"
                description="The icon for the eject action of a media player or file manager." />
        
        <c:file name="media-playback-pause"
                description="The icon for the pause action of a media player." />
        
        <c:file name="media-playback-start"
                description="The icon for the start playback action of a media player." />
        
        <c:file name="media-playback-stop"
                description="The icon for the stop action of a media player." />
        
        <c:file name="media-record"
                description="The icon for the record action of a media application." />
        
        <c:file name="media-seek-backward"
                description="The icon for the seek backward action of a media player." />
        
        <c:file name="media-seek-forward"
                description="The icon for the seek forward action of a media player." />
        
        <c:file name="media-skip-backward"
                description="The icon for the skip backward action of a media player." />
        
        <c:file name="media-skip-forward"
                description="The icon for the skip forward action of a media player." />
        
        <c:file name="object-flip-horizontal"
                description="The icon for the action to flip an object horizontally." />
        
        <c:file name="object-flip-vertical"
                description="The icon for the action to flip an object vertically." />
        
        <c:file name="object-rotate-left"
                description="The icon for the rotate left action performed on an object." />
        
        <c:file name="object-rotate-right"
                description="The icon for the rotate rigt action performed on an object." />
        
        <c:file name="process-stop"
                description="The icon used for the “Stop” action in applications with actions that may take a while to process, such as web page loading in a browser." />
        
        <c:file name="system-lock-screen"
                description="The icon used for the “Lock Screen” item in the desktop’s panel application." />
        
        <c:file name="system-log-out"
                description="The icon used for the “Log Out” item in the desktop’s panel application." />
        
        <c:file name="system-run"
                description="The icon used for the “Run Application...” item in the desktop’s panel application." />
        
        <c:file name="system-search"
                description="The icon used for the “Search” item in the desktop’s panel application." />
        
        <c:file name="system-reboot"
                description="The icon used for the “Reboot” item in the desktop’s panel application." />
        
        <c:file name="system-shutdown"
                description="The icon used for the “Shutdown” item in the desktop’s panel application." />
        
        <c:file name="tools-check-spelling"
                description="The icon used for the “Check Spelling” item in the application's “Tools” menu." />
        
        <c:file name="view-fullscreen"
                description="The icon used for the “Fullscreen” item in the application's “View” menu." />
        
        <c:file name="view-refresh"
                description="The icon used for the “Refresh” item in the application's “View” menu." />
        
        <c:file name="view-restore"
                description="The icon used by an application for leaving the fullscreen view, and returning to a normal windowed view." />
        
        <c:file name="view-sort-ascending"
                description="The icon used for the “Sort Ascending” item in the application's “View” menu, or in a button for changing the sort method for a list." />
        
        <c:file name="view-sort-descending"
                description="The icon used for the “Sort Descending” item in the application's “View” menu, or in a button for changing the sort method for a list." />
        
        <c:file name="window-close"
                description="The icon used for the “Close Window” item in the application's “Windows” menu." />
        
        <c:file name="window-new"
                description="The icon used for the “New Window” item in the application's “Windows” menu." />
        
        <c:file name="zoom-fit-best"
                description="The icon used for the “Best Fit” item in the application's “View” menu." />
        
        <c:file name="zoom-in"
                description="The icon used for the “Zoom in” item in the application's “View” menu." />
        
        <c:file name="zoom-original"
                description="The icon used for the “Original Size” item in the application's “View” menu." />
        
        <c:file name="zoom-out"
                description="The icon used for the “Zoom Out” item in the application's “View” menu." />
    </c:directory>
    
    <c:directory    name="animations"
                    description="Animated images used to represent loading web sites, or other background processing which may be less suited to more verbose progress reporting in the user interface. Animations should be a PNG with frames which are the size of the directory the animation is in, tiled in a WxH grid. Implementations should determine the number of frames by dividing the image into its frames, and iterating from left to right, wrapping to the first frame, after rendering the last.">
        <c:file name="process-working"
                description="This is the standard spinner animation for web browsers and file managers to show that the location is loading." />
    </c:directory>
    
    <c:directory    name="apps" 
                    description="Icons that describe what an application is, for use in the Programs menu, window decorations, and the task list. These may or may not be generic depending on the application and its purpose. Applications which are to be considered part of the base desktop, such as the calculator or terminal, should use the generic icons specified in this specification, while more advanced applications such as web browsers and office applications should use branded icons which still give the user an idea of what function the application provides. ">
        <c:file name="accessories-calculator"
                description="The icon used for the desktop’s calculator accessory program." />
        
        <c:file name="accessories-character-map"
                description="The icon used for the desktop’s international and extended text character accessory program." />
        
        <c:file name="accessories-dictionary"
                description="The icon used for the desktop’s dictionary accessory program." />
        
        <c:file name="accessories-text-editor"
                description="The icon used for the desktop’s text editing accessory program." />
        
        <c:file name="help-browser"
                description="The icon used for the desktop’s help browsing application." />
        
        <c:file name="multimedia-volume-control"
                description="The icon used for the desktop’s hardware volume control application." />
        
        <c:file name="preferences-desktop-accessibility"
                description="The icon used for the desktop’s accessibility preferences." />
        
        <c:file name="preferences-desktop-font"
                description="The icon used for the desktop’s font preferences." />
        
        <c:file name="preferences-desktop-keyboard"
                description="The icon used for the desktop’s keyboard preferences." />
        
        <c:file name="preferences-desktop-locale"
                description="The icon used for the desktop’s locale preferences." />
        
        <c:file name="preferences-desktop-multimedia"
                description="The icon used for the desktop’s multimedia preferences." />
        
        <c:file name="preferences-desktop-screensaver"
                description="The icon used for the desktop’s screen saving preferences." />
        
        <c:file name="preferences-desktop-theme"
                description="The icon used for the desktop’s theme preferences." />
        
        <c:file name="preferences-desktop-wallpaper"
                description="The icon used for the desktop’s wallpaper preferences." />
        
        <c:file name="system-file-manager"
                description="The icon used for the desktop’s file management application." />
        
        <c:file name="system-software-install"
                description="The icon used for the desktop’s software installer application." />
        
        <c:file name="system-software-update"
                description="The icon used for the desktop’s software updating application." />
        
        <c:file name="utilities-system-monitor"
                description="The icon used for the desktop’s system resource monitor application." />
        
        <c:file name="utilities-terminal"
                description="The icon used for the desktop’s terminal emulation application." />
</c:directory>

    <c:directory    name="categories"
                    description="Icons that are used for categories in the Programs menu, or the Control Center, for separating applications, preferences, and settings for display to the user.">
        <c:file name="applications-accessories"
                description="The icon for the “Accessories” sub-menu of the Programs menu." />
        
        <c:file name="applications-development"
                description="The icon for the “Programming” sub-menu of the Programs menu." />
        
        <c:file name="applications-engineering"
                description="The icon for the “Engineering” sub-menu of the Programs menu." />
        
        <c:file name="applications-games"
                description="The icon for the “Games” sub-menu of the Programs menu." />
        
        <c:file name="applications-graphics"
                description="The icon for the “Graphics” sub-menu of the Programs menu." />
        
        <c:file name="applications-internet"
                description="The icon for the “Internet” sub-menu of the Programs menu." />
        
        <c:file name="applications-multimedia"
                description="The icon for the “Multimedia” sub-menu of the Programs menu." />
        
        <c:file name="applications-office"
                description="The icon for the “Office” sub-menu of the Programs menu." />
        
        <c:file name="applications-other"
                description="The icon for the “Other” sub-menu of the Programs menu." />
        
        <c:file name="applications-science"
                description="The icon for the “Science” sub-menu of the Programs menu." />
        
        <c:file name="applications-system"
                description="The icon for the “System Tools” sub-menu of the Programs menu." />
        
        <c:file name="applications-utilities"
                description="The icon for the “Utilities” sub-menu of the Programs menu." />
        
        <c:file name="preferences-desktop"
                description="The icon for the “Desktop Preferences” category." />
        
        <c:file name="preferences-desktop-peripherals"
                description="The icon for the “Peripherals” sub-category of the “Desktop Preferences” category." />
        
        <c:file name="preferences-desktop-personal"
                description="The icon for the “Personal” sub-category of the “Desktop Preferences” category." />
        
        <c:file name="preferences-other"
                description="The icon for the “Other” preferences category." />
        
        <c:file name="preferences-system"
                description="The icon for the “System Preferences” category." />
        
        <c:file name="preferences-system-network"
                description="The icon for the “Network” sub-category of the “System Preferences” category." />
        
        <c:file name="system-help"
                description="The icon for the “Help” system category." />
</c:directory>
    
    <c:directory    name="devices"
                    description="Icons for hardware that is contained within or connected to the computing device. Naming for extended devices in this group, is of the form &lt;primary function&gt;-&lt;manufacturer&gt;-&lt;model&gt;. This allows ease of fallback to the primary function device name, or ones more targeted for a specific series of models from a manufacturer. For example, a theme author may want to provide icons for different phones. The specific model icons could be named “phone-samsung-t809”, “phone-motorola-rokr”, and “phone-motorola-pebl”. However, the theme must provide a phone icon in the theme&apos;s style, so that devices not matching these models, will still have an appropriate icon. An exception to this rule is that the “media” icons do not need to include manufacturer names, as they are generic items, and may be available from many manufacturers. As a result, for media, the specific icons are to differentiate between different specific types of media. For exmaple, an artist may wish to provide icons for BluRay, DVD, HD-DVD, CD-ROM, and variations thereof. The specific media type icons should be named in the form, &lt;primary function&gt;-&lt;specific format&gt;. Some examples are “media-optical”, “media-optical-bd” and “media-optical-dvd”.">
        <c:file name="audio-card"
                description="The icon used for the audio rendering device." />
        
        <c:file name="audio-input-microphone"
                description="The icon used for the microphone audio input device." />
        
        <c:file name="battery"
                description="The icon used for the system battery device." />
        
        <c:file name="camera-photo"
                description="The icon used for a digital still camera devices." />
        
        <c:file name="camera-video"
                description="The fallback icon for video cameras." />
        
        <c:file name="camera-web"
                description="The fallback icon for web cameras." />
        
        <c:file name="computer"
                description="The icon used for the computing device as a whole." />
        
        <c:file name="drive-harddisk"
                description="The icon used for hard disk drives." />
        
        <c:file name="drive-optical"
                description="The icon used for optical media drives such as CD and DVD." />
        
        <c:file name="drive-removable-media"
                description="The icon used for removable media drives." />
        
        <c:file name="input-gaming"
                description="The icon used for the gaming input device." />
        
        <c:file name="input-keyboard"
                description="The icon used for the keyboard input device." />
        
        <c:file name="input-mouse"
                description="The icon used for the mousing input device." />
        
        <c:file name="input-tablet"
                description="The icon used for graphics tablet input devices." />
        
        <c:file name="media-flash"
                description="The fallback icon used for flash media, such as memory stick and SD." />
        
        <c:file name="media-floppy"
                description="The icon used for physical floppy disk media." />
        
        <c:file name="media-optical"
                description="The icon used for physical optical media such as CD and DVD." />
        
        <c:file name="media-tape"
                description="The icon used for generic physical tape media." />
        
        <c:file name="modem"
                description="The icon used for modem devices." />
        
        <c:file name="multimedia-player"
                description="The icon used for generic multimedia playing devices." />
        
        <c:file name="network-wired"
                description="The icon used for wired network connections." />
        
        <c:file name="network-wireless"
                description="The icon used for wireless network connections." />
        
        <c:file name="pda"
                description="This is the fallback icon for Personal Digial Assistant devices. Primary use of this icon is for PDA devices connected to the PC. Connection medium is not an important aspect of the icon. The metaphor for this fallback icon should be a generic PDA device icon." />
        
        <c:file name="phone"
                description="This is the default fallback for phone devices. Primary use of this icon group is for phone devices which support connectivity to the PC. These may be VoIP, cellular, or possibly landline phones. The metaphor for this fallback should be a generic mobile phone device." />
        
        <c:file name="printer"
                description="The icon used for a printer device." />
        
        <c:file name="scanner"
                description="The icon used for a scanner device." />
        
        <c:file name="video-display"
                description="The icon used for the monitor that video gets displayed to." />
    </c:directory>

    <c:directory    name="emblems"
                    description="Icons for tags and properties of files, that are displayed in the file manager. This context contains emblems for such things as “read-only” or “photos”.">
        <c:file name="emblem-default"
                description="The icon used as an emblem to specify the default selection of a printer for example." />
        
        <c:file name="emblem-documents"
                description="The icon used as an emblem for the directory where a user's documents are stored." />
        
        <c:file name="emblem-downloads"
                description="The icon used as an emblem for the directory where a user's downloads from the internet are stored." />
        
        <c:file name="emblem-favorite"
                description="The icon used as an emblem for files and directories that the user marks as favorites." />
        
        <c:file name="emblem-important"
                description="The icon used as an emblem for files and directories that are marked as important by the user." />
        
        <c:file name="emblem-mail"
                description="The icon used as an emblem to specify the directory where the user's electronic mail is stored." />
        
        <c:file name="emblem-photos"
                description="The icon used as an emblem to specify the directory where the user stores photographs." />
        
        <c:file name="emblem-readonly"
                description="The icon used as an emblem for files and directories which can not be written to by the user." />
        
        <c:file name="emblem-shared"
                description="The icon used as an emblem for files and directories that are shared to other users." />
        
        <c:file name="emblem-symbolic-link"
                description="The icon used as an emblem for files and direcotires that are links to other files or directories on the filesystem." />
        
        <c:file name="emblem-synchronized"
                description="The icon used as an emblem for files or directories that are configured to be synchronized to another device." />
        
        <c:file name="emblem-system"
                description="The icon used as an emblem for directories that contain system libraries, settings, and data." />
        
        <c:file name="emblem-unreadable"
                description="The icon used as an emblem for files and directories that are inaccessible." />            
    </c:directory>
    
    <c:directory    name="emotes"
                    description="Icons for emotions that are expressed through text chat applications such as :-) or :-P in IRC or instant messengers.">
        <c:file name="face-angel"
                description="The icon used for the 0:-) emote." />
        
        <c:file name="face-angry"
                description="The icon used for the X-( emote." />
        
        <c:file name="face-cool"
                description="The icon used for the B-) emote." />
        
        <c:file name="face-crying"
                description="The icon used for the :'( emote." />
        
        <c:file name="face-devilish"
                description="The icon used for the >:-) emote." />
        
        <c:file name="face-embarrassed"
                description="The icon used for the :-[ emote." />
        
        <c:file name="face-kiss"
                description="The icon used for the :-* emote." />
        
        <c:file name="face-laugh"
                description="The icon used for the :-)) emote." />
        
        <c:file name="face-monkey"
                description="The icon used for the :-(|) emote." />
        
        <c:file name="face-plain"
                description="The icon used for the :-| emote." />
        
        <c:file name="face-raspberry"
                description="The icon used for the :-P emote." />
        
        <c:file name="face-sad"
                description="The icon used for the :-( emote." />
        
        <c:file name="face-sick"
                description="The icon used for the :-& emote." />
        
        <c:file name="face-smile"
                description="The icon used for the :-) emote." />
        
        <c:file name="face-smile-big"
                description="The icon used for the :-D emote." />
        
        <c:file name="face-smirk"
                description="The icon used for the :-! emote." />
        
        <c:file name="face-surprise"
                description="The icon used for the :-0 emote." />
        
        <c:file name="face-tired"
                description="The icon used for the |-) emote." />
        
        <c:file name="face-uncertain"
                description="The icon used for the :-/ emote." />
        
        <c:file name="face-wink"
                description="The icon used for the ;-) emote." />
        
        <c:file name="face-worried"
                description="The icon used for the :-S emote." />
</c:directory>
    
    <c:directory    name="intl"
                    description="Icons for international denominations such as flags.">
        <c:file name="flag-aa"
                description="The flag for the country with the ISO 3166 country code AA. All flags should use ISO 3166 two-letter country codes, in lowercase form, as the specifier for the country." />
    </c:directory>
    
    <c:directory    name="mimetypes"
                    description="Icons for different types of data, such as audio or image files.">
        <c:file name="application-x-executable"
                description="The icon used for executable file types." />
        
        <c:file name="audio-x-generic"
                description="The icon used for generic audio file types." />
        
        <c:file name="font-x-generic"
                description="The icon used for generic font file types." />
        
        <c:file name="image-x-generic"
                description="The icon used for generic image file types." />
        
        <c:file name="package-x-generic"
                description="The icon used for generic package file types." />
        
        <c:file name="text-html"
                description="The icon used for HTML text file types." />
        
        <c:file name="text-x-generic"
                description="The icon used for generic text file types." />
        
        <c:file name="text-x-generic-template"
                description="The icon used for generic text templates." />
        
        <c:file name="text-x-script"
                description="The icon used for script file types, such as shell scripts." />
        
        <c:file name="video-x-generic"
                description="The icon used for generic video file types." />
        
        <c:file name="x-office-address-book"
                description="The icon used for generic address book file types." />
        
        <c:file name="x-office-calendar"
                description="The icon used for generic calendar file types." />
        
        <c:file name="x-office-document"
                description="The icon used for generic document and letter file types." />
        
        <c:file name="x-office-presentation"
                description="The icon used for generic presentation file types." />
        
        <c:file name="x-office-spreadsheet"
                description="The icon used for generic spreadsheet file types." />
    </c:directory>  
    
    <c:directory    name="places"
                    description="Icons used to represent locations, either on the local filesystem, or through remote connections. Folders, trash, and workgroups are some examples.">
        <c:file name="folder"
                description="The standard folder icon used to represent directories on local filesystems, mail folders, and other hierarchical groups." />
        
        <c:file name="folder-remote"
                description="The icon used for normal directories on a remote filesystem." />
        
        <c:file name="network-server"
                description="The icon used for individual host machines under the “Network Servers” place in the file manager." />
        
        <c:file name="network-workgroup"
                description="The icon for the “Network Servers” place in the desktop’s file manager, and workgroups within the network." />
        
        <c:file name="start-here"
                description="The icon used by the desktop’s main menu for accessing places, applications, and other features." />
        
        <c:file name="user-bookmarks"
                description="The icon for the user's special “Bookmarks” place." />
        
        <c:file name="user-desktop"
                description="The icon for the special “Desktop” directory of the user." />
        
        <c:file name="user-home"
                description="The icon for the special “Home” directory of the user." />
        
        <c:file name="user-trash"
                description="The icon for the user's “Trash” place in the desktop’s file manager." />
    </c:directory>
        
    <c:directory    name="status"
                    description="Icons for presenting status to the user. This context contains icons for warning and error dialogs, as well as for the current weather, appointment alarms, and battery status.">
        <c:file name="appointment-missed"
                description="The icon used when an appointment was missed." />
        
        <c:file name="appointment-soon"
                description="The icon used when an appointment will occur soon." />
        
        <c:file name="audio-volume-high"
                description="The icon used to indicate high audio volume." />
        
        <c:file name="audio-volume-low"
                description="The icon used to indicate low audio volume." />
        
        <c:file name="audio-volume-medium"
                description="The icon used to indicate medium audio volume." />
        
        <c:file name="audio-volume-muted"
                description="The icon used to indicate the muted state for audio playback." />
        
        <c:file name="battery-caution"
                description="The icon used when the battery is below 40%." />
        
        <c:file name="battery-low"
                description="The icon used when the battery is below 20%." />
        
        <c:file name="dialog-error"
                description="The icon used when a dialog is opened to explain an error condition to the user." />
        
        <c:file name="dialog-information"
                description="The icon used when a dialog is opened to give information to the user that may be pertinent to the requested action." />
        
        <c:file name="dialog-password"
                description="The icon used when a dialog requesting the authentication credentials for a user is opened." />
        
        <c:file name="dialog-question"
                description="The icon used when a dialog is opened to ask a simple question of the user." />
        
        <c:file name="dialog-warning"
                description="The icon used when a dialog is opened to warn the user of impending issues with the requested action." />
        
        <c:file name="folder-drag-accept"
                description="The icon used for a folder while an object is being dragged onto it, that is of a type that the directory can contain." />
        
        <c:file name="folder-open"
                description="The icon used for folders, while their contents are being displayed within the same window." />
        <!-- This icon would normally be shown in a tree or list view, next to the main view of a folder's contents.-->
        
        <c:file name="folder-visiting"
                description="The icon used for folders, while their contents are being displayed in another window." />
        <!-- This icon would typically be used when using multiple windows to navigate the hierarchy, such as in Nautilus's spatial mode.-->
        
        <c:file name="image-loading"
                description="The icon used when another image is being loaded, such as thumnails for larger images in the file manager." />
        
        <c:file name="image-missing"
                description="The icon used when another image could not be loaded." />
        
        <c:file name="mail-attachment"
                description="The icon used for an electronic mail that contains attachments." />
        
        <c:file name="mail-unread"
                description="The icon used for an electronic mail that is unread." />
        
        <c:file name="mail-read"
                description="The icon used for an electronic mail that is read." />
        
        <c:file name="mail-replied"
                description="The icon used for an electronic mail that has been replied to." />
        
        <c:file name="mail-signed"
                description="The icon used for an electronic mail that contains a signature." />
        
        <c:file name="mail-signed-verified"
                description="The icon used for an electronic mail that contains a signature which has also been verified by the security system." />
        
        <c:file name="media-playlist-repeat"
                description="The icon for the repeat mode of a media player." />
        
        <c:file name="media-playlist-shuffle"
                description="The icon for the shuffle mode of a media player." />
        
        <c:file name="network-error"
                description="The icon used when an error occurs trying to intialize the network connection of the computing device." />
        <!-- This icon should be two computers, one in the background, with the screens of both computers, colored black, and with the theme's style element for errors, overlayed on top of the icon.-->
        
        <c:file name="network-idle"
                description="The icon used when no data is being transmitted or received, while the computing device is connected to a network." />
        <!-- This icon should be two computers, one in the background, with the screens of both computers, colored black.-->
        
        <c:file name="network-offline"
                description="The icon used when the computing device is disconnected from the network." />
        <!-- This icon should be a computer in the background, with a screen colored black, and the theme's icon element to show that a device is not accessible, in the foreground.-->
        
        <c:file name="network-receive"
                description="The icon used when data is being received, while the computing device is connected to a network." />
        <!-- This icon should be two computers, one in the background, with its screen colored green, and the screen of the computer in the foreground, colored black.-->
        
        <c:file name="network-transmit"
                description="The icon used when data is being transmitted, while the computing device is connected to a network." />
        <!-- This icon should be two computers, one in the background, with its screen colored black, and the screen of the computer in the foreground, colored green.-->
        
        <c:file name="network-transmit-receive"
                description="The icon used data is being both transmitted and received simultaneously, while the computing device is connected to a network." />
        <!-- This icon should be two computers, one in the background, with the screens of both computers, colored green.-->
        
        <c:file name="printer-error"
                description="The icon used when an error occurs while attempting to print." />
        <!-- This icon should be the theme's printer device icon, with the theme's style element for errors, overlayed on top of the icon.-->
        
        <c:file name="printer-printing"
                description="The icon used while a print job is successfully being spooled to a printing device." />
        <!-- This icon should be the theme's printer device icon, with a document emerging from the printing device.-->
        
        <c:file name="security-high"
                description="The icon used to indicate that the security level of a connection is known to be secure, using strong encryption and a valid certificate." />
        
        <c:file name="security-medium"
                description="The icon used to indicate that the security level of a connection is presumed to be secure, using strong encryption, and a certificate that could not be automatically verified, but which the user has chosen to trust." />
        
        <c:file name="security-low"
                description="The icon used to indicate that the security level of a connection is presumed to be insecure, either by using weak encryption, or by using a certificate that the could not be automatically verified, and which the user has not chosent to trust." />
        
        <c:file name="software-update-available"
                description="The icon used when an update is available for software installed on the computing device, through the system software update program." />
        
        <c:file name="software-update-urgent"
                description="The icon used when an urgent update is available through the system software update program." />
        
        <c:file name="sync-error"
                description="The icon used when an error occurs while attempting to synchronize data from the computing device, to another device." />
        
        <c:file name="sync-synchronizing"
                description="The icon used while data is successfully synchronizing to another device." />
        
        <c:file name="task-due"
                description="The icon used when a task is due soon." />
        
        <c:file name="task-past-due"
                description="The icon used when a task that was due, has been left incomplete." />
        
        <c:file name="user-available"
                description="The icon used when a user on a chat network is available to initiate a conversation with." />
        
        <c:file name="user-away"
                description="The icon used when a user on a chat network is away from their keyboard and the chat program." />
        
        <c:file name="user-idle"
                description="The icon used when a user on a chat network has not been an active participant in any chats on the network, for an extended period of time." />
        
        <c:file name="user-offline"
                description="The icon used when a user on a chat network is not available." />
        
        <c:file name="user-trash-full"
                description="The icon for the user's “Trash” in the desktop’s file manager, when there are items in the “Trash” waiting for disposal or recovery." />
        
        <c:file name="weather-clear"
                description="The icon used while the weather for a region is “clear skies”." />
        
        <c:file name="weather-clear-night"
                description="The icon used while the weather for a region is “clear skies” during the night." />
        
        <c:file name="weather-few-clouds"
                description="The icon used while the weather for a region is “partly cloudy”." />
        
        <c:file name="weather-few-clouds-night"
                description="The icon used while the weather for a region is “partly cloudy” during the night." />
        
        <c:file name="weather-fog"
                description="The icon used while the weather for a region is “foggy”." />
        
        <c:file name="weather-overcast"
                description="The icon used while the weather for a region is “overcast”." />
        
        <c:file name="weather-severe-alert"
                description="The icon used while a sever weather alert is in effect for a region." />
        
        <c:file name="weather-showers"
                description="The icon used while rain showers are occurring in a region." />
        
        <c:file name="weather-showers-scattered"
                description="The icon used while scattered rain showers are occurring in a region." />
        
        <c:file name="weather-snow"
                description="The icon used while snow showers are occurring in a region." />
        
        <c:file name="weather-storm"
                description="The icon used while storms are occurring in a region." />
    </c:directory>
</c:directory>