annotate etc/images/README @ 111789:f97704487fb3

Merge changes made in Gnus trunk. nnir.el: Batch header retrieval. proto-stream.el: New library to provide protocol-specific TLS/STARTTLS connections for IMAP, NNTP, SMTP, POP3 and similar protocols. nnimap.el (nnimap-open-connection): Use it. proto-stream.el (open-proto-stream): Complete the documentation. nnimap.el (nnimap-open-connection): Check for "OK" from the greeting. nntp.el: Use proto-streams for the relevant connections types. nntp.el (nntp-open-connection): Switch on STARTTLS on supported servers. proto-stream.el (open-proto-stream): Add a way to specify what the end of a command is. proto-stream.el (proto-stream-open-tls): Delete output from openssl if we're using tls.el. proto-stream.el (proto-stream-open-network): If we don't have gnutls-cli or gnutls built in, then don't try to establish a STARTTLS connection. color.el (color-lab->srgb): Fix function call name. proto-stream.el: Fix the syntax in the comment. nntp.el (nntp-open-connection): Fix the STARTTLS command syntax. proto-stream.el (proto-stream-open-starttls): Actually implement the starttls.el STARTTLS. proto-stream.el (proto-stream-always-use-starttls): New variable. proto-stream.el (proto-stream-open-starttls): De-duplicate the starttls code. proto-stream.el (proto-stream-open-starttls): Folded back into the main function. proto-stream.el (proto-stream-command): Refactor out. nnimap.el (nnimap-stream): Change default to `undecided'. nnimap.el (nnimap-open-connection): If `nnimap-stream' is `undecided', try ssl first, and then network. nnimap.el (nnimap-open-connection-1): Respect nnimap-server-port. nnimap.el (nnimap-open-connection): Be more backwards-compatible. proto-stream.el (open-protocol-stream): Renamed from open-proto-stream. proto-stream.el (proto-stream-open-network): When doing opportunistic TLS upgrades we don't really care about the identity of the peer. gnus.texi (Customizing the IMAP Connection): Note the new defaults. gnus.texi (Direct Functions): Note the STARTTLS upgrade. proto-stream.el (proto-stream-open-network): Force starttls.el to use gnutls-cli, since that what we've checked for. proto-stream.el (proto-stream-always-use-starttls): Only default to t if open-gnutls-stream exists. proto-stream.el (proto-stream-open-network): If STARTTLS failed, then just open a normal connection. proto-stream.el (proto-stream-open-network): Wait until the greeting before doing STARTTLS. nnimap.el (nnimap-open-connection-1): Always upgrade to STARTTLS (for backwards compatibility). nnimap.el (nnimap-open-connection-1): Really respect nnimap-server-port. nntp.el (nntp-open-connection): Provide a :success condition. nnimap.el (nnimap-open-connection-1): Ditto. proto-stream.el (proto-stream-open-network): See what the response to the STARTTLS command is. proto-stream.el (proto-stream-open-network): Add some comments. proto-stream.el: Fix example. proto-stream.el (open-protocol-stream): Actually mention the STARTTLS upgrade. nnir.el (nnir-get-active): Skip nnir-ignored-newsgroups when searching. nnir.el (nnir-ignore-newsgroups): Fix default value. nnir.el (nnir-run-gmane): Use mm-delete-duplicates instead of delete-dups that is not available in XEmacs 21.4. mm-util.el (mm-delete-duplicates): Add comment. gnus-sum.el (gnus-summary-delete-article): If delete fails don't change the registry. nnimap.el (nnimap-open-connection-1): w32 open-network-stream doesn't seem to accept strings-with-numbers as port numbers. color.el: fix docstring to use English rather than math notation for intervals. shr.el (shr-find-fill-point): Don't break before apostrophes. nnir.el (nnir-request-move-article): Bail out if no move support in group. color.el (color-rgb->hsv): Fix docstring. nnir.el (nnir-get-active): Improve active list retrieval. shr.el (shr-find-fill-point): Work better for kinsoku chars and apostrophes. gnus-gravatar.el (gnus-gravatar-size): Set gnus-gravatar-size to nil. nnimap.el (nnimap-open-connection-1): Use gnus-string-match-p. nnimap.el (nnimap-open-connection-1): Fix PREAUTH. proto-stream.el (open-protocol-stream): All starttls connections are handled by the network handler. gnus-gravatar.el (gnus-gravatar-insert): Delete unnecessary binding to t of inhibit-read-only since it is inside gnus-with-article-headers. gnus-gravatar.el (gnus-gravatar-transform-address): Use mail-extract-address-components that supports non-ASCII names rather than mail-header-parse-addresses. shr.el (shr-find-fill-point): Don't break line between kinsoku-bol characters. gnus-gravatar.el (gnus-gravatar-insert): Allow LWSP in the middle of names. nnmaildir.el (nnmaildir-request-set-mark): Add article to add-mark funcall. gnus-msg.el: Remove nastygram thing. message.el (message-from-style): Fix comment. message.el (message-user-organization): Do not use gnus-local-organization. gnus.el: Remove gnus-local-organization. rtree.el: New file to handle range trees. nnir.el, gnus-sum.el: Redo the way nnir handles registry updates. rtree.el (rtree-extract): Simplify. gnus-win.el (gnus-configure-windows): Remove Gnus 3.x setting support. gnus-msg.el: Mark gnus-outgoing-message-group as obsolete. gnus.texi (Archived Messages): Remove gnus-outgoing-message-group. gnus-win.el (gnus-configure-frame): Remove old compatibility code. rtree.el (rtree-memq): Rewrite it as a non-recursive function. rtree.el (rtree-add, rtree-delq, rtree-length): Implement. rtree.el (rtree-add): Make code slightly faster. nnir.el: Allow modified summary-line-format in nnir summary buffers.

* 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 part of Emacs.  All are licensed under the
  GNU General Public License version 3 (see COPYING) or later.
  The xpm and svg files contain copyright and license information, but
  it is reproduced here for convenience.  

File: mh-logo.xpm
  Author: Satyaki Das
  Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
    Free Software Foundation, Inc.

Files: splash.pbm, splash.xpm, gnus.pbm
  Author: Luis Fernandes <[e-mail]>
  Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
    2010 Free Software Foundation, Inc.

Files: splash.png, splash.svg
  Author: Francesc Rocher <[e-mail]>
  Copyright (C) 2008, 2009, 2010 Free Software Foundation, Inc.

Files: checked.xpm, unchecked.xpm
  Author: Chong Yidong <[e-mail]>
  Copyright (C) 2010 Free Software Foundation, Inc.


* 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.