# HG changeset patch # User Glenn Morris # Date 1252651333 0 # Node ID 82d9b29c48c572bb8fbcb4e0ed3accd8cab83251 # Parent d2f068bb3cb16a771e1456dfd75d216ed6afc9ae Reformat doc-strings for make-docfile. diff -r d2f068bb3cb1 -r 82d9b29c48c5 lisp/ChangeLog --- a/lisp/ChangeLog Fri Sep 11 06:39:21 2009 +0000 +++ b/lisp/ChangeLog Fri Sep 11 06:42:13 2009 +0000 @@ -4,6 +4,10 @@ 2009-09-11 Glenn Morris + * paths.el (prune-directory-list, gnus-nntp-service, rmail-file-name): + * version.el (emacs-copyright, emacs-major-version) + (emacs-minor-version): Reformat doc-strings for make-docfile. + * apropos.el (apropos-documentation-check-doc-file): Exclude unbound functions and variables, since they must be stuff specific to some other platform. diff -r d2f068bb3cb1 -r 82d9b29c48c5 lisp/paths.el --- a/lisp/paths.el Fri Sep 11 06:39:21 2009 +0000 +++ b/lisp/paths.el Fri Sep 11 06:42:13 2009 +0000 @@ -32,11 +32,12 @@ ;;; Code: ;; Docstrings in this file should, where reasonable, follow the -;; conventions described in bindings.el, so that they get put in the +;; conventions described in make-docfile, so that they get put in the ;; DOC file rather than in memory. (defun prune-directory-list (dirs &optional keep reject) - "Return a copy of DIRS with all non-existent directories removed. + "\ +Return a copy of DIRS with all non-existent directories removed. The optional argument KEEP is a list of directories to retain even if they don't exist, and REJECT is a list of directories to remove from DIRS, even if they exist; REJECT takes precedence over KEEP. @@ -121,8 +122,8 @@ The name of the host running an NNTP server. The null string means use the local host as the server site.") -(defvar gnus-nntp-service "nntp" - "NNTP service name, usually \"nntp\" or 119. +(defvar gnus-nntp-service "nntp" "\ +NNTP service name, usually \"nntp\" or 119. Go to a local news spool if its value is nil, in which case `gnus-nntp-server' should be set to `(system-name)'.") @@ -130,8 +131,8 @@ *The name of your organization, as a string. The `ORGANIZATION' environment variable is used instead if defined.") -(defcustom rmail-file-name "~/RMAIL" - "Name of user's primary mail file." +(defcustom rmail-file-name "~/RMAIL" "\ +Name of user's primary mail file." :type 'string :group 'rmail :version "21.1") diff -r d2f068bb3cb1 -r 82d9b29c48c5 lisp/version.el --- a/lisp/version.el Fri Sep 11 06:39:21 2009 +0000 +++ b/lisp/version.el Fri Sep 11 06:42:13 2009 +0000 @@ -1,7 +1,7 @@ ;;; version.el --- record version number of Emacs -*- no-byte-compile: t -*- -;; Copyright (C) 1985, 1992, 1994, 1995, 1999, 2000, 2001, 2002, -;; 2003, 2004, 2005, 2006, 2007, 2008, 2009 +;; Copyright (C) 1985, 1992, 1994, 1995, 1999, 2000, 2001, 2002, 2003, +;; 2004, 2005, 2006, 2007, 2008, 2009 ;; Free Software Foundation, Inc. ;; Maintainer: FSF @@ -24,24 +24,23 @@ ;;; Commentary: +;; This file is loaded uncompiled when dumping Emacs. +;; Doc-strings should adhere to the conventions of make-docfile. + ;;; Code: -(defconst emacs-copyright "Copyright (C) 2009 Free Software Foundation, Inc." - "Short copyright string for this version of Emacs.") +(defconst emacs-copyright "Copyright (C) 2009 Free Software Foundation, Inc." "\ +Short copyright string for this version of Emacs.") (defconst emacs-version "23.1.50" "\ Version numbers of this version of Emacs.") -(defconst emacs-major-version - (progn (string-match "^[0-9]+" emacs-version) - (string-to-number (match-string 0 emacs-version))) - "Major version number of this version of Emacs. +(defconst emacs-major-version (progn (string-match "^[0-9]+" emacs-version) (string-to-number (match-string 0 emacs-version))) "\ +Major version number of this version of Emacs. This variable first existed in version 19.23.") -(defconst emacs-minor-version - (progn (string-match "^[0-9]+\\.\\([0-9]+\\)" emacs-version) - (string-to-number (match-string 1 emacs-version))) - "Minor version number of this version of Emacs. +(defconst emacs-minor-version (progn (string-match "^[0-9]+\\.\\([0-9]+\\)" emacs-version) (string-to-number (match-string 1 emacs-version))) "\ +Minor version number of this version of Emacs. This variable first existed in version 19.23.") (defconst emacs-build-time (current-time) "\