[Emacs-diffs] emacs/lisp ChangeLog progmodes/ruby-mode.el

[Juanma Barranquero]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Juanma Barranquero <lektu>      08/12/11 11:03:45

Modified files:
        lisp           : ChangeLog 
        lisp/progmodes : ruby-mode.el 

Log message:
        * progmodes/ruby-mode.el (ruby-mode-abbrev-table, ruby-mode-map)
          (ruby-mode-syntax-table, ruby-indent-tabs-mode, ruby-indent-level)
          (ruby-mode-variables, ruby-indent-line, ruby-indent-size)
          (ruby-calculate-indent, ruby-electric-brace, ruby-beginning-of-defun)
          (ruby-here-doc-beg-syntax, ruby-here-doc-end-syntax)
          (ruby-font-lock-syntax-table, ruby-font-lock-keywords)
          (ruby-end-of-defun, ruby-move-to-block, ruby-forward-sexp)
          (ruby-backward-sexp, ruby-add-log-current-method)
          (ruby-font-lock-syntactic-keywords, ruby-comment-beg-syntax)
          (ruby-in-here-doc-p, ruby-mode): Fix typos in docstrings.
          (ruby-deep-indent-paren): Doc fix.
          (ruby-insert-encoding-magic-comment): Remove * from docstring.
          (ruby-here-doc-find-end): Reflow docstring.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/ChangeLog?cvsroot=emacs&r1=1.14935&r2=1.14936
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/progmodes/ruby-mode.el?cvsroot=emacs&r1=1.2&r2=1.3

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/lisp/ChangeLog,v
retrieving revision 1.14935
retrieving revision 1.14936
diff -u -b -r1.14935 -r1.14936
--- ChangeLog   11 Dec 2008 09:53:54 -0000      1.14935
+++ ChangeLog   11 Dec 2008 11:03:42 -0000      1.14936
@@ -1,3 +1,19 @@
+2008-12-11  Juanma Barranquero  <address@hidden>
+
+       * progmodes/ruby-mode.el (ruby-mode-abbrev-table, ruby-mode-map)
+       (ruby-mode-syntax-table, ruby-indent-tabs-mode, ruby-indent-level)
+       (ruby-mode-variables, ruby-indent-line, ruby-indent-size)
+       (ruby-calculate-indent, ruby-electric-brace, ruby-beginning-of-defun)
+       (ruby-here-doc-beg-syntax, ruby-here-doc-end-syntax)
+       (ruby-font-lock-syntax-table, ruby-font-lock-keywords)
+       (ruby-end-of-defun, ruby-move-to-block, ruby-forward-sexp)
+       (ruby-backward-sexp, ruby-add-log-current-method)
+       (ruby-font-lock-syntactic-keywords, ruby-comment-beg-syntax)
+       (ruby-in-here-doc-p, ruby-mode): Fix typos in docstrings.
+       (ruby-deep-indent-paren): Doc fix.
+       (ruby-insert-encoding-magic-comment): Remove * from docstring.
+       (ruby-here-doc-find-end): Reflow docstring.
+
 2008-12-11  Stephen Berman <address@hidden>
 
        * dired.el (dired-pop-to-buffer): Use fit-window-to-buffer when

Index: progmodes/ruby-mode.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/ruby-mode.el,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- progmodes/ruby-mode.el      11 Dec 2008 02:01:55 -0000      1.2
+++ progmodes/ruby-mode.el      11 Dec 2008 11:03:44 -0000      1.3
@@ -149,7 +149,7 @@
   "Regexp to match symbols.")
 
 (defvar ruby-mode-abbrev-table nil
-  "Abbrev table in use in ruby-mode buffers.")
+  "Abbrev table in use in Ruby mode buffers.")
 
 (define-abbrev-table 'ruby-mode-abbrev-table ())
 
@@ -170,7 +170,7 @@
     (define-key map (kbd "C-j")   'reindent-then-newline-and-indent)
     (define-key map (kbd "C-m")   'newline)
     map)
-  "Keymap used in ruby-mode.")
+  "Keymap used in Ruby mode.")
 
 (defvar ruby-mode-syntax-table
   (let ((table (make-syntax-table)))
@@ -201,14 +201,14 @@
     (modify-syntax-entry ?\[ "(]" table)
     (modify-syntax-entry ?\] ")[" table)
     table)
-  "Syntax table to use in ruby-mode.")
+  "Syntax table to use in Ruby mode.")
 
 (defcustom ruby-indent-tabs-mode nil
-  "Indentation can insert tabs in ruby mode if this is non-nil."
+  "Indentation can insert tabs in Ruby mode if this is non-nil."
   :type 'boolean :group 'ruby)
 
 (defcustom ruby-indent-level 2
-  "Indentation of ruby statements."
+  "Indentation of Ruby statements."
   :type 'integer :group 'ruby)
 
 (defcustom ruby-comment-column 32
@@ -221,7 +221,8 @@
   :group 'ruby)
 
 (defcustom ruby-deep-indent-paren '(?\( ?\[ ?\] t)
-  "Deep indent lists in parenthesis when non-nil. t means continuous line.
+  "Deep indent lists in parenthesis when non-nil.
+The value t means continuous line.
 Also ignores spaces after parenthesis when 'space."
   :group 'ruby)
 
@@ -234,7 +235,7 @@
   :group 'ruby)
 
 (defcustom ruby-insert-encoding-magic-comment t
-  "*Insert a magic emacs 'coding' comment upon save if this is non-nil."
+  "Insert a magic Emacs 'coding' comment upon save if this is non-nil."
   :type 'boolean :group 'ruby)
 
 (defcustom ruby-use-encoding-map t
@@ -297,7 +298,7 @@
                 (>= (nth 2 state) 0) (< (point) end)))))
 
 (defun ruby-mode-variables ()
-  "Set up initial buffer-local variables for ruby-mode."
+  "Set up initial buffer-local variables for Ruby mode."
   (set-syntax-table ruby-mode-syntax-table)
   (setq local-abbrev-table ruby-mode-abbrev-table)
   (setq indent-tabs-mode ruby-indent-tabs-mode)
@@ -357,7 +358,7 @@
     (current-column)))
 
 (defun ruby-indent-line (&optional flag)
-  "Correct the indentation of the current ruby line."
+  "Correct the indentation of the current Ruby line."
   (interactive)
   (ruby-indent-to (ruby-calculate-indent)))
 
@@ -684,11 +685,11 @@
           )))
 
 (defun ruby-indent-size (pos nest)
-  "Returns the indentation level in spaces NEST levels deeper than POS."
+  "Return the indentation level in spaces NEST levels deeper than POS."
   (+ pos (* (or nest 1) ruby-indent-level)))
 
 (defun ruby-calculate-indent (&optional parse-start)
-  "Returns the proper indentation level of the current line."
+  "Return the proper indentation level of the current line."
   ;; TODO: Document body
   (save-excursion
     (beginning-of-line)
@@ -851,7 +852,7 @@
         indent))))
 
 (defun ruby-electric-brace (arg)
-  "Inserts a brace and re-indents the current line."
+  "Insert a brace and re-indent the current line."
   (interactive "P")
   (self-insert-command (prefix-numeric-value arg))
   (ruby-indent-line t))
