*** empty log message ***
[bpt/emacs.git] / man / ChangeLog
index ade4a6b..c70b92a 100644 (file)
@@ -1,3 +1,412 @@
+2007-11-02  Nick Roberts  <nickrob@snap.net.nz>
+
+       * building.texi (Watch Expressions): Remove obscure sentence.
+
+2007-10-27  Emanuele Giaquinta  <e.giaquinta@glauco.it>  (tiny change)
+
+       * gnus-faq.texi ([5.12]): Remove reference to discontinued service.
+
+2007-10-27  Reiner Steib  <Reiner.Steib@gmx.de>
+
+       * gnus.texi (Troubleshooting): Adjust Gnus version number.
+
+2007-10-30  Nick Roberts  <nickrob@snap.net.nz>
+
+       * building.texi (Watch Expressions): Describe gdb-delete-out-of-scope.
+
+2007-10-29  Richard Stallman  <rms@gnu.org>
+
+       * widget.texi (Introduction): Delete discussion of implementation
+       internals.
+
+2007-10-24  Richard Stallman  <rms@gnu.org>
+
+       * misc.texi (Interactive Shell): Cleanup last change.
+
+2007-10-18  Martin Rudalics  <rudalics@gmx.at>
+
+       * trouble.texi (Quitting): Fix typo.
+
+2007-10-17  Aaron S. Hawley  <aaronh@garden.org>
+
+       * building.texi (Source Buffers):
+       * custom.texi (Init Non-ASCII):
+       * glossary.texi (Glossary): Use "key binding" consistently.
+
+2007-10-17  Juanma Barranquero  <lekktu@gmail.com>
+
+       * calendar.texi (Diary): Fix directive.
+
+2007-10-16  Richard Stallman  <rms@gnu.org>
+
+       * calendar.texi (Diary): Clarify text about diary file example.
+
+2007-10-13  Glenn Morris  <rgm@gnu.org>
+
+       * misc.texi (Interactive Shell): Correct INSIDE_EMACS reference.
+
+2007-10-09  Richard Stallman  <rms@gnu.org>
+
+       * display.texi (Cursor Display): Correct how cursor appears
+       in nonselected windows.
+
+2007-10-04  Nick Roberts  <nickrob@snap.net.nz>
+
+       * building.texi (GDB Graphical Interface): Remove references to gdba
+       and mention gud-gdb.
+
+2007-09-29  Juri Linkov  <juri@jurta.org>
+
+       * info.texi (Help-Int): Document `L' (`Info-history').
+
+2007-09-20  Eduard Wiebe  <usenet@pusto.de>  (tiny change)
+
+       * flymake.texi (Customizable variables): Face names don't end in -face.
+       Fix flymake-err-line-patterns template.
+       (Example -- Configuring a tool called directly): Fix init-function.
+       (Highlighting erroneous lines): Face names don't end in -face.
+
+2007-09-05  Glenn Morris  <rgm@gnu.org>
+
+       * custom.texi (Safe File Variables): Clarify `!' and risky variables.
+
+2007-08-31  Eli Zaretskii  <eliz@gnu.org>
+
+       * rmail.texi (Rmail Sorting): Improve indexing.
+
+2007-08-24  IRIE Tetsuya  <irie@t.email.ne.jp>  (tiny change)
+
+       * message.texi (MIME): Replace mml-attach with mml-attach-file.
+
+2007-08-27  Richard Stallman  <rms@gnu.org>
+
+       * emacs.texi (Top): Clarify menu item for Glossary.
+
+       * display.texi (Faces): Change secn title.
+       Clarify not all fonts come from Font Lock.
+
+2007-08-14  Katsumi Yamaoka  <yamaoka@jpl.org>
+
+       * gnus.texi (Selecting a Group): Mention gnus-maximum-newsgroup.
+
+2007-08-17  Eli Zaretskii  <eliz@gnu.org>
+
+       * basic.texi (Position Info): Add index entry for face at point.
+       Mention that character faces are also displayed by "C-u C-x =".
+
+2007-08-10  Katsumi Yamaoka  <yamaoka@jpl.org>
+
+       * gnus.texi (NNTP): Mention nntp-xref-number-is-evil.
+
+2007-08-08  Glenn Morris  <rgm@gnu.org>
+
+       * glossary.texi (Glossary): Deprecate `iff'.
+       * gnus.texi, sieve.texi: Replace `iff'.
+
+2007-08-07  Chong Yidong  <cyd@stupidchicken.com>
+
+       * files.texi (File Conveniences): Document point motion keys in Image
+       mode.
+
+2007-08-01  Alan Mackenzie  <acm@muc.de>
+
+       * cc-mode.texi (Mailing Lists and Bug Reports): Correct "-no-site-file"
+       to "--no-site-file".
+
+2007-07-30  Dan Nicolaescu  <dann@ics.uci.edu>
+
+       * vc2-xtra.texi (Customizing VC): Add GIT and HG.
+
+2007-07-28  Nick Roberts  <nickrob@snap.net.nz>
+
+       * building.texi (GDB Graphical Interface): Qualify use of "M-x gdba".
+
+2007-07-27  Glenn Morris  <rgm@gnu.org>
+
+       * calc.texi (Copying)
+       * emacs.texi (Copying): Include license text from gpl.texi, rather than
+       in-line.
+
+       * gpl.texi: New file with text of GPL.
+       * Makefile.in (EMACSSOURCES): Add gpl.texi.
+
+2007-07-25  Glenn Morris  <rgm@gnu.org>
+
+       * calc.texi (Copying)
+       * emacs.texi (Copying): Replace license with GPLv3.
+
+       * Relicense all FSF files to GPLv3 or later.
+
+2007-07-24  Glenn Morris  <rgm@gnu.org>
+
+       * calendar.texi (Writing Calendar Files): cal-tex-diary etc only work
+       for some calendars.
+
+2007-07-13  Eli Zaretskii  <eliz@gnu.org>
+
+       * Makefile.in (../info/emacs-mime): Use --enable-encoding.
+
+       * makefile.w32-in ($(infodir)/emacs-mime): Ditto.
+
+       * emacs-mime.texi: Add @documentencoding directive.
+
+2007-07-02  Reiner Steib  <Reiner.Steib@gmx.de>
+
+       * gnus-faq.texi ([3.2]): Fix locating of environment variables in the
+       Control Panel.
+
+       * gnus.texi (Misc Article): Add index entry for
+       gnus-single-article-buffer.
+
+2007-06-27  Andreas Seltenreich  <andreas@gate450.dyndns.org>
+
+       * gnus.texi (Starting Up): Fix typo.
+
+2007-06-25  Katsumi Yamaoka  <yamaoka@jpl.org>
+
+       * gnus.texi (Asynchronous Fetching): Fix typo.
+
+2007-06-24  Karl Berry  <karl@tug.org>
+
+       * emacs.texi: new Back-Cover Text.
+
+2007-06-07  Michael Albinus  <michael.albinus@gmx.de>
+
+       Sync with Tramp 2.0.56.
+
+       * tramp.texi (Frequently Asked Questions): Improve ~/.zshrc
+       settings.  Reported by Ted Zlatanov <tzz@lifelogs.com>.
+
+2007-06-07  Alan Mackenzie  <acm@muc.de>
+
+       * display.texi (Optional Mode Line): Document the new form of
+       line+column numbers, "(561,2)".
+
+2007-06-06  Juanma Barranquero  <lekktu@gmail.com>
+
+       * cc-mode.texi (Comment Commands, Getting Started, Style Variables):
+       * gnus.texi (Article Buttons, Mail Source Customization)
+       (Sending or Not Sending, Customizing NNDiary):
+       * maintaining.texi (Create Tags Table):
+       * message.texi (Message Headers):
+       * mh-e.texi (HTML): Fix typos.
+
+2007-06-02  Chong Yidong  <cyd@stupidchicken.com>
+
+       * Version 22.1 released.
+
+2007-05-26  Michael Olson  <mwolson@gnu.org>
+
+       * erc.texi (Modules): Fix references to completion modules.
+
+2007-05-10  Reiner Steib  <Reiner.Steib@gmx.de>
+
+       * gnus.texi (Running NNDiary): Use ~/.gnus.el instead of gnusrc.
+
+2007-05-10  Didier Verna  <didier@xemacs.org>
+
+       * gnus.texi (Email Based Diary): New.  Proper documentation for the
+       nndiary back end and the gnus-diary library.
+
+2007-05-05  Francesco Potort\e,Al\e(B  <pot@gnu.org>
+
+       * maintaining.texi (Create Tags Table): Add text about the dangers of
+       making symbolic links to tags files.  (Clarified by RMS.)
+
+2007-05-04  Karl Berry  <karl@tug.org>
+
+       * emacs.texi (EMACSVER) [smallbook]: 22.1 for printed version, not 22.
+
+2007-05-03  Karl Berry  <karl@tug.org>
+
+       * emacs.texi (EMACSVER) [smallbook]: 22 for printed version.
+
+       * .cvsignore (*.pdf): New entry.
+
+       * texinfo.tex: Update from current version for better pdf generation.
+
+       * emacs.texi (\urlcolor, \linkcolor) [smallbook]: \let to \Black
+       for printing.
+
+2007-05-01  Richard Stallman  <rms@gnu.org>
+
+       * cmdargs.texi (Initial Options): Under --batch, mention --eval.
+
+2007-04-28  Glenn Morris  <rgm@gnu.org>
+
+       * ack.texi (Acknowledgments):
+       * anti.texi (Antinews):
+       * faq.texi (New in Emacs 22):
+       * programs.texi (Program Modes): Restore mention of python.el pending
+       consideration of legal status.
+
+2007-04-28  Richard Stallman  <rms@gnu.org>
+
+       * files.texi (File Names): Fixes to ~ description on MS systems.
+
+2007-04-28  Karl Berry  <karl@gnu.org>
+
+       * emacs.texi: Improve line breaks on copyright page,
+       similar layout to lispref, 8.5x11 by default.
+
+       * dired.texi (Image-Dired): Improve line break, fix typo.
+
+2007-04-27  J.D. Smith  <jdsmith@as.arizona.edu>
+
+       * idlwave.texi: Minor updates for IDLWAVE 6.1.
+
+2007-04-24  Chong Yidong  <cyd@stupidchicken.com>
+
+       * programs.texi (Program Modes):
+       * faq.texi (New in Emacs 22):
+       * anti.texi (Antinews):
+       * ack.texi (Acknowledgments): python.el removed.
+
+2007-04-23  Jay Belanger  <jay.p.belanger@gmail.com>
+
+       * calc.texi (Reporting bugs): Update maintainer's address.
+
+2007-04-23  Chong Yidong  <cyd@stupidchicken.com>
+
+       * display.texi (Highlight Interactively): Correct description of
+       hi-lock-file-patterns-policy.
+
+       * files.texi (File Archives): Mention self-extracting executables.
+
+2007-04-23  Eli Zaretskii  <eliz@gnu.org>
+
+       * search.texi (Unconditional Replace, Query Replace): Add xref to
+       "Replacement and Case".
+
+2007-04-22  Chong Yidong  <cyd@stupidchicken.com>
+
+       * dired.texi (Image-Dired): Move from Thumbnails node.
+       * misc.texi (Thumbnails): Node deleted.
+       * emacs.texi (Top): Update node listing.
+
+       * files.texi (File Conveniences):
+       * ack.texi (Acknowledgments):
+       * faq.texi (New in Emacs 22): Rename "tumme" to "image-dired".
+
+2007-04-21  Richard Stallman  <rms@gnu.org>
+
+       * display.texi (Highlight Interactively): Correct previous change.
+       Clarify doc of hi-lock-find-patterns, and move new features into it.
+
+2007-04-20  David Koppelman  <koppel@ece.lsu.edu>
+
+       * display.texi (Highlight Interactively): Document
+       hi-lock-file-patterns-policy.
+
+2007-04-20  Martin Rudalics  <rudalics@gmx.at>
+
+       * display.texi (Scrolling): Fix typo.
+
+2007-04-15  Jay Belanger  <belanger@truman.edu>
+
+       * calc.texi (Title page): Remove the date.
+       (Basic Arithmetic): Emphasize that / binds less strongly than *.
+       (The Standard Calc Interface): Change trail title.
+       (Floats): Mention that when non-decimal floats are entered, only
+       approximations are stored.
+       (Copying): Move to the appendices.
+       (GNU Free Documentation License): Add as an appendix.
+
+2007-04-15  Chong Yidong  <cyd@stupidchicken.com>
+
+       * ada-mode.texi, autotype.texi, cc-mode.texi, cl.texi:
+       * dired-x.texi, ebrowse.texi, ediff.texi:
+       * emacs-mime.texi, erc.texi, eshell.texi:
+       * eudc.texi, flymake.texi, forms.texi, gnus.texi:
+       * idlwave.texi, message.texi, newsticker.texi, org.texi:
+       * pcl-cvs.texi, pgg.texi, rcirc.texi, reftex.texi, sc.texi:
+       * ses.texi, sieve.texi, smtpmail.texi, speedbar.texi:
+       * tramp.texi, url.texi, vip.texi, viper.texi, widget.texi:
+       * woman.texi: Include GFDL.
+
+       * doclicense.texi: Remove node heading, so that it can be included by
+       other files.
+
+       * emacs.texi: Insert node heading for GFDL.
+
+       * dired-x.texi: Relicence under GFDL.  Remove date from title page.
+
+       * calc.texi (Algebraic Tutorial): Emphasize that / binds less strongly
+       than *.
+
+2007-04-14  Carsten Dominik  <dominik@science.uva.nl>
+
+       * org.texi (Formula syntax for Calc): Emphasize the operator precedence
+       in Calc.
+
+2007-04-14  Eli Zaretskii  <eliz@gnu.org>
+
+       * cmdargs.texi (Colors): Qualify "color of window" index entry by
+       "command line".
+
+       * display.texi (Faces): Refer to "Creating Frames" for face
+       and other frame customizations in .emacs.
+
+       * frames.texi (Creating Frames): Mention that face customizations can
+       be put in .emacs.  Add index entries.
+
+2007-04-12  Richard Stallman  <rms@gnu.org>
+
+       * glossary.texi (Glossary): Explain `iff'.
+
+2007-04-11  Karl Berry  <karl@gnu.org>
+
+       * gnu.texi (Top),
+       * macos.texi (Mac Font Specs),
+       * anti.texi (Antinews),
+       * xresources.texi (Resources),
+       * misc.texi (Emulation),
+       * calendar.texi (Daylight Saving),
+       * dired.texi (Dired and Find),
+       * rmail.texi (Remote Mailboxes),
+       * sending.texi (Mail Headers),
+       * programs.texi (Which Function),
+       * files.texi (Recover),
+       * buffers.texi (Uniquify),
+       * frames.texi (Wheeled Mice),
+       * killing.texi (Rectangles): Wording to improve breaks in
+       8.5x11 format.
+       * mule.texi (Language Environments): \hbadness=10000 since there's
+       no way to reword.
+       * emacs.texi (smallbook): New @set to more easily switch between
+       smallbook and 8.5x11.
+
+2007-04-11  Richard Stallman  <rms@gnu.org>
+
+       * files.texi (File Conveniences): Add xref to Tumme.
+       Delete text about Thumbnail mode.
+
+2007-04-09  Romain Francoise  <romain@orebokech.com>
+
+       * faq.texi (New in Emacs 22): Mention improvements to the Windows and
+       Mac OS ports.  Make it clear that mouse-1 complements and doesn't
+       replace mouse-2.
+
+2007-04-09  Alan Mackenzie  <acm@muc.de>
+
+       * cmdargs.texi (Initial Options): Call "inhibit-splash-screen" by its
+       new name.  Insert concept index entries.
+
+2007-04-08  Richard Stallman  <rms@gnu.org>
+
+       * url.texi: Fix some indexing.
+       (Disk Caching): Drop discussion of old/other Emacs versions.
+
+2007-04-08  Chong Yidong  <cyd@stupidchicken.com>
+
+       * display.texi (Standard Faces): Document prefix arg for
+       list-faces-display.
+
+       * rmail.texi (Rmail Scrolling): Document rmail-end-of-message.
+
+       * woman.texi (Word at point, Interface Options): woman-topic-at-point
+       renamed to woman-use-topic-at-point.  Document new behavior.
+
 2007-04-07  Chong Yidong  <cyd@stupidchicken.com>
 
        * url.texi (Disk Caching): Say Emacs 21 "and later".
        * emacs.texi (\hbadness): Set to 6000 so we aren't bothered by
        not-too-underfull hboxes in the TeX output.
        * abbrevs.texi, buffers.texi, building.texi, calendar.texi,
