finding the function mark-c-function
11 years, 12 months
Stephen J. Turnbull
Stephen J. Turnbull writes:
> > grep mark-c-function /usr/src/ -r
> > /usr/src/xemacs-21.5.32/man/xemacs/programs.texi:＠code{mark-c-function},
> > which is almost the same as ＠code{mark-defun},
> > /usr/src/xemacs-21.5.32/info/xemacs.info-2:`mark-c-function', which is
> > almost the same as `mark-defun', but which
>
> I guess these references can be removed. Patches welcome!
It turns out that in CC Mode's C mode, the function bound to C-M-h is
`c-mark-function', which knows about structs and macros, too. So I
fixed up the description of `mark-defun', using CC Mode as an example
of the kinds of additional processing (beyond marking a sexp starting
in column 1) modes might do for the "mark defun" functionality.
# HG changeset patch
# Parent 44b0b4ea5cae688779874a40c659eaef1940567c
Improve description of `mark-defun'.
diff -r 44b0b4ea5cae man/ChangeLog
--- a/man/ChangeLog Fri Dec 28 17:23:25 2012 +0900
+++ b/man/ChangeLog Fri Dec 28 23:11:32 2012 +0900
＠＠ -1,3 +1,8 ＠＠
+2012-12-28 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * xemacs/programs.texi (Defuns): Improve description of `mark-defun'.
+ Thanks to Steven Mitchell for the suggestion.
+
2012-12-28 Byrel Mitchell <byrel.mitchell(a)gmail.com>
* lispref/menus.texi (Menu Format):
diff -r 44b0b4ea5cae man/xemacs/programs.texi
--- a/man/xemacs/programs.texi Fri Dec 28 17:23:25 2012 +0900
+++ b/man/xemacs/programs.texi Fri Dec 28 23:11:32 2012 +0900
＠＠ -297,13 +297,18 ＠＠
The commands to move to the beginning and end of the current defun are
＠kbd{C-M-a} (＠code{beginning-of-defun}) and ＠kbd{C-M-e} (＠code{end-of-defun}).
- To operate on the current defun, use ＠kbd{C-M-h} (＠code{mark-defun})
+ To operate on the current defun, use ＠kbd{C-M-h} (＠code{mark-defun})
which puts point at the beginning and the mark at the end of the current
or next defun. This is the easiest way to prepare for moving the defun
-to a different place. In C mode, ＠kbd{C-M-h} runs the function
-＠code{mark-c-function}, which is almost the same as ＠code{mark-defun},
-but which backs up over the argument declarations, function name, and
-returned data type so that the entire C function is inside the region.
+to a different place. In Lisp modes, a ``defun'' is merely any sexp
+starting in column 1. In other modes, a defun is a syntactic unit
+defining an entity, and these modes often bind ＠kbd{C-M-h} to a
+different function. For example, in CC Mode's C mode, ＠kbd{C-M-h} runs
+the function ＠code{c-mark-function}, which is almost the same as
+＠code{mark-defun}, but which backs up over the argument declarations,
+function name, and returned data type so that the entire C function is
+inside the region. It also knows about struct definitions, macro
+definitions, and many other constructs.
＠findex compile-defun
To compile and evaluate the current defun, use ＠kbd{M-x compile-defun}.
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches
[AC21.5] Minor update to internals documentation
11 years, 12 months
Stephen J. Turnbull
APPROVE COMMIT 21.5
# HG changeset patch
# Parent 37b107e878b87b93d51d5a409a460b5a5df4c1a4
Update references to repository to reflect current reality.
diff -r 37b107e878b8 -r 9c9b07d40f20 man/ChangeLog
--- a/man/ChangeLog Fri Dec 28 12:35:44 2012 +0900
+++ b/man/ChangeLog Fri Dec 28 13:03:15 2012 +0900
＠＠ -1,3 +1,8 ＠＠
+2012-12-28 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * internals/internals.texi (Mercurial Basics):
+ Update references to repository to reflect current reality.
+
2012-12-28 Byrel Mitchell <byrel.mitchell(a)gmail.com>
* lispref/menus.texi (Creating Menu Accelerators): Typo fix.
diff -r 37b107e878b8 -r 9c9b07d40f20 man/internals/internals.texi
--- a/man/internals/internals.texi Fri Dec 28 12:35:44 2012 +0900
+++ b/man/internals/internals.texi Fri Dec 28 13:03:15 2012 +0900
＠＠ -6634,9 +6634,9 ＠＠
＠cindex Mercurial techniques
＠dfn{Mercurial} is the ＠emph{distributed version control system} used to
-manage the XEmacs core code. We plan to migrate the packages as well in
-the near future. The command used is ＠code{hg}; the entire system is
-implemented as subcommands of the ＠code{hg} command.
+manage XEmacs code, both core and packages. The VCS command is
+＠file{hg}; the entire system is implemented as subcommands of the
+＠file{hg} command.
＠menu
* Mercurial Basics::
＠＠ -6660,10 +6660,14 ＠＠
＠subheading Documentation
The primary online command for getting help on Mercurial is ＠code{hg
-help}.
+help}. ＠code{hg help commands} lists the main commands, while ＠code{hg
+help ＠var{cmd}} provides a man-page like description of command
+＠var{cmd}.
＠subheading What is the XEmacs repository URL?
+＠uref{http://hg.xemacs.org/} is one place to start. As of the date of
+writing, this points to our repositories on BitBucket.
For up-to-date information about this, other information about accessing
the repository ＠strong{including making your first clone of the
repository}, and availability of branches, please refer to our website,
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches
[AC21.5] New INSTALL file
11 years, 12 months
Stephen J. Turnbull
APPROVE COMMIT 21.5
Robert Royar writes:
> I have made some corrections (to minor word forms and version numbers)
> in the new INSTALL file. The patch is included for INSTALL and
> CHANGELOG.
Thank you, Robert! I didn't actually read much past the section
titles. ;-)
> I read one section where more detail would help, but I do
> not know the detail to add. In "Specifying Location of Headers and
> Libraries" the --with-site-runtime-libraries explanation states that
> multiple directories can be added to the search path; however, it does
> not specify the format of that list.
As you guessed, the same code is used for processing all these lists.
I added a paragraph to that effect.
> In the section "Advanced Make" the default for datadir is listed as
> /usr/local/data. This does not seem to be correct on all systems.
As Sean pointed out, this is a 21.5 improvement (ie, FHS compatibility).
> I changed references to version numbers at various places in the file
Good idea. I fixed the syntax of betas (21.5-b32) and added the
patchlevel for the stable line.
> Consider whether the section "Selecting configure Options" should
> include a forward reference to "Appendix: Correspondence to Old
> configure Options." The list of removed options and enable/with
> modifiers could be useful. I suggest moving the last paragraph of
> "Random Notes" into the "Selecting configure Options" section.
Postponed to issue849.
> I am not certain of the style for some nomenclature. I cannot tell
> whether the document should always to refer to the file `configure' in
> all lower case or to let that float.
I put section titles in upper case, text uses in lower case, and
references to section titles in title case.
# HG changeset patch
# Parent 6b027725e3401176451d62ba5e86de32bc38c6d6
More corrections to INSTALL by Robert Royer.
diff -r 6b027725e340 -r 37b107e878b8 ChangeLog
--- a/ChangeLog Fri Dec 28 02:29:16 2012 +0900
+++ b/ChangeLog Fri Dec 28 12:35:44 2012 +0900
＠＠ -1,3 +1,13 ＠＠
+2012-12-27 Robert D. Royar <xemacs(a)royar.org>
+
+ Minor additions by Stephen J. Turnbull <stephen(a)xemacs.org>.
+
+ * INSTALL: correct typographical errors; update
+ version numbers provided in Running Make section;
+ change default datadir reference to /usr/local/share
+ to match all other references to datadir's subdirectories;
+ change "can not" to "cannot".
+
2012-11-04 Stephen J. Turnbull <stephen(a)xemacs.org>
* INSTALL: Reorganize and update.
diff -r 6b027725e340 -r 37b107e878b8 INSTALL
--- a/INSTALL Fri Dec 28 02:29:16 2012 +0900
+++ b/INSTALL Fri Dec 28 12:35:44 2012 +0900
＠＠ -28,8 +28,8 ＠＠
Modern systems generally have more than enough RAM and virtual memory to run
XEmacs well. If you run into an "insufficient memory" error when building
-or on the first execution, see the 'PROBLEMS' file. In sufficient stack
-space is a separate problem, also address in 'PROBLEMS'.
+or on the first execution, see the 'PROBLEMS' file. Insufficient stack
+space is a separate problem, also addressed in 'PROBLEMS'.
Building XEmacs requires about 100 Mb of disk space (including the XEmacs
sources). Once installed, XEmacs occupies about 200 MB in the file system
＠＠ -136,7 +136,7 ＠＠
doesn't seem to have all the corresponding features, check with the newsgroup
'comp.emacs.xemacs' or the mailing list 'xemacs-beta(a)xemacs.org'.
-SELECTING configure OPTIONS
+SELECTING CONFIGURE OPTIONS
===========================
Options are generally of the form `--with-FEATURE' to use a feature or
＠＠ -402,7 +402,7 ＠＠
`/usr/local/share/xemacs-VERSION/lisp' holds the basic Emacs Lisp libraries
(including core implementations of many Lisp primitives);
`VERSION' stands for the number of the XEmacs version
- you are installing, like `19.14' or `21.5.31'. Since
+ you are installing, like `21.4.22' or `21.5-b32'. Since
the lisp libraries change from one version of XEmacs to
another, including the version number in the path
allows you to have several versions of XEmacs installed
＠＠ -500,7 +500,7 ＠＠
========
The most common problem is that you forgot to read and follow the directions
-for installing bootstrap packages in the FAQ. You can not have a normal
+for installing bootstrap packages in the FAQ. You cannot have a normal
XEmacs without downloading some additional packages.
See the file PROBLEMS in this directory for a list of various problems
＠＠ -760,17 +760,19 ＠＠
`datadir' indicates where to put the architecture-independent
read-only data files that XEmacs refers to while it runs; it
- defaults to /usr/local/data. We create the following
+ defaults to /usr/local/share. We create the following
subdirectories under `datadir':
+
- `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and
- `xemacs-VERSION/etc', containing the XEmacs tutorial and the
`yow' database.
+
`VERSION' is the number of the XEmacs version you are installing,
- like `18.59' or `19.14'. Since these files vary from one version
- of XEmacs to another, including the version number in the path
- allows you to have several versions of XEmacs installed at the
- same time; this means that you don't have to make XEmacs
+ like `21.4.22' or `21.5-b32'. Since these files vary from one
+ version of XEmacs to another, including the version number in the
+ path allows you to have several versions of XEmacs installed at
+ the same time; this means that you don't have to make XEmacs
unavailable while installing a new version.
`datarootdir' indicates where to put the documentation. (Usually,
＠＠ -884,7 +886,7 ＠＠
in the subdirectories.
Using GNU Make allows for simultaneous builds with and without the --srcdir
-option.
+option (see the section Running Configure).
MAIL LOCKING
============
＠＠ -1177,6 +1179,10 ＠＠
configuration changes. Not all systems need this option; it's best to avoid
using it if you can.
+To specify multiple directories in these commands, use a list delimited by
+spaces, colons, or commas. You will need to protect space-delimited lists
+from shell parsing by quoting them.
+
If you haven't built XEmacs 21.5 recently, the change from the configure
script based on Autoconf 2.13 can be a shock. Appendix: Correspondence to
Old Configure Options (at the end of this document) contains a list of old
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches
commit/XEmacs: stephen_at_xemacs: Doc typo fix.
11 years, 12 months
Bitbucket
1 new commit in XEmacs:
https://bitbucket.org/xemacs/xemacs/changeset/6b027725e340/
changeset: 6b027725e340
user: stephen_at_xemacs
date: 2012-12-27 18:29:16
summary: Doc typo fix.
affected #: 2 files
diff -r c65b0329894b09c08423739508d277548a0b1a00 -r 6b027725e3401176451d62ba5e86de32bc38c6d6 man/ChangeLog
--- a/man/ChangeLog
+++ b/man/ChangeLog
＠＠ -1,3 +1,7 ＠＠
+2012-12-28 Byrel Mitchell <byrel.mitchell(a)gmail.com>
+
+ * lispref/menus.texi (Creating Menu Accelerators): Typo fix.
+
2012-10-13 Mats Lidell <matsl(a)xemacs.org>
* lispref/processes.texi (Synchronous Processes): New function
diff -r c65b0329894b09c08423739508d277548a0b1a00 -r 6b027725e3401176451d62ba5e86de32bc38c6d6 man/lispref/menus.texi
--- a/man/lispref/menus.texi
+++ b/man/lispref/menus.texi
＠＠ -638,7 +638,7 ＠＠
will add a new menu to the top level menubar. The new menu can be reached
by pressing "t" while the top level menubar is active. When the menu is
active, pressing "1" will activate the first item and insert the character
-"1" into the buffer. Pressing "2" will activate the second item and insert
+"1" into the buffer. Pressing "T" will activate the second item and insert
the character "2" into the buffer. Pressing "3" will activate the third item
and insert the character "3" into the buffer.
Repository URL: https://bitbucket.org/xemacs/xemacs/
--
This is a commit notification from bitbucket.org. You are receiving
this because you have the service enabled, addressing the recipient of
this email.
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches
[AC21.5] Doc typo fix
11 years, 12 months
Stephen J. Turnbull
APPROVE COMMIT 21.5
>From Byrel Mitchell.
# HG changeset patch
# Parent c65b0329894b09c08423739508d277548a0b1a00
Doc typo fix.
diff -r c65b0329894b -r 6b027725e340 man/ChangeLog
--- a/man/ChangeLog Mon Dec 24 18:40:47 2012 +0900
+++ b/man/ChangeLog Fri Dec 28 02:29:16 2012 +0900
＠＠ -1,3 +1,7 ＠＠
+2012-12-28 Byrel Mitchell <byrel.mitchell(a)gmail.com>
+
+ * lispref/menus.texi (Creating Menu Accelerators): Typo fix.
+
2012-10-13 Mats Lidell <matsl(a)xemacs.org>
* lispref/processes.texi (Synchronous Processes): New function
diff -r c65b0329894b -r 6b027725e340 man/lispref/menus.texi
--- a/man/lispref/menus.texi Mon Dec 24 18:40:47 2012 +0900
+++ b/man/lispref/menus.texi Fri Dec 28 02:29:16 2012 +0900
＠＠ -638,7 +638,7 ＠＠
will add a new menu to the top level menubar. The new menu can be reached
by pressing "t" while the top level menubar is active. When the menu is
active, pressing "1" will activate the first item and insert the character
-"1" into the buffer. Pressing "2" will activate the second item and insert
+"1" into the buffer. Pressing "T" will activate the second item and insert
the character "2" into the buffer. Pressing "3" will activate the third item
and insert the character "3" into the buffer.
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches