[Emacs-diffs] trunk r116163: Doc updates for opascal.el

[Glenn Morris]

------------------------------------------------------------
revno: 116163
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2014-01-25 19:39:34 -0800
message:
  Doc updates for opascal.el
  
  * lisp/progmodes/opascal.el (opascal-tab-always-indents, opascal-tab):
  Doc fix.  Make obsolete.
  (opascal-mode): No longer mention opascal-tab-always-indents in doc.
  
  * doc/emacs/ack.texi (Acknowledgments):
  * doc/emacs/programs.texi (Program Modes):
  Update for delphi.el -> opascal.el renaming.
  
  * etc/NEWS: Edits.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/ack.texi             ack.texi-20091113204419-o5vbwnq5f7feedwu-6230
  doc/emacs/programs.texi        
programs.texi-20091113204419-o5vbwnq5f7feedwu-6272
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/progmodes/opascal.el      delphi.el-20091113204419-o5vbwnq5f7feedwu-1324

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-26 01:11:10 +0000
+++ b/doc/emacs/ChangeLog       2014-01-26 03:39:34 +0000
@@ -1,5 +1,9 @@
 2014-01-26  Glenn Morris  <address@hidden>
 
+       * ack.texi (Acknowledgments):
+       * programs.texi (Program Modes):
+       Update for delphi.el -> opascal.el renaming.
+
        * misc.texi (Sorting): Add findex for reverse-region.
 
        * killing.texi (Deletion): Mention delete-duplicate-lines.

=== modified file 'doc/emacs/ack.texi'
--- a/doc/emacs/ack.texi        2014-01-24 18:36:44 +0000
+++ b/doc/emacs/ack.texi        2014-01-26 03:39:34 +0000
@@ -126,8 +126,8 @@
 Anna M. Bigatti wrote @file{cal-html.el}, which produces HTML calendars.
 
 @item
-Ray Blaak and Simon South wrote @file{delphi.el}, a mode for editing
-Delphi (Object Pascal) source code.
+Ray Blaak and Simon South wrote @file{opascal.el}, a mode for editing
+Object Pascal source code.
 
 @item
 Martin Blais, Stefan Merten, and David Goodger wrote @file{rst.el}, a

=== modified file 'doc/emacs/programs.texi'
--- a/doc/emacs/programs.texi   2014-01-08 19:16:10 +0000
+++ b/doc/emacs/programs.texi   2014-01-26 03:39:34 +0000
@@ -75,17 +75,17 @@
 @cindex VHDL mode
 @cindex M4 mode
 @cindex Shell-script mode
address@hidden Delphi mode
address@hidden OPascal mode
 @cindex PostScript mode
 @cindex Conf mode
 @cindex DNS mode
 @cindex Javascript mode
   Emacs has programming language modes for Lisp, Scheme, the
-Scheme-based DSSSL expression language, Ada, ASM, AWK, C, C++, Delphi,
+Scheme-based DSSSL expression language, Ada, ASM, AWK, C, C++,
 Fortran, Icon, IDL (CORBA), IDLWAVE, Java, Javascript, Metafont