-       cmdargs.texi, custom.texi, dired.texi, macos.texi,
-       maintaining.texi, misc.texi, mule.texi, programs.texi, rmail.texi,
-       sending.texi, text.texi: fix overfull/underfull boxes.
+       cmdargs.texi, custom.texi, dired.texi, macos.texi,
+       maintaining.texi, misc.texi, mule.texi, programs.texi, rmail.texi,
+       * sending.texi, text.texi: Fix overfull/underfull boxes.
 
 2006-07-03  Romain Francoise  <romain@orebokech.com>
 
 
 2006-06-25  Nick Roberts  <nickrob@snap.net.nz>
 
-       * frames.texi (XTerm Mouse) Rename to...
+       * frames.texi (XTerm Mouse): Rename to...
        (Text-Only Mouse): ...this.  Mention t-mouse-mode.
 
        * emacs.texi (Top): Use new node name.
 2006-05-06  Eli Zaretskii  <eliz@gnu.org>
 
        * makefile.w32-in (emacs.dvi):
-       * Makefile.in (emacs.dvi): Add xresmini.texi
+       * Makefile.in (emacs.dvi): Add xresmini.texi.
 
        * xresmini.texi (Table of Resources): Remove xref to non-existent
        node "LessTif Resources".
        Next, and Up links.
 
        * emacs.texi (Top) [ifnottex]: Add menu entries for "Picture Mode"
