annotate etc/images/README @ 94926:70a8f8c84456

Include <strings.h>. (enable_font_backend): Delete it. (Qfont_spec, Qfont_entity, Qfont_object): New variables. (CHECK_VALIDATE_FONT_SPEC): Delete it. (PT_PER_INCH, POINT_TO_PIXEL, PIXEL_TO_POINT): Moved to font.h. (null_string): Delete it. (null_vector): Make it static. (font_family_alist): Delete it. (Qnormal): Extern it. (QCextra, QClanguage): Delete it. (QClang, QCavgwidth, QCfont_entity, QCfc_unknown_spec): New variables. (font_make_spec, font_make_entity, font_make_object) (font_intern_prop): Renamed from intern_downcase. Don't downcase the string. Callers changed. (font_pixel_size): Adjusted for the format change of font-related objects. (prop_name_to_numeric, prop_numeric_to_name): Delete them. (font_style_to_value, font_style_symbolic): New function. (build_font_family_alist): Delete it. (font_registry_charsets): Use Fassoc_string instead of assq_no_quit. (font_prop_validate_symbol): Don't return null_string. (font_prop_validate_style): Adjusted for the change of style-related values in a font vector. (font_property_table): Delete entries for QClangauge and QCantialias, add entries for QCavgwidth. (get_font_prop_index): Delete the 2nd argument FROM. (font_prop_validate): Arguments changed. (font_put_extra): Adjusted for the change of font-related objects. (font_expand_wildcards, font_parse_xlfd, font_unparse_xlfd) (font_parse_fcname, font_unparse_fcname) (font_prepare_composition): Likewise. (font_parse_family_registry): Renamed from font_merge_old_spec. (otf_open): Delete the 1st arg entity. (font_otf_capability): Adjusted for the above change. (font_score): New arg alternate_families. Adjusted for the change of font-related objects. (font_sort_entites): New arg best_only. (font_symbolic_weight, font_symbolic_slant, font_symbolic_width): Delete them. (font_match_p): Check alternate families. (font_find_object): Delete it. (font_check_object): New function. (font_clear_cache): Adjusted for the change of font-related objects. (font_delete_unmatched): New arg. (font_list_entities): Call font_driver->list with a spec that doesn't specify style-related properties. (font_matching_entity): Arguments changed. Caller changed. (font_open_entity): Adjusted for the change of font-related objects. (font_close_object, font_has_char, font_encode_char) (font_get_name, font_get_spec): Likewise. (font_spec_from_name, font_clear_prop, font_update_lface): New functions. (font_find_for_lface, font_open_for_lface, font_load_for_lface): (font_prepare_for_face, font_done_for_face, font_open_by_name) (font_at): Adjusted for the change of font-related objects. (font_range): New function. (Ffontp, Ffont_spec, Ffont_get, Ffont_put, Flist_fonts) (Ffont_xlfd_name): Adjusted for the change of font-related objects. (Fcopy_font_spec, Fmerge_font_spec): New function. (Ffont_family_list): Renamed from list-families. (Finternal_set_font_style_table): Arguments changed. (Ffont_fill_gstring, Ffont_shape_text, Fopen_font) (Ffont_drive_otf, Fquery_font, Ffont_match_p): Adjusted for the change of font-related objects. (syms_of_font): Delete "ifdef USE_FONT_BACKEND". DEFSYM new symboles.

* 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 [e-mail] 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, 2008
  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 <[e-mail]>
  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. They are not part of Emacs, but
are distributed and used by Emacs.  They are licensed under the
GNU Library General Public License version 2 or later.  See the source
of the gtk+ package for more information.

  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.


* The following icons are from GNOME 2.x. They are not part of Emacs,
but are distributed and used by Emacs.  They are licensed under the
GNU General Public License version 2 or later.  See the source of
the gnome-icons-theme package for more information.

Emacs images and their source in the GNOME icons stock/ directory:

  attach.xpm                document/stock_attach
  bookmark_add.xpm          actions/bookmark_add
  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.