Update READMEs for the icons directory.

(bzr r7845)

3 files changed, 55 insertions, 39 deletions

diff --git a/share/icons/README b/share/icons/README
index 530dc3bef..9b79b73ea 100644
--- a/share/icons/README
+++ b/share/icons/README
@@ -1,10 +1,58 @@
-Jan 18, 2008
-ticotico.jpg is (C)2008 Dario Sanches licensed under Creative Commons by-sa 3.0
+========================
+= INKSCAPE ICON THEMES =
+========================
+
+Starting with 0.47, Inkscape supports icon theming using the XDG Icon Theme
+Specification [1]. It is implemented according to the Themable App Specific
+Icons document [2]. Everything that's needed to replace Inkscape's icons
+is to put appropriately named icons in your desktop environment's icon theme.
+A list of the names is available at [3].
+
+The monolithic icons.svg file is deprecated and should not be used to add new
+icons. Support for it will probably be removed in the next release (0.48).
+
+== User notes ==
+
+To get back the old icons on Linux, do the following:
+1. Create the directory ~/.icons/OldInkscape
+2. Copy the contents of the hicolor directory there
+3. Edit the index.theme file; Replace "Name=hicolor" with "Name=OldInkscape",
+   and in a new line add "Inherits=YourTheme" where YourTheme is the
+   icon theme you're currently using, e.g. Human, gnome, etc.
+4. Choose the OldInkscape theme from your desktop's appearance preferences.
+
+To use the Tango icons on Windows, go to INKDIR/share/icons, where INKDIR is
+Inkscape's installation directory. Rename "hicolor" to "old", and then rename
+"tango" to "hicolor".
 
-Wed Jan 19, 2005
+== Developer notes ==
 
-All XPM and PNG icons have been replaced by SVG icons in icons.svg
+The enabling bit of theming on Windows, which isn't mentioned in GTK docs,
+is the index.theme file. Without it, gtk_icon_theme_load_icon fails with the
+GTK_ICON_THEME_ERROR_FAILED error.
 
-The only graphics that will be kept as XPMs will be the cursor
-icons. (REJON: I"m actually in favor of trying to convert these to SVGs
-as well.)  These files are located in src/pixmaps.
+Note that what dir the icon is in (actions, status, places) under the size
+directory doesn't matter at all when icons are looked up; the lookup function
+looks in all directories.
+
+== How to add an icon ==
+
+To add a new icon, you have to do the following:
+1. Draw the icon on a 48x48px canvas; for new icons, try to follow the Tango
+   guidelines [4].
+2. Name the icon according to the icon naming guidelines outlines in the
+   theme specification and using existing icons as a reference.
+2. Place it in the appropriate directory under scalable in both hicolor
+   and tango. Choose the best suitable context ("places" for dialogs,
+   "actions" for actions, and "status" for status indicators and toggles).
+3. Run the script render-icons.sh and then update-makefiles.sh in both
+   directories.
+
+References:
+[1] http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html
+[2] http://live.gnome.org/ThemableAppSpecificIcons
+[3] http://wiki.inkscape.org/wiki/index.php/Themable_icons
+[4] http://tango.freedesktop.org/Tango_Icon_Theme_Guidelines
+
+Jan 18, 2008
+ticotico.jpg is (C) 2008 Dario Sanches, licensed under Creative Commons by-sa 3.0
diff --git a/share/icons/README.icon_themes b/share/icons/README.icon_themes
deleted file mode 100644
index c18d4ba6b..000000000
--- a/share/icons/README.icon_themes
+++ /dev/null
@@ -1,29 +0,0 @@
-CHANGING ICON THEMES
---------------------
-The Inkscape icons are read from the file 'icons.svg' that resides in the same
-directory as this README.
-
-If you want to try a new theme, create a folder named 'icons' in your personal
-Inkscape folder (under Linux/Unix: $HOME/.inkscape), copy the file containing
-the alternative theme in that folder and rename it to icons.svg. The next time
-Inkscape is run the alternative icons will be loaded.
-
-
-CREATING A NEW ICON THEME
--------------------------
-To create a new theme or simply modify some icons you need to make sure each
-icon is assigned the correct ID (its name). Opening 'icons.svg' in Inkscape and
-selecting an icon will display its ID in the XML editor (Shift+Ctrl+X).
-
-The simplest way to proceed is to work on a copy of the icons.svg file and
-modify each icon one after the other, using the XML editor to adapt its ID.
-
-For example, if you've drawn a new pen icon, select it on the canvas, then open
-the XML editor. The node corresponding to the pen icon will be highlighted.
-Click on its ID in the upper right panel of the XML editor. The bottom right
-panel will display something like 'g2570'. Change that value to 'draw_pen' and
-click the 'Set' button.
-
-
-For any questions relating to icon themes, please contact:
-Jean-François Lemaire (jflemaire@skynet.be).
\ No newline at end of file
diff --git a/share/icons/README.legacy_icons b/share/icons/README.legacy_icons
deleted file mode 100644
index 9e67de9d7..000000000
--- a/share/icons/README.legacy_icons
+++ /dev/null
@@ -1,3 +0,0 @@
-This was Inkscape's original icon set from the initial release through the 0.43 release.

-To use it, copy the file "legacy_icons.svg" into Inkscape's icons folder which resides 

-in your personal folder and rename it to "icons.svg".
\ No newline at end of file