-       and its sections.  @include picture-xtra.texi
+       and its sections.  @include picture-xtra.texi.
 
        * maintaining.texi (Maintaining) [ifnottex]: Add menu entry for
        "Emerge".
 
 2006-05-05  Karl Berry  <karl@gnu.org>
 
-       * texinfo.tex (\definetextfonsizexi, \definetextfonsizex): new cmds.
-       (\fonttextsize): new user-level command to change text font size.
-       * emacs.texi: call  @fonttextsize 10, inside @tex to avoid
+       * texinfo.tex (\definetextfonsizexi, \definetextfonsizex): New cmds.
+       (\fonttextsize): New user-level command to change text font size.
+       * emacs.texi: Call @fonttextsize 10, inside @tex to avoid
        errors from the current release of makeinfo (4.8).
-       * help.texi (Library Keywords): change widest word in multitable
+       * help.texi (Library Keywords): Change widest word in multitable
        template from `emulations' to `convenience'.  (Not sure if this is
        related to the font change.)
 
        (Inserting Version Control Headers, Customizing VC, General Options)
        (Options for RCS and SCCS, Options specific for CVS): Move all
        these nodes to emacs-xtra.texi, for brevity.
-       * cmdargs.texi, files.texi: change cross-references.
+       * cmdargs.texi, files.texi: Change cross-references.
 
 2006-04-11  Reiner Steib  <Reiner.Steib@gmx.de>
 
 
 2006-04-09  Karl Berry  <karl@gnu.org>
 