@@ -886,7 +887,7 @@
        (beginning-of-line)))
 
 (defun ruby-move-to-block (n)
-  "Moves to the beginning (N < 0) or the end (N > 0) of the current block
+  "Move to the beginning (N < 0) or the end (N > 0) of the current block
 or blocks containing the current block."
   ;; TODO: Make this work for n > 1,
   ;; make it not loop for n = 0,
@@ -1055,7 +1056,7 @@
       (set-marker here nil))))
 
 (defun ruby-add-log-current-method ()
-  "Returns the current method name as a string.
+  "Return the current method name as a string.
 This string includes all namespaces.
 
 For example:
@@ -1165,10 +1166,10 @@
      ,(+ 1 (regexp-opt-depth ruby-here-doc-beg-re))
      (ruby-here-doc-beg-syntax))
     (,ruby-here-doc-end-re 3 (ruby-here-doc-end-syntax)))
-  "Syntactic keywords for ruby-mode. See `font-lock-syntactic-keywords'.")
+  "Syntactic keywords for Ruby mode. See `font-lock-syntactic-keywords'.")
 
 (defun ruby-comment-beg-syntax ()
-  "Returns the syntax cell for a the first character of a =begin.
+  "Return the syntax cell for a the first character of a =begin.
 See the definition of `ruby-font-lock-syntactic-keywords'.
 
 This returns a comment-delimiter cell as long as the =begin
@@ -1205,7 +1206,7 @@
         t)))
 
 (defun ruby-in-here-doc-p ()
-  "Returns whether or not the point is in a heredoc."
+  "Return whether or not the point is in a heredoc."
   (save-excursion
     (let ((old-point (point)) (case-fold-search nil))
       (beginning-of-line)
@@ -1216,9 +1217,9 @@
               (throw 'found-beg t)))))))
 
 (defun ruby-here-doc-find-end (&optional limit)
-  "Expects the point to be on a line with one or more heredoc
-openers. Returns the buffer position at which all heredocs on the
-line are terminated, or nil if they aren't terminated before the
+  "Expects the point to be on a line with one or more heredoc openers.
+Returns the buffer position at which all heredocs on the line
+are terminated, or nil if they aren't terminated before the
 buffer position `limit' or the end of the buffer."
   (save-excursion
     (beginning-of-line)
@@ -1244,7 +1245,7 @@
         (point)))))
 
 (defun ruby-here-doc-beg-syntax ()
-  "Returns the syntax cell for a line that may begin a heredoc.
+  "Return the syntax cell for a line that may begin a heredoc.
 See the definition of `ruby-font-lock-syntactic-keywords'.
 
 This sets the syntax cell for the newline ending the line
@@ -1257,7 +1258,7 @@
       (string-to-syntax "|"))))
 
 (defun ruby-here-doc-end-syntax ()
-  "Returns the syntax cell for a line that may end a heredoc.
+  "Return the syntax cell for a line that may end a heredoc.
 See the definition of `ruby-font-lock-syntactic-keywords'."
   (let ((pss (syntax-ppss)) (case-fold-search nil))
     ;; If we aren't in a string, we definitely aren't ending a heredoc,
@@ -1287,7 +1288,7 @@
   (let ((tbl (copy-syntax-table ruby-mode-syntax-table)))
     (modify-syntax-entry ?_ "w" tbl)
     tbl)
-  "The syntax table to use for fontifying ruby-mode buffers.
+  "The syntax table to use for fontifying Ruby mode buffers.
 See `font-lock-syntax-table'.")
 
 (defconst ruby-font-lock-keywords
@@ -1369,7 +1370,7 @@
                                         
;'("\\<[a-z]+[a-z0-9]*[A-Z][A-Za-z0-9]*\\([!?]?\\|\\>\\)"
                                         ;  0 font-lock-warning-face)
    )
-  "Additional expressions to highlight in ruby mode.")
+  "Additional expressions to highlight in Ruby mode.")
 
 ;;;###autoload
 (defun ruby-mode ()
@@ -1378,7 +1379,8 @@
 class, module, def, if, while, for, do, and case statements, taking
 nesting into account.
 
-The variable ruby-indent-level controls the amount of indentation.
+The variable `ruby-indent-level' controls the amount of indentation.
+
 \\{ruby-mode-map}"
   (interactive)
   (kill-all-local-variables)