Merge from gnus--rel--5.10
[gnus] / etc / images / README
index a435456..b36e1e9 100644 (file)
@@ -1,94 +1,96 @@
-The following icons are from GNOME 2.6:
-
-    attach.xpm (stock_attach)
-    connect.xpm (stock_connect)
-    contact.xpm (stock_contact)
-    delete.xpm (stock_delete)
-    describe.xpm (stock_properties)
-    disconnect.xpm (stock_disconnect)
-    exit.xpm (stock_exit)
-    lock-broken.xpm (stock_lock_broken)
-    lock-ok.xpm (stock_lock_ok)
-    lock.xpm (stock_lock)
-    next-page.xpm (stock_next-page)
-    refresh.xpm (stock_refresh)
-    sort-ascending.xpm (stock_sort-ascending)
-    sort-column-ascending.xpm (stock_sort-column-ascending)
-    sort-criteria.xpm (stock_sort-criteria)
-    sort-descending.xpm (stock_sort-descending)
-    sort-row-ascending.xpm (stock_sort-row-ascending)
-
-    gnus/toggle-subscription.xpm (stock_task-recurring)
-
-    mail/compose.xpm (stock_mail-compose)
-    mail/copy.xpm (stock_mail-copy)
-    mail/forward.xpm (stock_mail-forward)
-    mail/inbox.xpm (stock_inbox)
-    mail/move.xpm (stock_mail-move)
-    mail/not-spam.xpm (stock_not-spam)
-    mail/outbox.xpm (stock_outbox)
-    mail/reply-all.xpm (stock_mail-reply-to-all)
-    mail/reply.xpm (stock_mail-reply)
-    mail/save-draft.xpm (stock_mail-handling)
-    mail/send.xpm (stock_mail-send)
-    mail/spam.xpm (stock_spam)
-
-
-The following icons were contributed by Adam Sjøgren <asjo@koldfront.dk>:
-
-    mail/preview.xpm (combining stock_mail and stock_zoom)
-    mail/save.xpm    (combining stock_mail, stock_save and stock_convert) 
-
-
-The folling icon are duplicated from Emacs 22.  They are either not present in
-Emacs 21 or look different there.
-
-    cancel.xpm
-    close.xpm
-    copy.xpm
-    cut.xpm
-    diropen.xpm
-    help.xpm
-    home.xpm
-    index.xpm
-    jump-to.xpm
-    left-arrow.xpm
-    new.xpm
-    next-node.xpm
-    open.xpm
-    paste.xpm
-    preferences.xpm
-    prev-node.xpm
-    print.xpm
-    redo.xpm
-    right-arrow.xpm
-    save.xpm
-    saveas.xpm
-    search.xpm
-    separator.xpm
-    spell.xpm
-
-You might want to use the following code to get Gnome icons in Emacs 21:
-
-  ;; Only for Emacs 21:
-  (when (and (not (featurep 'xemacs))
-          (not (boundp 'image-load-path))
-          tool-bar-mode)
-    (push "/path/to/etc/images/" image-load-path)
-    (setq tool-bar-map (make-sparse-keymap))
-    (clear-image-cache)
-    (tool-bar-setup))
-
-The GNOME's stock_*.png files were converted to XPM using the following GIMP
-script:
-
-;; -*- scheme -*-
-;; Put this file in ~/.gimp-*/scripts/
-;; gimp -i -b '(rs-save-as-xpm "foo.png" "foo.xpm" 127)'  '(gimp-quit 0)'
-(define (rs-save-as-xpm filename filename2 threshold)
-  (let* ((image (car (gimp-file-load RUN-NONINTERACTIVE filename filename)))
-        (drawable (car (gimp-image-get-active-layer image))))
-    (file-xpm-save RUN-NONINTERACTIVE image drawable
-                  filename2 filename2 threshold)
-    (gimp-image-delete image)))
-;; end
+* The default GTK icons were not overridden by the GNOME theme due to
+  a bug which was fixed in GNOME 2.15. Once GNOME 2.16 is in wide
+  circulation, the GTK icons should be replaced with the equivalent
+  GNOME icons.
+
+* Recipe for Creating PBM Versions
+
+1. Edit .xpm image in GIMP.
+2. Image > Mode > Indexed. Check Use Black/White Palette and No
+   Color Dithering.
+3. File > Save As file.xbm.
+4. Run xbmtopbm < file.xbm > file.pbm.
+
+Thanks to jan.h.d@swipnet.se for the help.
+
+
+COPYRIGHT AND LICENSE INFORMATION FOR IMAGE FILES
+
+* The following icons are a part of Emacs:
+
+File: mh-logo.xpm
+Author: Satyaki Das
+Copyright (C) 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
+License: GNU General Public License version 3 or later (see COPYING)
+
+The files splash.xpm, splash8.xpm contain copyright and license
+information, but it is reproduced here for convenience.
+
+Files: splash.pbm, splash.xpm, splash8.xpm, gnus.pbm
+  Author: Luis Fernandes <elf@ee.ryerson.ca>
+  Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007
+    Free Software Foundation, Inc.
+  License: GNU General Public License version 3 or later (see COPYING)
+
+
+* The following icons are from GTK+ 2.x and GNOME 2.x.  They are not
+part of Emacs, but distributed and used by Emacs.
+
+  Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007
+  Tuomas Kuosmanen, Rodney Dawes, Jakub Steiner, Alexander Larsson,
+  Tor Lillqvist, Garrett LeSage, Dennis Cranston, Jody Goldberg, Luca
+  Ferretti, Mark Finlay, Lapo Calamandrei, Andreas Nilsson and Marco
+  Pesenti Gritti
+  License: GNU General Public License version 2
+
+* From GTK+ 2.x:
+
+    close.xpm copy.xpm cut.xpm help.xpm home.xpm index.xpm info.pbm
+    info.xpm jump-to.xpm left-arrow.xpm new.xpm open.xpm paste.xpm
+    preferences.xpm print.xpm refresh.xpm right-arrow.xpm save.xpm
+    saveas.xpm search.xpm sort-ascending.xpm sort-descending.xpm
+    spell.xpm undo.xpm up-arrow.xpm
+
+    back-arrow.xpm and fwd-arrow.xpm are slightly modified undo and redo.
+    diropen.xpm is file-manager.png from Gnome hicolor theme.
+
+* From GNOME 2.x:
+
+  Emacs images and their source in the GNOME icons stock/ directory:
+
+    attach.xpm                document/stock_attach
+    cancel.xpm                slightly modified generic/stock_stop
+    connect.xpm               net/stock_connect
+    contact.xpm               net/stock_contact
+    data-save.xpm             data/stock_data-save
+    delete.xpm                generic/stock_delete
+    describe.xpm              generic/stock_properties
+    disconnect.xpm            net/stock_disconnect
+    exit.xpm                  generic/stock_exit
+    lock-broken.xpm           data/stock_lock-broken
+    lock-ok.xpm               data/stock_lock-ok
+    lock.xpm                  data/stock_lock
+    redo.xpm                  generic/stock_redo
+    search-replace.xpm        slightly modified generic/stock_search-and-replace
+    next-page.xpm             navigation/stock_next-page
+    refresh.xpm               generic/stock_refresh
+    separator.xpm             ?
+    show.xpm                  slightly modified document/stock_new
+    sort-ascending.xpm        slightly modified data/stock_sort-ascending
+    sort-column-ascending.xpm data/stock_sort-column-ascending
+    sort-criteria.xpm         data/stock_sort-criteria
+    sort-descending.xpm       slightly modified data/stock_sort-descending
+    sort-row-ascending.xpm    data/stock_sort-row-ascending
+    zoom-in.xpm               navigation/stock_zoom-in
+    zoom-out.xpm              navigation/stock_zoom-out
+
+    next-node.xpm and prev-node.xpm are from gthumb version 2.0 (part of
+    GNOME 2.x) where they are called next-image-24.png and prev-image-24.png.
+    up-node.xpm is just next-node.xpm rotated 90 degrees.
+
+    Some icons in the mail/ and gnus/ subdirectories are also taken
+    from this source (see their separate README files).
+
+The images in the low-color/ subdirectory are low-color versions of
+the files of the same name in this directory, and are subject to the
+same conditions.