-(@TeX{}'s companion for font creation), Modula2, Objective-C, Octave,
-Pascal, Perl, Pike, PostScript, Prolog, Python, Ruby, Simula, Tcl, and
address@hidden  An alternative mode for Perl is called CPerl mode.  Modes are
+(@TeX{}'s companion for font creation), Modula2, Object Pascal, Objective-C,
+Octave, Pascal, Perl, Pike, PostScript, Prolog, Python, Ruby, Simula, Tcl,
+and address@hidden  An alternative mode for Perl is called CPerl mode.  Modes 
are
 also available for the scripting languages of the common GNU and Unix
 shells, VMS DCL, and MS-DOS/MS-Windows @samp{BAT} files, and for
 makefiles, DNS master files, and various sorts of configuration files.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-26 01:10:18 +0000
+++ b/etc/NEWS  2014-01-26 03:39:34 +0000
@@ -634,14 +634,19 @@
 
 *** Documentation lookup/search.
 
-** OPascal mode is the new name for Delphi mode.
++++
+** OPascal mode is the new name for Delphi mode
 
+---
 *** All delphi-* variables and functions have been renamed to opascal-*.
+Obsolete aliases exist for those likely to have been used externally.
 
-*** `delphi-newline-always-indents' is not supported any more.
+---
+*** The option `delphi-newline-always-indents' has been removed.
 Use `electric-indent-mode' instead.
 
-*** `delphi-tab' is gone, replaced by `indent-for-tab-command'.
+---
+*** The TAB key runs the standard `indent-for-tab-command', not `delphi-tab'.
 
 ** Package
 
@@ -690,18 +695,24 @@
 
 ** Ruby mode
 
+---
+*** Improved syntax highlighting and indentation.
+
+---
+*** New `electric-indent-mode' integration.
+
+---
 *** New option `ruby-encoding-magic-comment-style'.
 
+---
 *** New option `ruby-custom-encoding-magic-comment-template'.
 
-*** Improved syntax highlighting and indentation.
+---
+*** New option `ruby-align-to-stmt-keywords'.
 
+---
 *** More Ruby file types have been added to `auto-mode-alist'.
 
-*** New option `ruby-align-to-stmt-keywords'.
-
-*** New `electric-indent-mode' integration.
-
 ** Search and Replace
 
 +++
@@ -760,6 +771,7 @@
 Emacs can learn the appropriate indentation settings if you provide it
 with an indented sample file.
 
+---
 ** New Term mode option `term-suppress-hard-newline'.
 
 +++

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-01-26 01:10:18 +0000
+++ b/lisp/ChangeLog    2014-01-26 03:39:34 +0000
@@ -1,5 +1,9 @@
 2014-01-26  Glenn Morris  <address@hidden>
 
+       * progmodes/opascal.el (opascal-tab-always-indents, opascal-tab):
+       Doc fix.  Make obsolete.
+       (opascal-mode): No longer mention opascal-tab-always-indents in doc.
+
        * sort.el (delete-duplicate-lines): Doc fix.
 
 2014-01-25  Rüdiger Sonderfeld  <address@hidden>

=== modified file 'lisp/progmodes/opascal.el'
--- a/lisp/progmodes/opascal.el 2014-01-01 07:43:34 +0000
+++ b/lisp/progmodes/opascal.el 2014-01-26 03:39:34 +0000
@@ -106,10 +106,14 @@
 (define-obsolete-variable-alias
   'delphi-tab-always-indents 'opascal-tab-always-indents "24.4")
 (defcustom opascal-tab-always-indents tab-always-indent
-  "Non-nil means TAB in OPascal mode should always reindent the current line,
-regardless of where in the line point is when the TAB command is used."
+  "Non-nil means `opascal-tab' should always reindent the current line.
+That is, regardless of where in the line point is at the time."
   :type 'boolean)
 
+(make-obsolete-variable 'opascal-tab-always-indents
+                        "use `indent-for-tab-command' and `tab-always-indent'."
+                        "24.4")
+
 (defconst opascal-directives
   '(absolute abstract assembler automated cdecl default dispid dynamic
     export external far forward index inline message name near nodefault
@@ -1447,8 +1451,8 @@
 
 
 (defun opascal-tab ()
-  "Indent the region, when Transient Mark mode is enabled and the region is
-active.  Otherwise, indent the current line or insert a TAB, depending on the
+  "Indent the region, if Transient Mark mode is on and the region is active.
+Otherwise, indent the current line or insert a TAB, depending on the
 value of `opascal-tab-always-indents' and the current line position."
   (interactive)
   (cond ((use-region-p)
@@ -1465,6 +1469,7 @@
          ;; Otherwise, insert a tab character.
          (insert "\t"))))
 
+(make-obsolete 'opascal-tab 'indent-for-tab-command "24.4")
 
 (defun opascal-is-directory (path)
   ;; True if the specified path is an existing directory.
@@ -1754,9 +1759,6 @@
     Extra indentation for blocks in compound statements.
  `opascal-case-label-indent'           (default 0)
     Extra indentation for case statement labels.
- `opascal-tab-always-indents'          (default `tab-always-indents')
-    Non-nil means TAB in OPascal mode should always reindent the current line,
-    regardless of where in the line point is when the TAB command is used.
  `opascal-search-path'                 (default .)
     Directories to search when finding external units.
  `opascal-verbose'                     (default nil)