-       * msdog.texi, emacs-xtra.texi: move all the MS-DOS material to
+       * msdog.texi, emacs-xtra.texi: Move all the MS-DOS material to
        emacs-xtra.texi, leaving only MS Windows information.
        * building.texi, emacs.texi, frames.texi, gnu.texi, macos.texi,
-       msdog.texi, mule.texi, trouble.texi: change cross-references and
+       * msdog.texi, mule.texi, trouble.texi: Change cross-references and
        node names.
 
-       * emacs.texi: move @summarycontents and @contents to the beginning
+       * emacs.texi: Move @summarycontents and @contents to the beginning
        of the file.
 
 2006-04-07  Reiner Steib  <Reiner.Steib@gmx.de>
 
        * sending.texi (Mail Sending): pxref to Top needs five args.
 
-       * texinfo.tex: update to current version (2006-03-21.13).
+       * texinfo.tex: Update to current version (2006-03-21.13).
 
 2006-04-02  Bill Wohler  <wohler@newt.com>
 
        * mark.texi: Minor clarifications.
        (Selective Undo): Node deleted.
 
-       * m-x.texi: Minor clarifications
+       * m-x.texi: Minor clarifications.
 
        * killing.texi: Minor clarifications.
        Refer to "graphical" terminals, rather than window systems.
 
 2005-11-04  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version number changed to 3.19
+       * org.texi: Version number changed to 3.19.
 
 2005-11-04  Romain Francoise  <romain@orebokech.com>
 
 
 2005-10-10  Jan Dj\e,Ad\e(Brv  <jan.h.d@swipnet.se>
 
-       * cmdargs.texi (Icons X): -nb => -nbi
+       * cmdargs.texi (Icons X): -nb => -nbi.
 
 2005-10-10  Chong Yidong  <cyd@stupidchicken.com>
 
 
 2005-09-23  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi Version 3.16
+       * org.texi Version 3.16.
 
 2005-09-21  YAMAMOTO Mitsuharu  <mituharu@math.s.chiba-u.ac.jp>
 
 
 2005-07-19  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version 3.14
+       * org.texi: Version 3.14.
 
 2005-07-04  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version 3.13
+       * org.texi: Version 3.13.
 
 2005-07-19  Juri Linkov  <juri@jurta.org>
 
 
 2005-06-29  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version 3.12
+       * org.texi: Version 3.12.
 
 2005-06-24  Richard M. Stallman  <rms@gnu.org>
 
 
 2005-06-13  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version 3.11
+       * org.texi: Version 3.11.
 
 2005-06-12  Jay Belanger  <belanger@truman.edu>
 
 
 2005-05-20  Carsten Dominik  <dominik@science.uva.nl>
 
-       * org.texi: Version 3.09
+       * org.texi: Version 3.09.
 
 2005-05-18  Carsten Dominik  <dominik@science.uva.nl>
 
-       * reftex.texi: Version 4.28
+       * reftex.texi: Version 4.28.
 
 2005-05-18  Luc Teirlinck  <teirllm@auburn.edu>
 
 
 2005-04-25  Chong Yidong  <cyd@stupidchicken.com>
 
-       * ack.texi (Acknowledgments): Delete info about iso-acc.el
+       * ack.texi (Acknowledgments): Delete info about iso-acc.el.
 
        * dired.texi (Misc Dired Features): Document
        dired-compare-directories.
 
 2004-09-10  Eli Zaretskii  <eliz@gnu.org>
 
-       * Makefile.in (../info/gnus, gnus.dvi): Depend on gnus-faq.texi
+       * Makefile.in (../info/gnus, gnus.dvi): Depend on gnus-faq.texi.
 
 2004-09-09  Kim F. Storm  <storm@cua.dk>
 
 
 2003-02-17  Jan Dj\e,Ad\e(Brv  <jan.h.d@swipnet.se>
 
-       * xresources.texi (GTK names in Emacs): Add emacs-toolbar - GtkToolbar
+       * xresources.texi (GTK names in Emacs): Add emacs-toolbar - GtkToolbar.
 
 2003-02-05  Kai Gro\e,A_\e(Bjohann  <kai.grossjohann@uni-duisburg.de>
 
        Also use @ifnottex instead of @ifinfo around the top node, where
        needed for the sake of the HTML output.
        (The Gnus manual is not fixed since it's not clear to me how it
-        works; and the Tramp manual already uses @copying, although in an
-        unusual way.  All others were changed.)
+       works; and the Tramp manual already uses @copying, although in an
+       unusual way.  All others were changed.)
 
 2002-09-10  Jonathan Yavner  <jyavner@engineer.com>
 
 1999-10-12  Stefan Monnier  <monnier@cs.yale.edu>
 
        * Makefile.in (faq): Use ../info/emacs-faq.info (as specified in the
-         faq.texi file) rather than ../info/faq.
+       faq.texi file) rather than ../info/faq.
 
 1999-10-07  Gerd Moellmann  <gerd@gnu.org>
 
 
   GNU Emacs is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
-  the Free Software Foundation; either version 2, or (at your option)
+  the Free Software Foundation; either version 3, or (at your option)
   any later version.
 
   GNU Emacs is distributed in the hope that it will be useful,