unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Doc fixes.
@ 2005-06-04  2:08 Luc Teirlinck
  2005-06-04 17:59 ` Richard Stallman
  0 siblings, 1 reply; 2+ messages in thread
From: Luc Teirlinck @ 2005-06-04  2:08 UTC (permalink / raw)


What about the following patch which brings the lengths of three first
lines of docstrings below the maximum allowed 67 characters?  If it
exceeds that number, it not only looks bad in appropos, but when the
variable is defined with a defcustom, it looks terrible in Custom
buffers.  For the three variables in question, the docstrings start
looking really bad in the Lisp Custom group when one ckicks on "More"
to read the entire docstring.

I can install if desired.

===File ~/simple.el-diff====================================
*** simple.el	03 Jun 2005 18:43:57 -0500	1.724
--- simple.el	03 Jun 2005 20:46:58 -0500	
***************
*** 920,940 ****
  (defvar read-expression-history nil)
  
  (defcustom eval-expression-print-level 4
!   "*Value to use for `print-level' when printing value in `eval-expression'.
  A value of nil means no limit."
    :group 'lisp
    :type '(choice (const :tag "No Limit" nil) integer)
    :version "21.1")
  
  (defcustom eval-expression-print-length 12
!   "*Value to use for `print-length' when printing value in `eval-expression'.
  A value of nil means no limit."
    :group 'lisp
    :type '(choice (const :tag "No Limit" nil) integer)
    :version "21.1")
  
  (defcustom eval-expression-debug-on-error t
!   "*Non-nil means set `debug-on-error' when evaluating in `eval-expression'.
  If nil, don't change the value of `debug-on-error'."
    :group 'lisp
    :type 'boolean
--- 920,940 ----
  (defvar read-expression-history nil)
  
  (defcustom eval-expression-print-level 4
!   "Value of `print-level' while printing value in `eval-expression'.
  A value of nil means no limit."
    :group 'lisp
    :type '(choice (const :tag "No Limit" nil) integer)
    :version "21.1")
  
  (defcustom eval-expression-print-length 12
!   "Value of `print-length' while printing value in `eval-expression'.
  A value of nil means no limit."
    :group 'lisp
    :type '(choice (const :tag "No Limit" nil) integer)
    :version "21.1")
  
  (defcustom eval-expression-debug-on-error t
!   "If non-nil set `debug-on-error' to t in `eval-expression'.
  If nil, don't change the value of `debug-on-error'."
    :group 'lisp
    :type 'boolean
============================================================

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: Doc fixes.
  2005-06-04  2:08 Doc fixes Luc Teirlinck
@ 2005-06-04 17:59 ` Richard Stallman
  0 siblings, 0 replies; 2+ messages in thread
From: Richard Stallman @ 2005-06-04 17:59 UTC (permalink / raw)
  Cc: emacs-devel

These changes are good, but please write "Value for" instead of
"Value of".

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2005-06-04 17:59 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-06-04  2:08 Doc fixes Luc Teirlinck
2005-06-04 17:59 ` Richard Stallman

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).